# Gapup Content Similar Works Recommendation

> Gapup Content Similar Works Recommendation 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 a ranked list of works or franchises most similar to a given content entity, matched by tags and audience profile

## Facts

- Endpoint: POST https://mcp.gapup.io/api/v1/call/content_similar?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-similar-works-recommendation-cb4c41dc
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_veaeDJCfrWAZybYxZd5I1

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-similar-works-recommendation-cb4c41dc -d '<json body>'
```

Example prompt: 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?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

Similar-works recommendation engine, returns titles most alike a given work by tags and audience profile

## Output

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.

## 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."
  },
  "limit": {
   "type": "integer",
   "maximum": 30,
   "minimum": 1
  },
  "entity_id": {
   "type": "string",
   "description": "Entity id from content_catalog"
  },
  "entity_type": {
   "enum": [
    "franchise",
    "work"
   ],
   "type": "string"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/gapup-content-similar-works-recommendation-cb4c41dc/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)