{"uid":"cap_veaeDJCfrWAZybYxZd5I1","slug":"gapup-content-similar-works-recommendation-cb4c41dc","name":"Gapup Content Similar Works Recommendation","description":"Similar-works recommendation engine, returns titles most alike a given work by tags and audience profile","url":"https://mcp.gapup.io/api/v1/call/content_similar?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."},"limit":{"type":"integer","maximum":30,"minimum":1},"entity_id":{"type":"string","description":"Entity id from content_catalog"},"entity_type":{"enum":["franchise","work"],"type":"string"}}},"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_BFrSXRl2xJ4QP1fFgpbJX","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 a ranked list of works or franchises most similar to a given content entity, matched by tags and audience profile","exampleAgentPrompt":"Can you find me up to 10 works similar to this one — entity ID 'wrk_abc123' (a work, not a franchise) — based on its tags and audience profile?","exampleUseCases":[{"title":"Movie night discovery for fans","prompt":"I really liked the franchise with entity ID 'frn_marvel_001' — can you pull up 8 franchises that are most similar to it based on audience profile and tags so I can figure out what to watch next?"},{"title":"Book recommendation for a reading list","prompt":"I want to find 5 works similar to the book with entity ID 'wrk_dune_007' — same kind of audience, similar genre tags — what would you suggest?"},{"title":"Content editor sourcing comparable titles","prompt":"I'm writing a piece about franchise 'frn_got_002' and need up to 15 franchises with a similar audience and tag profile — can you pull those from Gapup so I can reference them?"}],"resultDescription":"A ranked list of content works or franchises most similar to the specified entity, ordered by similarity score based on shared tags and audience profile data, up to the requested limit.","failureModes":["Invalid or unknown entity_id returns an error or empty results","entity_type mismatch (e.g. passing a franchise ID as a work) may return irrelevant or no results","limit out of range (below 1 or above 30) returns a validation error","Async mode returns a job_id that must be polled separately — forgetting to poll yields no result","Payment failure (x402) blocks the call entirely"],"whenToPreferThis":"Use this endpoint when you need content-to-content similarity recommendations grounded in tag overlap and audience profile data, specifically for works or franchises already catalogued in the Gapup content catalog. Prefer it over keyword search when you want recommendations based on holistic similarity rather than title or description matching. Best suited for recommendation pipelines, editorial discovery, or user-facing 'more like this' features.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T12:42:34.030Z","isFirstParty":false,"canonicalSlug":"gapup-content-similar-works-recommendation-cb4c41dc"}