{"uid":"cap_Lnt6m9y2kVsUc2J5PpgK8","slug":"topic-scorer-taxonomy-rank-gate-c563cf7c","name":"Topic Scorer – Taxonomy Rank Gate","description":"Pass/fail check: does the text rank within the top `min_rank` categories of its target taxonomy? Returns `pass`, the target's rank and gap to #1, the taxonomy's top five, and the unused phrases to work in. Use it as a content-pipeline gate. Paid, $0.05/call; read-only and safe to retry.","url":"https://topic-scorer.pixelcove.co/v1/gate","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"full":{"type":"boolean","default":false,"description":"Score the whole text as the mean of 8,192-char chunks instead of only the first 8,192 chars."},"text":{"type":"string","maxLength":32768,"minLength":1,"description":"The page or draft text to score, as plain text or HTML (tags are stripped). 1 to 32768 characters. URLs are not fetched; send the content."},"phrases":{"type":"integer","default":30,"maximum":100,"minimum":0,"description":"Phrase bank size for the target category (0 skips it)."},"category":{"type":"string","maxLength":200,"minLength":1,"description":"Target category id, full path, or a unique path substring within the taxonomy (use topic_scorer_find to look one up)."},"min_rank":{"type":"integer","default":3,"maximum":50,"minimum":1,"description":"Highest passing rank."},"taxonomy":{"enum":["google_ads_topics","google_merchant","iab_content","iab_audience","iab_ad_product","linkedin_industries"],"type":"string","description":"Taxonomy of the target category."}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dp3py0its7po_hcQowHNj","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Checks whether a piece of text ranks within the top N categories of a given ad or content taxonomy, returning pass/fail, rank, gap to #1, top 5 categories, and unused phrases to improve topical coverage.","exampleAgentPrompt":"Check if this article draft passes a top-3 rank check for the IAB content category 'Technology & Computing > Artificial Intelligence' using the iab_content taxonomy, and tell me which phrases I'm missing — here's the text: [article text].","exampleUseCases":[{"title":"Content pipeline gate before publish","prompt":"Before I publish this blog post, check if it ranks in the top 3 of the IAB content taxonomy for the category 'Health & Fitness > Exercise' — use the full text scoring mode and give me the unused phrases I should work in."},{"title":"Ad copy taxonomy compliance check","prompt":"Does this Google Ads landing page copy qualify as top-5 in the 'google_ads_topics' taxonomy under 'Autos & Vehicles > Motor Vehicles > Cars & Trucks'? Here's the full text — tell me the rank, the gap to #1, and the top 5 categories it scores for."},{"title":"LinkedIn content industry alignment","prompt":"Score this LinkedIn article against the 'linkedin_industries' taxonomy for the 'Information Technology & Services' category — I want to know if it passes a top-2 rank threshold and what phrases I should add to improve it."}],"resultDescription":"Returns a pass/fail verdict indicating whether the text ranks within the specified top-N threshold for the target category, the target category's actual rank, its scoring gap to the #1 ranked category, the taxonomy's top 5 scoring categories for the text, and a bank of unused topically-relevant phrases that could be incorporated to improve ranking.","failureModes":["Category not found or ambiguous path substring — use topic_scorer_find to look up a valid category id","Text too short (under 1 character) or too long (over 32,768 characters)","Invalid taxonomy enum value supplied","min_rank out of bounds (must be 1–50)","Payment failure or insufficient funds — $0.05 USDC required per call","Service unavailable or timeout on large full-text scoring requests"],"whenToPreferThis":"Use this endpoint when you need a deterministic pass/fail gate on whether content is topically aligned with a specific category in a standardized ad or content taxonomy (IAB, Google Ads, Google Merchant, LinkedIn Industries). It is particularly valuable in automated content pipelines where you need a hard threshold check before publishing, submitting ads, or approving content. Prefer this over general-purpose LLM classification when you need reproducible, taxonomy-anchored results with improvement guidance (unused phrases) and ranking context (top 5, gap to #1).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T12:30:26.555Z","isFirstParty":false}