# topic-scorer: Taxonomy Phrase Recommender

> topic-scorer: Taxonomy Phrase Recommender is a paid API for AI agents from topic-scorer.pixelcove.co, paid per call via x402, $0.05/call, status unknown (last checked 2026-10-11).

Returns the ranked taxonomy category for a page or draft and lists the key phrases it still needs to rank higher in that category.

## Facts

- Endpoint: POST https://topic-scorer.pixelcove.co/v1/phrases?utm_source=zero.xyz
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/topic-scorer-taxonomy-phrase-recommender-6df00015
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_SaQgwUtJ-XU7k96Bh_p3g

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability topic-scorer-taxonomy-phrase-recommender-6df00015 -d '<json body>'
```

Example prompt: Score my blog draft about network security and tell me which phrases I'm still missing to rank in the 'Computers & Electronics/Network Security' category of Google Ads Topics taxonomy — give me the top 30 phrases.

## When to prefer this

Choose this endpoint when you need concrete phrase-level recommendations to improve a page's ranking within a specific known taxonomy category — it's distinct from a simple pass/fail check (use the sibling endpoint for that) and is ideal for content gap analysis, SEO optimization loops, and ad targeting alignment workflows where you know the target category and want actionable missing terms.

## Known failure modes

- Unknown or ambiguous category substring returns an error — use topic_scorer_find to resolve the correct category id first
- Invalid taxonomy enum value causes a 400-level error
- n out of range (must be 1–100) returns a validation error
- Malformed or missing required fields (category, taxonomy) cause request rejection
- Payment failure or insufficient funds returns a 402 error before processing

## How this service works

An MCP server that scores a page or draft against 11,485 public taxonomy categories, returns its rank per taxonomy, and gives you the phrases it still needs. $0.05 per call.

## Output

A JSON object containing the matched taxonomy category id, its full path within the taxonomy, the taxonomy name, and an ordered list of phrases (up to n, max 100) that the content is currently missing but needs to rank well in that category.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "n": {
   "type": "integer",
   "default": 30,
   "maximum": 100,
   "minimum": 1,
   "description": "Bank size."
  },
  "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)."
  },
  "taxonomy": {
   "enum": [
    "google_ads_topics",
    "google_merchant",
    "iab_content",
    "iab_audience",
    "iab_ad_product",
    "linkedin_industries"
   ],
   "type": "string",
   "description": "Taxonomy of the target category."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "id": "344",
  "path": "...",
  "phrases": [
   "firewall",
   "intrusion detection"
  ],
  "taxonomy": "google_ads_topics"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/topic-scorer-taxonomy-phrase-recommender-6df00015/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from topic-scorer.pixelcove.co](https://www.zero.xyz/host/topic-scorer.pixelcove.co/llms.txt)