API (v1)

The API ships in Phase 2. This page documents the planned v1 surface.

All endpoints are keyed via an X-Api-Key header and rate-limited per key. Responses are JSON. Fields returned depend on your plan tier (free vs. paid business contacts).

Endpoints

MethodPathDescription
GET/api/v1/celebrity/{slug}Full current representation record (per plan tier).
GET/api/v1/search?q=Name search.
GET/api/v1/changes?since=YYYY-MM-DDRepresentation change feed (delta).

Rate limiting

Each key has a daily request quota. Exceeding it returns 429 Too Many Requests.