API

Enrichment API

Turn a work email, a LinkedIn profile or a company domain into a full B2B record. Four REST endpoints, the same API key and credits as verification and finding, and nothing charged when nothing is found.

Request · POST /api/v2/enrich/company
curl -X POST "https://api.skrap.ai/api/v2/enrich/company" \  -H "x-api-key: $SKRAP_API_KEY" \  -H "Content-Type: application/json" \  -d '{"domain":"example.com","includeBreakdown":true}'
Response
200 OK
1{2  "found": true,3  "company": {4    "name": "Example Inc",5    "domain": "example.com",6    "website": "https://example.com",7    "linkedinUrl": "https://www.linkedin.com/company/example",8    "industry": "Software Development",9    "type": "Privately Held",10    "size": "51-200",11    "employees": 120,12    "revenueRange": "$10M-$50M",13    "foundedYear": 2015,14    "description": "Example builds software for teams.",15    "location": { "city": "Austin", "region": "Texas", "country": "US" },16    "followers": 3000,17    "emailProvider": "google_workspace",   // microsoft_365 | zoho | proofpoint | mimecast | barracuda | other | null18    "acceptsEmail": true19  },20  "headcountBreakdown": {21    "total": 120,22    "departments": [{ "name": "Engineering", "count": 60, "percent": 50 }, … ],23    "countries": [{ "name": "US", "count": 100, "percent": 83.33 }, … ]24  },25  "creditsCharged": 2,26  "requestId": "req_…"27}
  • Reverse email lookup

    Work email in, the person behind it out: name, job title, current company, location, career and LinkedIn profile.

  • Person enrichment

    LinkedIn profile in, the full profile plus the work email at their current employer when we have one.

  • Company enrichment

    Domain or LinkedIn company page in: industry, size, employees, revenue range, founded year, HQ and who hosts its email.

  • People at a company

    Filter a company's people by seniority, department and country, with their work emails, 1 credit per person.

  • Charged only when found

    A miss costs nothing, and errors never charge. Every answer says how many credits it used.

  • API, MCP and the app

    Call it over REST, from AI assistants through the MCP server, or by hand in the app's Email Finder.

Endpoints

EndpointInputYou get
POST /api/v2/enrich/reverse-emailWork emailPerson + current company
POST /api/v2/enrich/personLinkedIn profile URLPerson + current work email
POST /api/v2/enrich/companyDomain or LinkedIn company URLCompany profile (+ headcount breakdown)
POST /api/v2/enrich/company-contactsDomain or LinkedIn company URL + filtersPeople with work emails

Credits

ResultCost
Reverse email lookup — person found2 credits
Person enrichment — profile found (+ work email)1 credit (+1)
Company enrichment — company found (+ headcount breakdown)1 credit (+1)
Company contacts1 credit per person
Enrichment — nothing foundFree

Every account can create an API key (Free accounts get one, at the Free rate limit): create it in the app under Settings → API keys & MCP and send it in the x-api-key header. The free plan gets a small daily allowance to try it; paid plans can spend up to 5,000 credits a day on enrichment (contact us for more). See pricing for plans.

What we return, and what we don't

  • Business data only: names, job titles, employers, work locations, public LinkedIn URLs and work email addresses.
  • No photos, home addresses or personal mailboxes. Reverse lookup accepts work addresses only; Gmail, Outlook.com and other personal mailbox providers are refused.
  • Current job only for emails: a person's work email is returned only at their current employer, never an address at a previous one.
  • Opt-outs honoured: people and companies that asked not to be looked up come back as not found, and nothing is charged.

Rate limits

PlanRequests
Professional120 requests / minute per key
Enterprise600 requests / minute per key
Pay as you go (no subscription)60 requests / minute per key
Free30 requests / minute per key
CustomAgreed with sales

Over the limit you get 429 RATE_LIMITED with a Retry-After header. Each account also has a daily enrichment credit limit (429 ENRICH_DAILY_LIMIT, resets at midnight UTC), and a busy moment answers 503 ENRICH_UNAVAILABLE without charging.

Frequently asked questions

What is an enrichment API?

It fills in what you don't have: give it a work email, a LinkedIn profile or a company domain, and it returns the person or company behind it as structured JSON, ready for your CRM, forms or scoring.

Am I charged when nothing is found?

No. Every endpoint charges only when it returns a result, and creditsCharged in each answer says exactly what was used. Validation errors and temporary unavailability are free too.

Can I look up personal emails like Gmail?

No. Reverse lookup works on work (company) addresses only. Personal mailbox providers are refused, so the API can't be used to identify private individuals.

Are repeat lookups cheaper?

Repeat lookups answer faster and are billed like any other lookup: you pay for each result you receive.

Can I use it without writing code?

Yes. Reverse lookups and company lookups run by hand in the app (Email Finder → Enrichment), and AI assistants can call them through the MCP server.

Is enrichment GDPR compliant?

Skrap.ai returns business contact data only and honours opt-outs. You decide how you use it: keep a lawful basis for processing and respect objections. See GDPR & data protection.

Your Next Customer Is JustOne Search Away

No credit card required100 one-time free credits