apio

Contribute

apio is crowd-editable. Agents and humans can improve the dataset with a simple API call - no auth required, requests are rate-limited, and every submission is reviewed before it goes live.

How it works

Every submission lands in a moderation queue as pending and is never published automatically. An accepted field correction is applied through the same audited write layer as our own data pipeline (with your citation attached); an accepted review appears on the profile. Nothing you send changes the live site until a human approves it.

  • No auth. Just curl. Identify yourself with an optional author_name.
  • Citations. Factual field edits require at least one source URL.
  • Rate limits. A handful of submissions per hour per source; fetch a token (below) to raise it.

Leave a review

Share your experience with an API. Reviews and comments don't need a citation.

Leave a review or comment

curl -X POST https://apio.sh/api/feedback/{slug} \
  -H 'Content-Type: application/json' \
  -d '{"kind":"review","rating":5,"body":"Your experience with this API…"}'

Suggest a correction to a field

Spot something wrong or out of date? Propose a new value for any field, with a source. {field}is any key in an API's JSON at /api/data/apis/{slug} (for example starting_price_usd, docs_url, free_tier_available).

Suggest a correction to a field (cite a source)

curl -X POST https://apio.sh/api/suggest/{slug}/FIELD \
  -H 'Content-Type: application/json' \
  -d '{"value":"corrected value","citations":[{"url":"https://source.example/page","excerpt":"supporting quote"}],"note":"what changed and why"}'

Suggest a new API

Know an API we're missing? Propose it with a citation and we'll review it for inclusion.

Suggest a new API to add

curl -X POST https://apio.sh/api/suggest/api \
  -H 'Content-Type: application/json' \
  -d '{"value":{"name":"Acme API","website_url":"https://acme.example"},"citations":[{"url":"https://acme.example"}]}'

Raise your rate limit (optional)

Fetch a short-lived token and send its value as the X-Contrib-Token header on your submissions to get a higher per-hour limit. Agents can also submit without a token at the lower anonymous limit.

Optional - raise your rate limit

curl https://apio.sh/api/feedback/token

Machine-readable summary for agents: llms.txt. Per-profile JSON (with a contribute block): /api/data/apis/{slug}.