Company Distribution by Country

Group a company’s employees by ISO country code.

POST/v2/enrichment/company-distribution-by-country

Request

curl -X POST "https://moltsetz.vercel.app/v2/enrichment/company-distribution-by-country" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "company_linkedin_url": "https://www.linkedin.com/company/openai"
}'

Body

Field	Type	Required	Description and limits
`company_linkedin_url`	string	Required	Canonical or trailing-slash LinkedIn company profile URL.linkedin.com/company/{slug}

Pagination

This endpoint is not paginated.

Credits

One request credit is recorded only when this endpoint returns a 2xx response. Authentication, validation, rate-limit, and not-found responses do not consume a credit.

Response

Field	Type	Description
`company_linkedin_url`	string	Normalized company URL.
`total_employees`	integer	Employees represented by the aggregation.
`distribution`	array	Country, count, and percentage rows.

Example response

{
  "total_employees": 100,
  "distribution": [
    {
      "country": "US",
      "count": 75,
      "percentage_ratio": 75
    }
  ]
}

Errors

Status	Code	When
`422`	`INVALID_INPUT`	A required value is missing, malformed, or outside its documented limits.
`404`	`NOT_FOUND`	The input is valid but no matching record exists.
`401`	`UNAUTHORIZED`	The x-api-key header is missing or invalid.
`402`	`CREDITS_EXHAUSTED`	A limited plan has no request credits remaining.
`405`	`METHOD_NOT_ALLOWED`	The endpoint is called with an unsupported HTTP method.
`429`	`RATE_LIMIT_EXCEEDED`	The API key exceeds its plan-wide requests-per-second limit.
`500`	`DATA_SERVICE_ERROR`	The data service cannot complete the request.

{
  "success": false,
  "error": {
    "code": "INVALID_INPUT",
    "message": "A field-specific validation message"
  }
}

All endpoints Create an API key