Skip to content
Get started
For developers

One API for people, companies, social profiles and jobs.

Build Enricho data into your app, your pipeline or your own agent. JSON over HTTPS with an API key, free previews, and you only pay for records you get.

Get an API keyAPI reference

Your first request in a minute

Create a key in the app, then send a free preview. Set preview to false for full records at 1 credit each.

Request
curl -X POST https://api.enricho.co/api/directory/people/search \
  -H "Authorization: Bearer $ENRICHO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "job_title": ["head of marketing"],
    "employee_size_band": ["51-200"],
    "has_email": true,
    "preview": true
  }'
Response · 0 credits
{
  "success": true,
  "result": {
    "results": [
      {
        "person_id": "p_8f2c...",
        "full_name": "Alex Morgan",
        "job_title": "Head of Marketing",
        "seniority": "head",
        "company_name": "Northwind Software",
        "company_domain": "northwind.example",
        "employee_size_band": "51-200",
        "has_email": true,
        "has_phone": false,
        "has_linkedin": true
      }
    ],
    "has_more": true,
    "credits_used": 0
  },
  "message": ""
}

Four searches, one shape

Every search takes JSON filters and returns the same envelope. Billing endpoints are free.

records to search
551M+
records per page, with cursors for more
100
credit per full record; previews are free
1
credits for records you already bought
0

Built for production

Predictable to build on, and to pay for.

No surprise charges, no partial pages, no guessing at error text.

AuthenticationErrors

  • Simple auth

    An enr_ key in Authorization: Bearer, or X-Api-Key. Up to 20 active keys per account; revoke any of them in the app.

  • Cursor pagination

    Ask for 1–100 records per page. When has_more is true, send next_cursor with the same filters.

  • All or nothing pages

    If your balance can't cover a whole page you get a 402 with no records and no charge. No partial debits.

  • Never pay twice

    Records you already bought come back free, so re-running a job or paging back costs nothing extra.

  • One response shape

    Every response is { success, result, message }. Errors carry result.code, so you branch on codes, not text.

  • Same account as MCP

    Keys, credits and purchased records are shared with the MCP server, so your app and your agent see the same data.

REST API

For your backend, scripts and scheduled jobs

Call it from any language. Enrich sign-ups, refresh a CRM export overnight, or power search inside your product.

REST referenceAPI keys
MCP server

For the AI agent you're building

Point your agent at the MCP server and it gets every tool, schema and cost from tools/list. Use an API key for headless agents.

Build an agentConnect a client

FAQ

Developer questions

Keys, limits, costs and retries.

Sign in at app.enricho.co, open API keys and choose Create key. The key is shown once, so store it in a secret manager or environment variable.

Still have a question? Contact us

Send your first request free

Create a key and preview people and companies at no cost. 100 free credits every month.

Get an API key