> ## Documentation Index > Fetch the complete documentation index at: https://docs.nephia.cc/llms.txt > Use this file to discover all available pages before exploring further. # Find similar mentions > Up to ten mentions that say something close to this one, most similar first, across every Query and kept Explore run on the Account. The id is a mention's `id` from any mention read, collected in the last 30 days. Copies of the same post are collapsed and the mention you asked about never comes back. **Charges** 1 credit per mention asked about, then answers the same mention free for 10 minutes; a different mention charges again. `meta.credits_used` is what this call charged. ## OpenAPI ````yaml /openapi.json get /v1/mentions/{id}/similar openapi: 3.1.0 info: title: Nephia API description: >- The brand-monitoring API. Create a **Query** and it polls the live Sources (X, Reddit, Youtube, TikTok, Bluesky, Hacker News, Mastodon, Lemmy, GitHub, Product Hunt, Stack Overflow, RSS, AI answers — and Vinted) on an interval, keeps what matches, reads each mention for sentiment and intent, sorts it into your buckets and answers your own agent step over it. Read the result back as **mentions** — `GET /v1/mentions` across the whole Account, or per Query — or have it pushed to you as signed webhook events and delivery channels. A search can carry several terms at once, OR'd into one upstream request at one tick's cost. Authenticate with an API key on your Account. Monitoring is sold as a subscription — queries, terms, freshness and AI — with credits as the meter underneath; credit packs are overflow and never change a limit. Reading your own mentions is free; the semantic search mode and the AI passes are what meter. Request quota is per Account (all API keys share one bucket), by Plan: Free 60/min, Solo 350/min, Growth 700/min, Pro 1200/min. version: 1.0.0 servers: - url: https://api.nephia.cc description: Production security: - ApiKeyAuth: [] tags: - name: Account description: Account balance - name: Mentions description: Everything your Queries caught, across every Source - name: Queries description: The saved searches that do the catching — read, create, edit, pause - name: AI description: Group, classify, agent and summarise passes over items you name - name: X watches description: X watches, events, and activity - name: Reddit watches description: Reddit watches, events, and activity - name: Youtube watches description: Youtube watches, events, and activity - name: TikTok watches description: TikTok watches, events, and activity - name: Bluesky watches description: Bluesky watches, events, and activity - name: Hacker News watches description: Hacker News watches, events, and activity - name: Mastodon watches description: Mastodon watches, events, and activity - name: Lemmy watches description: Lemmy watches, events, and activity - name: GitHub watches description: GitHub watches, events, and activity - name: Product Hunt watches description: Product Hunt watches, events, and activity - name: Stack Overflow watches description: Stack Overflow watches, events, and activity - name: RSS watches description: RSS watches, events, and activity - name: AI answers watches description: AI answers watches, runs, events, and activity - name: Vinted watches description: Vinted watches, events, and activity - name: Vinted analytics description: Observed price history and per-day market statistics paths: /v1/mentions/{id}/similar: get: tags: - Mentions summary: Find similar mentions description: >- Up to ten mentions that say something close to this one, most similar first, across every Query and kept Explore run on the Account. The id is a mention's `id` from any mention read, collected in the last 30 days. Copies of the same post are collapsed and the mention you asked about never comes back. **Charges** 1 credit per mention asked about, then answers the same mention free for 10 minutes; a different mention charges again. `meta.credits_used` is what this call charged. operationId: getV1MentionsByIdSimilar parameters: - in: path name: id schema: type: string format: uuid required: true responses: '200': description: Similar mentions content: application/json: schema: $ref: '#/components/schemas/SimilarMentionsResponse' '400': description: Invalid request content: application/json: schema: type: object properties: error: type: string code: type: string required: - error '402': description: Insufficient credits content: application/json: schema: type: object properties: error: type: string code: type: string required: - error '404': description: Mention not found content: application/json: schema: type: object properties: error: type: string code: type: string required: - error '429': description: >- Request quota exceeded. Retry after the `Retry-After` header (seconds). Response includes `RateLimit-*` headers (IETF draft-7). content: application/json: schema: type: object properties: error: type: string code: type: string required: - error example: error: Rate limit exceeded code: TOO_MANY_REQUESTS '503': description: Semantic search is not available on this deployment content: application/json: schema: type: object properties: error: type: string code: type: string required: - error components: schemas: SimilarMentionsResponse: type: object properties: mentions: type: array items: $ref: '#/components/schemas/Mention' meta: type: object properties: credits_used: type: integer required: - credits_used required: - mentions - meta Mention: type: object properties: id: type: string source: type: string enum: - x - reddit - youtube - tiktok - bluesky - hackernews - mastodon - lemmy - github - producthunt - stackoverflow - rss - ai_answers - vinted type: type: string enum: - listing.created - listing.delisted - listing.price_changed - tweet.created - post.created - reddit_comment.created - video.created - bluesky_post.created - hn_item.created - article.created - answer.created - answer.changed - term.cited - term.uncited - status.created - lemmy_post.created - github_item.created - launch.created - stack_item.created - tiktok_video.created occurredAt: type: string publishedAt: type: - string - 'null' query: oneOf: - $ref: '#/components/schemas/MentionOrigin' - type: 'null' run: oneOf: - $ref: '#/components/schemas/MentionOrigin' - type: 'null' title: type: string body: type: string url: type: - string - 'null' metaLabel: type: string sentiment: type: - string - 'null' enum: - positive - neutral - negative - question - mixed - null intent: type: - string - 'null' enum: - purchase_intent - comparison - question - complaint - praise - other - null matchedTerms: type: - array - 'null' items: type: string authorHandle: type: - string - 'null' marks: type: array items: type: string enum: - to_reply - starred - flagged - hidden agent: type: - object - 'null' additionalProperties: {} media: oneOf: - $ref: '#/components/schemas/MentionMedia' - type: 'null' fields: type: array items: type: object properties: label: type: string value: type: string required: - label - value duplicateOf: type: - string - 'null' duplicateCount: type: number seeded: type: boolean required: - id - source - type - occurredAt - publishedAt - query - run - title - body - url - metaLabel - sentiment - intent - matchedTerms - authorHandle - marks - agent - media - fields - duplicateOf - duplicateCount - seeded MentionOrigin: type: object properties: id: type: string name: type: string required: - id - name MentionMedia: type: object properties: thumbnailUrl: type: - string - 'null' imageUrls: type: array items: type: string avatarUrl: type: - string - 'null' durationLabel: type: - string - 'null' required: - thumbnailUrl - imageUrls - avatarUrl - durationLabel securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key description: API key created from the Nephia dashboard for your Account. ````