Company Data Enrichment​

Overview

The Company Data Enrichment endpoint performs a deep lookup on one or more company domains, returning structural firmographic data, employee prospects, and generic contact emails — all in a single request. Built for bulk enrichment workflows where depth matters more than speed.

Who Is This For?

Role	Use Case
Marketers	Enrich contact lists with deep company profiles including industry, size, social links, and generic emails for outbound campaigns.
Lead Generation Teams	Go beyond basic firmographics — get employee prospects and contact emails attached to each domain in one shot.
Developers	Power bulk enrichment pipelines that hydrate CRM records with structured company and contact data at scale.

What You Can Build

• Bulk CRM enrichment — submit up to 10 domains per request and populate full company profiles across your entire account database.
• Prospect discovery engine — surface named employee prospects with contact emails directly tied to each domain.
• Sales intelligence layer — combine company structure, specialties, social profiles, and contacts into a single enriched record before outreach.
• Data hygiene pipeline — periodically re-enrich stale CRM records to keep firmographic data fresh and accurate.
• Full outreach workflow — pair with the Company Directory endpoint to discover companies, then enrich each domain for contacts in one automated flow.

Endpoint

POST https://api.scravity.com/v1/companies/enrich

Cost: 20 credits per domain  ·  Avg. Response Time: ~25s

Authentication

Include your API key as a Bearer token in every request.

Authorization: Bearer YOUR_API_KEY

Request Body

Parameter	Type	Required	Description
domains	array of strings	Yes	List of company domains to enrich. Maximum of 10 domains per request (e.g., ["scravity.com", "openai.com"]).

Code Examples

cURL

curl -X POST https://api.scravity.com/v1/companies/enrich \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "domains": ["scravity.com", "openai.com"]
  }'

Python

import requests

url = "https://api.scravity.com/v1/companies/enrich"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "domains": ["scravity.com", "openai.com"]
}

r = requests.post(url, json=payload, headers=headers)
print(r.json())

JavaScript

const res = await fetch("https://api.scravity.com/v1/companies/enrich", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    domains: ["scravity.com", "openai.com"]
  })
});

const data = await res.json();
console.log(data);

Response Format

Success (200)

{
  "Data": [
    {
      "Domain": "scravity.com",
      "CompanyInfo": {
        "name": "Scravity",
        "company_type": "Privately Held",
        "industry": "Software Development",
        "description": "Scraping and automation APIs for B2B data.",
        "slogan": "Data at scale.",
        "specialties": ["web-scraping", "automation", "lead-generation"],
        "city": "Cairo",
        "locality": "Egypt",
        "hqPhone": null,
        "url": "https://scravity.com",
        "url_clean": "scravity.com",
        "founded": "2023",
        "size": "1-10",
        "employees": {
          "employees_num": 5,
          "social_followers": 120
        },
        "social": [
          { "type": "linkedin", "link": "https://linkedin.com/company/scravity" }
        ]
      },
      "Prospects": [
        {
          "name": "Ahmed Hassan",
          "firstName": "Ahmed",
          "lastName": "Hassan",
          "position": "Founder",
          "emails": [
            { "email": "ahmed@scravity.com", "probability": 92 }
          ]
        }
      ],
      "Emails": [
        { "email": "contact@scravity.com", "local_part": "contact" }
      ],
      "GenericEmails": [
        { "email": "info@scravity.com", "local_part": "info" }
      ]
    }
  ],
  "Cost": 20
}

No Data Found (404)

{
  "error": "No company data found for the provided domains",
  "details": ["No enrichment data could be located for the submitted domains."]
}

Insufficient Credits (402)

{
  "error": "Insufficient credits",
  "details": ["You need at least 20 credits per domain. Current balance: 15."]
}

Validation Error (422)

{
  "detail": [
    {
      "loc": ["body", "domains"],
      "msg": "Field required",
      "type": "value_error.missing"
    }
  ]
}

Credits

Result	Cost
Per domain enriched	20 credits
No data found (404)	0 credits

Submitting 10 domains in one request costs 200 credits total. Credits are deducted per domain successfully enriched.

Rate Limits

Window	Limit
Per second	20 requests
Per minute	1,000 requests

Tips

• Batch your domains — submit up to 10 per request to maximize throughput and minimize total API calls.
• This endpoint runs a deep lookup — avg. response time is ~25 seconds. Set your HTTP client timeout accordingly (recommended: 60s minimum).
• Check Cost in the response to confirm exactly how many credits were deducted for that batch.
• Use Prospects[].emails[].probability to prioritize high-confidence contacts before starting outreach.
• Check your balance with GET /v1/credits before submitting large batches to avoid mid-job failures.