# Find companies by industry and size with BlitzAPI Company Search BlitzAPI's Company Search API turns an ideal customer profile into a list of companies. You send industry, headcount, headquarters and other company filters to `POST https://agents.blitz-api.ai/zcj/7tdz61zonoua/v2/search/companies`, and the API returns each matching company. Company Search costs $0.001, a page that returns nobody costs nothing, and calls draw on Credits that you buy once by card from $0.60 with a free agent credential. ## At a glance - **Endpoint:** `POST https://agents.blitz-api.ai/zcj/7tdz61zonoua/v2/search/companies` - **Body:** a `company` object of filters (`industry`, `hq`, `employee_range` and others), `max_results`, and `cursor` for later pages - **Price:** $0.001. A page with no companies costs nothing. - **Payment:** prepaid Credits, bought by card from $0.60. Wallet payments over x402 or MPP are not offered. - **Auth:** `Authorization: Bearer ` from a free agent credential. No BlitzAPI account or API key. - **Response:** `total_results`, `results` (one record per company), `results_length`, `max_results`, `cursor` - **Limits:** up to 50 companies per page. More companies means more pages. - **Full purchase flow:** [the buyer skill](https://agents.blitz-api.ai/zcj/7tdz61zonoua/SKILL.md) ## Search companies by your ideal customer profile 1. Get a free agent credential and buy Credits once by card, from $0.60. [The buyer skill](https://agents.blitz-api.ai/zcj/7tdz61zonoua/SKILL.md) has the steps; the purchase answers with a 402 whose card lanes include a hosted checkout your human can pay, and calls then draw on the balance with the credential as a bearer token. 2. Send the search. Set `max_results` to cap how many companies a page returns; each company returned draws $0.001: ```bash curl -s -X POST https://agents.blitz-api.ai/zcj/7tdz61zonoua/v2/search/companies \ -H "Authorization: Bearer $ACCESS_TOKEN" \ -H "Content-Type: application/json" \ -d '{"company": {"industry": {"include": ["Software Development"], "exclude": []}, "hq": {"country_code": ["US"]}, "employee_range": ["51-200"]}, "max_results": 3}' ``` 3. Read each company in `results`. The response body has this shape: ```json {"total_results": 16142, "results": [{"linkedin_url": "https://www.linkedin.com/[path]", "linkedin_id": 85562, "name": "TechCrunch", "about": "TechCrunch, founded on June 11, 2005, is a news website dedicated to the tech sc…", "specialties": ["blogging", "… 8 more"], "industry": "Software Development", "type": "Privately Held", "size": "51-200", "employees_on_linkedin": 532, "followers": 2980593, "founded_year": null, "hq": {"city": "San Francisco", "state": "California", "country_code": "US", "country_name": "United States", "region": "NORAM", "continent": "North America"}, "domain": "techcrunch.com", "website": "https://link.techcrunch.com/[path]"}, "… 2 more"], "results_length": 3, "max_results": 3, "cursor": ""} ``` This search for three US software companies of 51 to 200 people returned three companies in 1.1 seconds and drew $0.003 from Credits. The response's `zc-billing` header reports `chargedUsd`, which is what your balance was debited, and `remainingCreditUsd`. 4. Get the next page. Send the same body with the `cursor` from the previous response. Stop when `cursor` is null. ```json {"company": {"industry": {"include": ["Software Development"], "exclude": []}, "hq": {"country_code": ["US"]}, "employee_range": ["51-200"]}, "max_results": 50, "cursor": ""} ``` ## Choose the filters Every filter goes inside `company`. The [Company Search reference](https://agents.blitz-api.ai/zcj/7tdz61zonoua/services/company-search/openapi.json) lists the accepted field names and values; check them before you send a request. | Profile condition | Field | Example value | | --- | --- | --- | | Industry | `industry` | `{"include": ["Software Development"], "exclude": []}` | | Headquarters country | `hq.country_code` | `["US"]` | | Size bucket | `employee_range` | `["51-200", "201-500"]` | The size buckets are `1-10`, `11-50`, `51-200`, `201-500`, `501-1000`, `1001-5000`, `5001-10000` and `10001+`. Company Search also filters by type, funding and keywords; take their field names and value formats from the reference. ## Budget a list | List size | Most it can draw | | --- | --- | | 50 companies, one full page | $0.05 | | 500 companies | $0.50 | | 1,000 companies | $1 | You are billed only for the companies a page actually returns. ## Boundaries - Every call needs a bearer credential that holds Credits. There is no anonymous pay-per-call option. - Payment is by card only, for Credits. x402 and MPP wallet payments are not accepted. - A page returns at most 50 companies. Pagination uses `cursor`. - Company Search returns company records, not people or emails. - A request rejected with `422` does not run and uses no records. ## Errors | Status or code | Meaning | Action | | --- | --- | --- | | `401 bearer_required` | No agent credential on the call | Register at [Identity](https://agents.blitz-api.ai/zcj/7tdz61zonoua/auth.md), then retry with the bearer | | `401 invalid_token` | The access token expired or did not verify | Exchange the stored assertion for a fresh token | | `403 plan_required` | The credential holds no Credits | Buy Credits with `POST /plans/{planId}/purchase`, then retry | | `usage_exhausted` | Credits ran out | Top up with `POST https://agents.blitz-api.ai/zcj/7tdz61zonoua/extend` and `{"amountUsd":""}` | | `422` | Unknown field or invalid value | Read `errors[].field` and `errors[].message`, fix the value, then resend | | `429` | Rate limit reached | Wait, then retry with backoff | The full list is in the [error reference](https://agents.blitz-api.ai/zcj/7tdz61zonoua/errors.md). ## The other BlitzAPI services | Service | What it returns | Price | | --- | --- | --- | | People Search | Decision makers inside accounts, by title, function, level and location | $0.001 | | Job Search | Postings filtered on role title, place, seniority or how recently they were posted, or all open roles at a single employer | $0.001 | | Company Enrichment | A company profile from its LinkedIn URL, domain to LinkedIn page and back, and headcount by country or department | $0.001; $0.001 | | People Enrichment | A verified work email from a LinkedIn profile, a full profile, or a person from a work email | $0.001; $0.001 | All five services draw on the same Credits. ## Frequently asked questions ### Do I need a BlitzAPI account or API key for company search? No. You register a free agent credential, buy Credits by card, and call the API through the storefront with the credential as a bearer token. ### How much does a company search cost? $0.001. A page that returns no companies costs nothing, so a list of 1,000 companies draws at most $1. ### Can I pay for BlitzAPI with a crypto wallet? No. BlitzAPI takes card payments only, for Credits. You can pay through a hosted checkout or with a shared payment token. ### How do I get more than 50 companies? Send the same filters again with the `cursor` from the previous response, one page at a time, until `cursor` is null. ### Does Company Search return contacts at each company? No. It returns company records. People Search finds people inside accounts that match the same company filters, and People Enrichment finds a verified work email from a LinkedIn profile. ## Keep reading - [The buyer skill](https://agents.blitz-api.ai/zcj/7tdz61zonoua/SKILL.md): register, buy Credits and recover access - [Identity](https://agents.blitz-api.ai/zcj/7tdz61zonoua/auth.md): the free agent credential - [How to pay](https://agents.blitz-api.ai/zcj/7tdz61zonoua/payment.md): card checkout, Credits and top-ups - [Company Search reference](https://agents.blitz-api.ai/zcj/7tdz61zonoua/services/company-search/openapi.json): every filter and its accepted values - [Error reference](https://agents.blitz-api.ai/zcj/7tdz61zonoua/errors.md): every code and what to do --- Updated 2026-10-22. All BlitzAPI guides: https://agents.blitz-api.ai/guides.md. Storefront: https://agents.blitz-api.ai/zcj/7tdz61zonoua/llms.txt.