Enrich Company

Enrich Company API Endpoint retrieves information about company from its name and/or email address and/or domain.

Request

Authorization

Authorization token in the Bearer format.
Provide your bearer token in the Authorization header when making requests to protected resources.

Example:

X-API-Key: ck5-123456789012345678901234567890123456789012345678901234567890

Parameters

company_name

Official Name of the Company

Example:

Acme Corporation Inc.

email

Valid Email address of the Company

Example:

info@acme.com

domain

Valid Domain Name of the Company

Example:

acme.com

timeout

Timeout in seconds for enrichment process
Default value: 120 seconds

Example:

120

Responses

200 – Success

{
 ”name”: “Acme Corporation Inc.”,
 ”avatar_url”: “https://example.com/logos/acme-corp.jpg”,
 ”domain”: “acme.com”,
 ”email”: “info@acme.com”,
 ”phone”: “1231231234”,
 ”address1″: “123 Nice Street”,
 ”address2″: “Suite 100″,
 ”city”: “Chicago”,
 ”state”: “IL”,
 ”zip”: “60606”,
 ”country”: “US”,
 ”linkedin”: “https://linkedin.com/company/acme-corporation”,
 ”facebook”: “https://facebook.com/acmecorp”,
 ”instagram”: “https://instagram.com/acmecorp”,
 ”twitter”: “https://x.com/acmecorp”,
 ”youtube”: “https://youtube.com/@acmecorp”,
 ”description_short”: “Short description (usually a sentence) of the enriched Company’s profile.”,
 ”description_long”: “Long description (usually a paragraph) of the enriched Company’s profile.”,
 ”employee_count”: “500”,
 ”industry”: “Technology”,
 ”year_funded”: “2000”
}

400 – Bad Request

Bad request due to missing required parameters. This occurs when neither company_name, email, nor domain is provided.

{
 ”detail”: “Either company_name, email, or domain must be provided.”
}

422 – Validation Error

Validation error occurred during the enrichment process. This may be due to invalid input parameters. The error details will be included in the response.

{
 ”detail”: “Validation error occurred during the enrichment process. Please check the input parameters and try again.”
}

429 – Rate Limit Exceeded

The API key has exceeded its allowed number of requests within the time window. Please wait before making additional requests or upgrade your API plan for higher rate limits.

{
 ”detail”: “Daily/Minute rate limit exceeded.”
}

500 – Internal Server Error

Internal server error occurred during the enrichment process. This may be due to service unavailability, timeout issues, or unexpected errors in the enrichment process. The error details will be included in the response.

{
 ”detail”: “An unexpected error occurred while processing the enrichment request. Please try again later or contact support if the issue persists.”
}