API

A read API over the same queries the site uses. It is part of Pro; create a key on your account page and send it as a Bearer token.

curl -H "Authorization: Bearer $THEFLOW_KEY" \\
  https://theflow.svmpsp.dev/api/v1/items?limit=5

What you get back

Every response carries our metadata, our machine-generated summary and a link to the publisher. Article text is never included — that belongs to the publication, and the link is how you reach it.

Endpoints

GET /api/v1/items

The newest items. limit (max 100), offset, repeatable tag.

GET /api/v1/search

q is required. mode=semantic ranks by meaning using the same embeddings the site uses; anything else is full-text keyword search.

GET /api/v1/watchlists/{id}/matches

What a saved search has matched, newest first, each with a closeness figure. Only your own watchlists are visible.

GET /api/v1/export

format=json (default), jsonl or csv, up to 1,000 items.

GET /api/v1

A machine-readable index of the above.

Limits and errors

• 1,000 requests per key per rolling 24 hours.
• 401 — no key, or a key that has been revoked. 403 — a valid key on an account without Pro. 429 — over the daily limit, with Retry-After.
• Revoking a key on the account page stops it working immediately.

Fair use

Attribute The Flow and link to the publisher when you republish anything derived from this. If you need more than the daily limit, ask — it is usually fine.