Skip to main content
Refmatter is an API for public social content. Give it a link and get structured data back inside the same request, typically in a few seconds. When you need the media itself, import the link and get a durable reference.

Quickstart

Look up an item, then keep its media.

Look up an item

Get one public item in the same request.

Import a URL

Keep verified media, a poster, a transcript, and provenance.

MCP

Use the same API from an MCP client.

​
Two ways to use it

​
Item data

GET /v1/resolve is free and contacts no platform. GET /v1/items/lookup costs 1 credit. Errors cost nothing, and a repeat inside your own maxAge is free. See Look up an item for the rules. Beyond one item, the same synchronous rules cover one account on YouTube, Instagram, and TikTok, the items an account published on all four platforms, search on YouTube and the Meta Ad Library, and comments on YouTube videos. For an end-to-end marketing workflow, see Scan a competitor’s content.

​
Reference library

  1. Submit a URL with POST /v1/imports.
  2. Wait until the reference is readable.
  3. Read the reference and use its verified media while the media hold is active.

​
What it covers

See Sources for accepted URL forms.

​
Boundaries

Refmatter returns public data as a visitor who is not signed in sees it. It does not use platform accounts, logins, or account cookies. What a source does not show publicly is reported with a stable error code, never as an empty result. Media bytes are kept only under a time-boxed hold.