Use case, Company list builder

Company list builder API for your agent. One call per search.

Send filters such as industry, size, country, funding stage, revenue or technology. Read company name and domain back. Your agent picks the provider, and you pay per call.

Give this to your agent
set up looot for Company list builder API - https://looot.ai/use-cases/company-list-builder/skill.md

The short answer

The short answer

Company list builder API for an agent: it sends filters such as industry, size, country, funding stage, revenue or technology to a catalog endpoint and reads company name, domain and industry back. Several providers sell the call, so the agent tries the cheapest first. You pay per call, and a failed call costs nothing.

Updated

  • Company name and domain
  • Industry and country
  • Employee count
  • Funding stage and revenue range when the provider has them
  • Matching technologies and jobs
  • LinkedIn page

The job

What the Company list builder API gives your agent

A list builder answers a query, not a name. You describe the firms you want by industry, size, country or the tools they run, and the provider returns the matches. The output is the top of a funnel: a table of companies your agent can then enrich, score or look up people at.

The providers differ in the filters they offer. One searches by technology stack and hiring signals, one by headcount and headquarters, one takes a SQL clause, and one takes its own query language. The right choice follows the filter you care about most.

You give

filters such as industry, size, country, funding stage, revenue or technology

software companies in the US with 50 to 200 employees that use Stripe

You get

  • Company name and domain
  • Industry and country
  • Employee count
  • Funding stage and revenue range when the provider has them
  • Matching technologies and jobs
  • LinkedIn page

Providers, cheapest first

What actually differs between providers

Today the price runs from $0.0019 to $0.0981 across 5 endpoints. The dearest costs about 52 times the cheapest. Price is only one difference. Each entry below says what that endpoint takes or returns that the others do not.

  1. The Companies API logoThe Companies API

    Runs a segmentation search with a query, a page and a size, and bills per company returned.

    thecompaniesapi-companies-post
    $0.0019 / result
  2. FullEnrich logoFullEnrich

    Filters by name, domain, industry, headquarters, headcount, keywords or founding year, and bills per company returned.

    fullenrich-api-company-search
    $0.0160 / result
  3. People Data Labs logoPeople Data Labs

    Filters by industry, country, region, city, employee count, founding year, funding stage, total funding and inferred revenue, bills per company returned, and also takes a SQL WHERE clause directly.

    people-data-labs-company-search-get
    $0.0300 / result
  4. Aviato logoAviato

    Takes a query in the Aviato query language with a filters array and returns a count plus the matching companies.

    aviato-company-search
    $0.0500 / call
  5. TheirStack logoTheirStack

    Filters by industry, country, employee count, revenue, funding, technology stack and hiring signals, with 1 to 25 results per page.

    theirstack-companies-search
    $0.0981 / result

Cost

What 100 Company list builder runs cost

$0.1900

100 searches cost about $0.1900 through the cheapest endpoint, at The Companies API, and about $9.81 through the dearest. Each run is one call. The cheapest endpoint bills per result, so the figure assumes one result per run.

Sample calls

The request and what comes back

Each run is one POST to /v1/runs with an endpoint id and an input. These are illustrative calls with generic values. The run's result holds the provider's own fields.

Request
{"endpointId":"theirstack-companies-search","input":{"limit":10,"company_country_code_or":["US"]},"wait":30}
ResponseSample output
// POST /v1/runs, then read run.status and run.result
// result: filters by industry, country, employee count, revenue, funding, technology stack and hiring signals, with 1 to 25 results per page

The prompt

Copy one prompt, give it to your agent.

Edit the names and numbers, paste it, and the agent runs the job and shows the cost.

  • One run is one search.
  • 1 step across 5 providers.
  • Runs on demand, whenever you ask.
Prompt: Company list builder API
Use looot to build a list of software companies in the US with 50 to 200 employees that use Stripe, and return name, domain and headcount for each. 1. Set up https://looot.ai/skill.md. 2. Search the catalog for each step and check its price before you call. 3. Run the cheapest endpoint that fits. 4. Show the results as a table and the total cost.

Give this to your agent
Setup command
set up looot for Company list builder API - https://looot.ai/use-cases/company-list-builder/skill.md

Before you start

Settle these before the first run

  • Start narrow. Each company returned is billed, so a query that returns thousands costs real money. Set a limit and widen it once the sample looks right.
  • Check the filter names on the endpoint page. They differ per provider, and a misspelled filter returns everything or nothing.
  • Send each filter as its own field, not one sentence: industry, country, employees (such as 50-200), funding_stage (such as series_a) and revenue (a range such as 10M-25M). The providers that filter by funding and revenue read those fields and skip a run that has none of them.
  • Plan the next step before you search. A list of domains feeds company enrichment, email-format lookups and people search.

FAQ

Questions people ask

Describe the segment to your agent, for example software firms in the US with 50 to 200 employees. It picks a provider that supports those filters, runs the search with a limit and returns a table of companies.

Yes, with the providers that filter by tech stack. One of them also filters by hiring signals, so you can find firms that use a tool and are hiring for it.

It depends on the provider. One caps a page at 25 companies, another at 62 through looot, and each result is billed. Your agent pages through the results until it has the number you asked for.

The list is rows of companies with domains. Enrich them with company data, look up the email format, then find the people. Each step is its own call and its own price.

No provider covers every company. Coverage is better for larger firms and in the US. Compare the first page from two providers before you commit to one.

You pay per call, and the price depends on the provider your agent picks. This page reads the cheapest live price from the catalog and shows no number when the catalog is unreachable.

No. A call that fails at the provider costs nothing, and your agent can retry it or send it to another provider.

No. One looot key reaches every provider in the catalog. You top up once, and each call is billed at the price shown before it runs.

Send a POST to /v1/runs with the endpoint id, the input and a new idempotency key, and your looot token in the Authorization header. With wait set to 30, the answer comes back in the response when the run ends within 30 seconds. Otherwise poll GET /v1/runs/<runId>.

That needs scheduled runs, not available yet. Run it by hand whenever you want fresh results.

No. looot bills per call, and nothing runs while your agent is idle.

More ways to run this job

For agents
use case
Company list builder API
run
search
schedule
on demand
step
Search companies by filters: theirstack fullenrich thecompaniesapi people-data-labs aviato
setup
https://looot.ai/use-cases/company-list-builder/skill.md
llms.txt
https://looot.ai/llms.txt
updated
2026-10-04

Try Company list builder with your own agent.

Start your workspace, top up, and paste the prompt into the agent you already use.