{"uid":"cap_ETuk1XwFq5hY3M7Cywc84","slug":"agents-blitz-api-ai-company-distribution-by-country-49f6ec54","name":"Company Distribution by Country","description":"Returns the distribution of a company's employees grouped by ISO 3166-1 alpha-2 country code.","url":"https://agents.blitz-api.ai/v2/enrichment/company-distribution-by-country?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["company_linkedin_url"],"properties":{"company_linkedin_url":{"type":"string","example":"https://www.linkedin.com/company/openai"}},"additionalProperties":false},"responseSchema":{"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"}},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"unknown","displayCostAsset":"USD","priceDynamic":true,"priceHint":null,"priceStatus":"unknown_unparsed","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"unknown","summary":"price unknown","primary":{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"},"accepted":[{"kind":"dynamic","protocol":"mpp","network":"tempo","amountUsd":null,"per":"call","confidence":"unknown"}]},"paymentMethods":[{"uid":"pm_Cv24tCAD46rfMsZwi-giX","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"unknown","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":"agents.blitz-api.ai","brandSlug":"agents-blitz-api-ai-x402","brandBaseUrl":"https://agents.blitz-api.ai","brandDocsUrl":null,"whatItDoes":"Returns the breakdown of a company's employees by country, with counts and percentage shares per ISO 3166-1 alpha-2 country code.","exampleAgentPrompt":"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?","exampleUseCases":[{"title":"Mapping global workforce footprint","prompt":"I need to understand where Stripe's employees are distributed globally — can you look up their LinkedIn page at https://www.linkedin.com/company/stripe and give me a breakdown by country with headcount and percentages?"},{"title":"Competitive headcount intelligence","prompt":"I'm analyzing whether our competitor Salesforce has a significant presence in Europe — can you pull their country employee distribution from LinkedIn at https://www.linkedin.com/company/salesforce so I can see the percentage in each country?"},{"title":"CRM account enrichment with geo data","prompt":"For the account I'm researching — HubSpot at https://www.linkedin.com/company/hubspot — can you get me the employee distribution by country so I can tag their CRM record with their primary workforce locations?"}],"resultDescription":"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).","failureModes":["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)"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-14T00:34:41.463Z","isFirstParty":false,"canonicalSlug":"agents-blitz-api-ai-company-distribution-by-country-49f6ec54"}