# Gapup Content Ranking

> Gapup Content Ranking is a paid API for AI agents from mcp.gapup.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-18).

Returns ordered lists of music, film, TV, or video-game titles ranked by critic score, popularity, price, or value within optional genre and year filters

## Facts

- Endpoint: POST https://mcp.gapup.io/api/v1/call/content_ranking?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-18
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/gapup-content-ranking-49c5700c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HxF2xHZr37TwI24v4OytL

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 gapup-content-ranking-49c5700c -d '<json body>'
```

Example prompt: Give me the top 10 highest critic-scored RPG video games released between 2015 and 2023 that are currently available to buy, ranked best first.

## When to prefer this

Use this endpoint when you need a ranked, ordered list of entertainment content (music, film, TV, or video games) sorted by critic score, popularity, price, or value. Prefer this over generic search when the user wants a definitive ranking rather than discovery by keyword or title lookup. It is ideal for recommendation scenarios where the goal is 'what's best/most popular/best value in genre X' rather than finding a specific known title.

## Known failure modes

- Invalid domain value returns validation error — must be one of music, film, tv, video-game
- Invalid criterion enum value returns an error
- year_from greater than year_to returns empty or error result
- limit outside 1-50 range is rejected
- No results found for highly specific genre+year filter combination returns empty list
- Unavailable works filtered out when available_only=true may drastically reduce result set

## How this service works

Content ranking and popularity scoring over the enriched media layer, returns ordered works with rank scores

## Output

An ordered array of content works (music albums, films, TV shows, or video games) with rank scores corresponding to the chosen criterion, sorted by the specified direction. Each entry includes metadata about the work and its score on the selected metric.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "async": {
   "type": "boolean",
   "description": "If true, returns a job_id immediately (<200ms) instead of waiting for the result. Poll the result with job_result(job_id). Use for slow tools to avoid client timeouts."
  },
  "genre": {
   "type": "string",
   "description": "Optional genre filter, e.g. 'RPG', 'FPS', 'thriller'"
  },
  "limit": {
   "type": "integer",
   "maximum": 50,
   "minimum": 1,
   "description": "Number of ranked results (default 20)"
  },
  "domain": {
   "enum": [
    "music",
    "film",
    "tv",
    "video-game"
   ],
   "type": "string",
   "description": "Content domain to rank within"
  },
  "year_to": {
   "type": "integer",
   "description": "Optional latest release year"
  },
  "criterion": {
   "enum": [
    "critic_score",
    "popularity",
    "price",
    "value"
   ],
   "type": "string",
   "description": "critic_score (0-100, default) · popularity · price · value (critic score per unit price)"
  },
  "direction": {
   "enum": [
    "desc",
    "asc"
   ],
   "type": "string",
   "description": "desc = best/highest first (default); asc = cheapest/lowest/least first. Defaults to asc for price."
  },
  "year_from": {
   "type": "integer",
   "description": "Optional earliest release year"
  },
  "available_only": {
   "type": "boolean",
   "description": "If true, restrict to entities currently available to buy/play (default false)"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gapup-content-ranking-49c5700c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mcp.gapup.io](https://www.zero.xyz/host/mcp.gapup.io/llms.txt)