{"uid":"cap_HxF2xHZr37TwI24v4OytL","slug":"gapup-content-ranking-49c5700c","name":"Gapup Content Ranking","description":"Content ranking and popularity scoring over the enriched media layer, returns ordered works with rank scores","url":"https://mcp.gapup.io/api/v1/call/content_ranking?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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)"}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_UkawucsyvO0bWP80NobaA","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Best films for movie night","prompt":"Show me the top 15 most popular thriller films from 2010 to 2020 that I can watch right now, ranked by popularity."},{"title":"Best value gaming purchases","prompt":"What are the top 20 video games with the best value score — so highest critic score per dollar — that are currently available to buy? Show me the best value first."},{"title":"Discovering top-rated TV shows","prompt":"What are the 10 highest critic-scored TV shows of all time, sorted from best to worst score? Include all years and don't restrict to what's currently available."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T12:39:39.434Z","isFirstParty":false,"canonicalSlug":"gapup-content-ranking-49c5700c"}