Use case, Company list builder

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

Send filters such as industry, size, country 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 - https://looot.ai/skill.md

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 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
  • Matching technologies and jobs
  • LinkedIn page

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 steps 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 - https://looot.ai/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.
  • 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.

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/skill.md
llms.txt
https://looot.ai/llms.txt
updated
2026-10-04
markdown /use-cases/company-list-builder.md

Try Company list builder with your own agent.

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

Start your workspace See agent recipes