API Reference

Authentication

All API requests require an API key. Pass it via the X-API-Key header (preferred) or Authorization: Bearer. Generate keys from your dashboard.

X-API-Key: ek_your_api_key_here

# or
Authorization: Bearer ek_your_api_key_here

Keys are prefixed with ek_. Keep them secret — do not expose them in client-side code.

Base URL

https://api.enrichkit.dev/v1

Enrich Profile

Look up a professional profile by URL. Returns structured data including name, title, company, location, and experience.

Request Body

Example Request

curl -X POST https://api.enrichkit.dev/v1/profile \
  -H "X-API-Key: ek_your_key" \
  -H "Content-Type: application/json" \
  -d '{"url": "linkedin.com/in/janedoe"}'

Example Response

{
  "name": "Jane Doe",
  "title": "Head of Growth",
  "company": {
    "name": "Acme Corp",
    "industry": "SaaS",
    "headcount": "201-500"
  },
  "location": "Austin, TX",
  "experience": [
    {
      "title": "Head of Growth",
      "company": "Acme Corp",
      "start_date": "2022-03",
      "end_date": null
    }
  ],
  "education": [...],
  "skills": [...]
}

Get Posts

Retrieve recent posts from a profile.

Get Reactions

Retrieve reactions on a specific post.

Enrich Company

Look up a company by URL. Returns structured company data.

Check Usage

Returns your current usage, limits, and rate limit info.

Example Response

{
  "plan": "growth",
  "credits": {
    "remaining": 37550,
    "total": 50000,
    "resets_at": "2026-04-15T00:00:00Z"
  },
  "rate_limit": {
    "requests_per_minute": 300
  }
}

Rate Limits

Rate limits are enforced per API key based on your plan. Limits reset every minute on a sliding window.

When you hit a rate limit, the API returns 429 Too Many Requests with a Retry-After header.

Errors

Enrichkit uses standard HTTP status codes. Errors return a JSON body with a message field.

Error Response

{
  "error": "quota_exceeded",
  "message": "No credits remaining. Upgrade your plan for more requests.",
  "credits": 0,
  "plan": "starter"
}