> ## Documentation Index
> Fetch the complete documentation index at: https://docs.refmatter.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Sources

> What Refmatter can acquire today, what is planned, and what it will never pretend to do.

`GET /v1/source-routes` is the live answer for your workspace: platform, contract version, state, recognized URL forms, and limits. The table below is the roadmap view.

| Platform                            | Objects                                                       | State                      |
| ----------------------------------- | ------------------------------------------------------------- | -------------------------- |
| YouTube                             | Public videos and Shorts (`watch`, `youtu.be`, `shorts` URLs) | **Available** (preview)    |
| Vimeo                               | Public videos                                                 | Planned                    |
| TikTok                              | Public videos and profiles                                    | Planned                    |
| Instagram                           | Public post or reel by URL                                    | Planned, partial by nature |
| Reddit, Pinterest                   | Posts, pins, boards                                           | Planned                    |
| Ad libraries (Meta, TikTok, Google) | Public ads                                                    | Planned                    |

## Route states

| State          | Meaning                                                         |
| -------------- | --------------------------------------------------------------- |
| `experimental` | Available to selected workspaces while we measure it            |
| `preview`      | Available, contract may still change                            |
| `supported`    | Stable contract and limits                                      |
| `degraded`     | Temporarily reduced; ingestions fail fast with `route_degraded` |
| `disabled`     | Off; ingestions fail fast with `route_disabled`                 |

## What a source cannot deliver

Private, members-only, purchased, age-gated, live, and premiere content is reported with stable codes (`unavailable_private`, `unavailable_restricted`, `unsupported_object`) rather than a partial result. Refmatter does not use accounts, cookies, client emulation, or rotating proxy pools to get around a source's own limits.

## Limits

Per-route limits (maximum bytes, duration, video height) are part of the route projection. Exceeding one is `limit_exceeded` and is not retried.
