// reference

REST API reference

Base URL: https://api.agenticdata.host · Interactive docs: api.agenticdata.host/docs

Authentication

All requests require a bearer token in the Authorization header.

Authorization: Bearer ADATA_live_xxxxxxxxxxxxxxxx

Create keys in the DataBeacon dashboard (Lovable Cloud) or via POST /v1/dashboard/keys.

Endpoints

Method	Path	Description
`GET`	`/v1/enrich/person`	Enrich by email, phone, LinkedIn, or domain (query params).
`POST`	`/v1/enrich`	Enrich with JSON body (email, phone, linkedin, domain, name+company).
`POST`	`/v1/person/lookup`	Apify-compatible single lookup; returns nested `person` object.
`POST`	`/v1/person/batch`	Up to 10,000 synchronous lookups; returns array of results.
`GET`	`/v1/search/people`	Filter people by company, title, location, industry, etc.
`GET`	`/v1/usage`	Current period usage and quota.

POST /v1/enrich

curl https://api.agenticdata.host/v1/enrich \
  -H "Authorization: Bearer $DATAAPI_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"satya@microsoft.com"}'

Response format

{
  "found": true,
  "data": {
    "source": "5x5",
    "full_name": "Satya Nadella",
    "first_name": "Satya",
    "last_name": "Nadella",
    "primary_email": "satya@microsoft.com",
    "job_title": "Chief Executive Officer",
    "company_name": "Microsoft Corporation",
    "company_domain": "microsoft.com",
    "city": "Redmond",
    "state": "WA"
  },
  "sources_checked": ["pdl", "5x5"],
  "latency_ms": 120
}

No match

Returns 200 with {"found": false, "data": null}. You are not charged for empty matches on pay-as-you-go plans.

Rate limiting

Every authenticated response includes:

X-RateLimit-Limit: 100000
X-RateLimit-Remaining: 9981
X-RateLimit-Reset: 1738200000

Error codes

Code	Meaning
`401`	Missing or invalid API key.
`402`	Subscription inactive.
`429`	Daily or per-second rate limit exceeded.
`503`	Billing or dashboard routes not configured.

Client libraries

Use any HTTP client. TypeScript client included in this repo at src/lib/dataapiClient.ts. MCP server source: backend/mcp/.