# Company Distribution by Country

> Company Distribution by Country is a paid API for AI agents from agents.blitz-api.ai, paid per call via MPP, price unknown, status unknown (last checked 2026-10-14).

Returns the breakdown of a company's employees by country, with counts and percentage shares per ISO 3166-1 alpha-2 country code.

## Facts

- Endpoint: POST https://agents.blitz-api.ai/v2/enrichment/company-distribution-by-country?utm_source=zero.xyz
- Price: price unknown
- Payment: MPP
- Status: unknown
- Last checked: 2026-10-14
- Activations on Zero: 0
- Provider: agents.blitz-api.ai
- Website: https://agents.blitz-api.ai
- Canonical page: https://www.zero.xyz/c/agents-blitz-api-ai-company-distribution-by-country-49f6ec54
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ETuk1XwFq5hY3M7Cywc84

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability agents-blitz-api-ai-company-distribution-by-country-49f6ec54 -d '<json body>'
```

Example prompt: Can you pull the country-by-country employee distribution for OpenAI using their LinkedIn URL https://www.linkedin.com/company/openai — I want to see how many employees are in each country and what percentage they represent?

## When to prefer this

Use this endpoint when you need to understand the geographic workforce distribution of a specific company — ideal for market sizing, competitive intelligence, TAM analysis by region, or enriching CRM account records with headcount geography. Prefer this over general company enrichment when the specific question is about where employees are located rather than overall company metadata. It is faster and cheaper than building this from individual people searches.

## Known failure modes

- Invalid or malformed LinkedIn company URL returns an error
- Company URL resolves to a personal profile rather than a company page
- Company not found in the database returns empty distribution or error
- Rate limit exceeded returns 429 with remaining quota details
- Employees with unknown location aggregated under 'unknown' country code
- Prepaid credit exhausted results in payment required error (402)

## How this service works

Returns the distribution of a company's employees grouped by ISO 3166-1 alpha-2 country code.

## Output

Returns an array of distribution objects each containing a country code (ISO 3166-1 alpha-2), the employee count in that country, and the percentage ratio of total employees. Also returns the total employee count for the company, the echo of the input LinkedIn URL, and rate-limit/usage metadata (requests per second, records used, records remaining, next reset timestamp, request ID).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "required": [
  "company_linkedin_url"
 ],
 "properties": {
  "company_linkedin_url": {
   "type": "string",
   "example": "https://www.linkedin.com/company/openai"
  }
 },
 "additionalProperties": false
}
```

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "example": {
  "fair_usage": {
   "rate_limit": {
    "requests_per_second": 10,
    "remaining_this_second": 9
   },
   "request_id": "019bae09-0055-7441-b2ea-16086e499219",
   "records_used": 1,
   "next_reset_at": "2026-09-29T10:25:23.155Z",
   "records_remaining": 9913547
  },
  "distribution": [
   {
    "count": 900,
    "country": "US",
    "percentage_ratio": 72.93
   },
   {
    "count": 200,
    "country": "GB",
    "percentage_ratio": 16.21
   },
   {
    "count": 80,
    "country": "FR",
    "percentage_ratio": 6.48
   },
   {
    "count": 54,
    "country": "unknown",
    "percentage_ratio": 4.38
   }
  ],
  "total_employees": 1234,
  "company_linkedin_url": "https://www.linkedin.com/company/openai"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agents-blitz-api-ai-company-distribution-by-country-49f6ec54/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agents.blitz-api.ai](https://www.zero.xyz/host/agents.blitz-api.ai/llms.txt)