Spiral gives your agent every tool with one account. Browse the tools →

AlexandriaLead GenAvailable now

LeadOcean · Company count

leadocean/companies/count

Find companies, people and contact details with LeadOcean · Company count from Alexandria through one Spiral API key. Count companies that match a company search, for free, with breakdowns by industry, headcount, headquarters country, headquarters state, and NAICS. The same filters as companies/search, without a page. total is null when a filter could not be applied; totalWithheld names it. Nothing is charged. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

Pricing

$0.013 per call.

Limits

Runs
In the background
Returns
json
Longest queue wait
1 hour
Run deadline
5 minutes
Longest run, end to end
225 minutes
Largest inline input
1 MB
Largest input file
2 GB
Largest output
5 GB

Input

FieldKindDefaultDescription
qtext—

Free text over the company name and description.

siclist—

SIC codes.

namelist—

Company name phrase. Wrap a value in [brackets] for an exact name.

slimtrue or false—

Accepted by the count route. The response is the totals, not company rows.

naicslist—

NAICS codes. Any code the company carries.

domainlist—

Company website domains, without a scheme or path.

fieldslist—

Accepted by the count route. The response is the totals, not company rows.

hqCitylist—

Headquarters city keywords.

hqStatelist—

Headquarters state or region. A code such as TX also matches Texas.

industrylist—

Company industry. Send LeadOcean's exact industry label.

keywordslist—

Phrases in the company description, specialties, tags, and name, or an exact industry label.

linkedinlist—

Company LinkedIn URLs.

hqCountrylist—

Headquarters country. ISO 3166-1 alpha-2 codes.

investorslist—

Lead investor name keywords.

maxFoundednumber—

Latest year founded. Records with no figure are left out.

maxFundingnumber—

Total funding raised, in USD, upper bound.

maxRevenuenumber—

Annual revenue ceiling, in USD. Records with no figure are left out.

minFoundednumber—

Earliest year founded. Records with no figure are left out.

minFundingnumber—

Total funding raised, in USD, lower bound.

minRevenuenumber—

Annual revenue floor, in USD. Records with no figure are left out.

companyTypelist—

Legal type of the company.

excludeNamelist—

Company name phrases to exclude.

fundingTypelist—

Type of the most recent funding round.

hqContinentlist—

Continent of the headquarters.

naicsSectorlist—

Two-digit NAICS sector.

maxEmployeesnumber—

Company headcount, upper bound. Records with no figure are left out.

minEmployeesnumber—

Company headcount, lower bound. Records with no figure are left out.

minFollowersnumber—

Minimum company LinkedIn followers. 0 means no minimum.

naicsPrimarylist—

The one NAICS code the company is filed under.

technologieslist—

Technologies detected on the company website.

employeeRangelist—

Headcount bracket, such as 51-200.

hqSalesRegionlist—

Commercial region of the headquarters.

excludeIndustrylist—

Industries to exclude. Send LeadOcean's exact industry label.

excludeKeywordslist—

Company keywords, or exact industry labels, to exclude.

maxLastFundingYearnumber—

Funded no later than this year.

minLastFundingYearnumber—

Funded no earlier than this year.

hasMailableContactstrue or false—

True keeps companies with a verified, catch_all_valid, or catch_all email on at least one person.

technologyCategorieslist—

What a detected technology is for. Send LeadOcean's category label.

Same request in code

curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "leadocean/companies/count",
    "input": {
      "q": "<q>"
    }
  }'

Frequently asked questions

How much does LeadOcean · Company count cost?

$0.013 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

How do I use LeadOcean · Company count through an API?

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "leadocean/companies/count"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

Do I need an account with Alexandria to use LeadOcean · Company count?

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

Can my AI agent use LeadOcean · Company count?

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.