Reep Register

Move from RapidAPI to the release API.

The old v0 service remains a frozen bridge for existing RapidAPI users. Reep v1 is the launch API backed by the public release files at /api/v1. It is a new register, not a drop-in v0 ID continuity layer.

Key transition

Endpoint Mapping

v0 endpoint v1 path Status
GET /health GET /api/v1/meta No exact health clone. Use metadata to verify release stamp and API readiness.
GET /stats GET /api/v1/meta, /coverage Counts now come from the release manifest and coverage page. Response shape differs.
GET /search Not in launch API Use CSV or DuckDB downloads for bulk search, or treat API search as a follow-up feature.
GET /lookup?id=reep_... GET /api/v1/entities/{reep_id} v1 accepts the new Reep IDs only. v0 IDs are not interchangeable.
GET /lookup?id=Q... Not in launch API Wikidata remains overlay/discovery context, not a launch lookup contract.
GET /resolve GET /api/v1/resolve/{provider}/{external_id} Supported with namespace and optional type query parameters.
POST /batch/lookup, POST /batch/resolve POST /api/v1/batch One unified endpoint: up to 100 items per request, each item typed entity or resolve, per-item {status, body} results so one miss never fails the batch.

Resolve Example

Old RapidAPI call:

curl --request GET \
  --url 'https://the-reep-register.p.rapidapi.com/resolve?provider=transfermarkt&id=568177&type=player' \
  --header 'x-rapidapi-host: the-reep-register.p.rapidapi.com' \
  --header 'x-rapidapi-key: YOUR_RAPIDAPI_KEY'

New v1 call:

curl -H "Authorization: Bearer $REEP_API_KEY" \
  "https://reep.football/api/v1/resolve/transfermarkt/568177?namespace=spieler&type=player"

Customer Checklist

  • Confirm which v0 endpoints and provider pairs the customer uses.
  • Issue a v1 key for testing after the deployed smoke test passes.
  • Check whether flat files or DuckDB are a better fit for bulk workflows, or move bulk lookups to POST /api/v1/batch.
  • Record search needs as explicit follow-up work if they block migration.