{"uid":"cap_sEGT4nE4aPKEPJHQAM1wV","slug":"gapup-content-discovery-search-2f5f3f10","name":"GapUp Content Discovery Search","description":"Content discovery and search over the enriched media catalogue, returns matching works ranked by relevance","url":"https://mcp.gapup.io/api/v1/call/content_discovery?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"tag":{"type":"string","maxLength":80,"minLength":2,"description":"Tag label to match precisely (e.g. 'thriller', 'co-op'). Mutually exclusive with `query`."},"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."},"limit":{"type":"integer","maximum":50,"minimum":1,"description":"Maximum franchises to return (default 25)"},"query":{"type":"string","maxLength":400,"minLength":3,"description":"Free-text intent for semantic search (e.g. 'melancholic synth-pop about heartbreak'). Mutually exclusive with `tag`."},"domain":{"enum":["music","film","tv","video-game"],"type":"string","description":"Content domain to search within"}}},"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_qb2bx0B4Y0ibSJGXT3yAr","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":"Semantically searches an enriched media catalogue (music, film, TV, video games) by free-text intent or exact tag, returning ranked matching works","exampleAgentPrompt":"Search the GapUp media catalogue for music that matches 'melancholic synth-pop about heartbreak' and return the top 10 results.","exampleUseCases":[{"title":"Mood-based music discovery","prompt":"Find me music in the GapUp catalogue that feels like 'dreamy lo-fi beats for late-night studying' — give me the top 15 results."},{"title":"Genre tag search for video games","prompt":"Search the GapUp media catalogue for video games tagged 'co-op' and return up to 20 matching titles."},{"title":"Semantic film discovery for curation","prompt":"I'm building a curated film list — search the GapUp catalogue for films matching 'gritty urban crime dramas set in the 1970s' and show me the top 10."}],"resultDescription":"An ordered list of matching media works (up to the specified limit) ranked by relevance to the query or tag, drawn from the enriched GapUp media catalogue. Each result represents a franchise or work with associated metadata from the enriched media layer.","failureModes":["Supplying both `query` and `tag` simultaneously (mutually exclusive fields) returns a validation error","Query string shorter than 3 characters or tag shorter than 2 characters returns a validation error","Unsupported domain value outside enum returns a validation error","No matching results found returns an empty list","Payment failure (x402) prevents the call from executing","Async job polling returns pending status if result not yet ready"],"whenToPreferThis":"Use this endpoint when you need to discover or surface media works from an enriched catalogue by semantic intent or exact tag, especially for music, film, TV, or video games. Prefer this over the ranking endpoint when discovery (finding what exists matching a description) is the goal rather than ordering already-known works. Prefer semantic `query` for open-ended exploration and `tag` for precise genre/label filtering.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T12:41:12.979Z","isFirstParty":false,"canonicalSlug":"gapup-content-discovery-search-2f5f3f10"}