Skip to main content
POST
Find companies by tech stack
Import the companies matching a technology-stack query. This is the second step of the two-step tech-stack search — run preview first to size the segment for free, then extract to receive the full company records on your webhook. Technographics are powered by TheirStack.

Credits and rate limits

  • Credits: 3 enrichment credits per imported company
  • Authentication: standard v2 scheme (X-API-KEY)
Extract is exempt from per-second rate limiting — the credit balance is its own throttle. If the account lacks enough enrichment credits for the companies that would be imported, the request returns 402 with code: "insufficient_credits", a top_up_url, and a message reporting the shortfall — and no import is created. A workspace weekly credit limit returns 403 with code: "workspace_limit_exceeded" instead. See Credit and limit errors.

Filters

Accepts the same filters as preview (stacks, stack_match, excluded_stacks, countries, included_industries, excluded_industries, company_size), plus:
  • webhook_url (required) — where results are POSTed
  • limit — caps how many companies are imported (and billed). Defaults to 1000, which is also the hard ceiling.
  • streaming — when true, companies are POSTed one at a time instead of in a single payload
  • name — optional import name
Resolve technology names to slugs with the Technology slug lookup endpoint.

Example request

Example response

  • total_available is the full match count; total_count is what will be imported (capped by limit, then the 1000 ceiling).
  • When nothing matches, the response is 200 with { "total_count": 0, ... } and no import is created.

Webhook payload

Companies are delivered to your webhook_url using the same field names as the other company imports: name, description, website, logo, industry, location, linkedin_id, linkedin_url, employee_count, employee_range. Blank fields are omitted.

Authorizations

X-API-KEY
string
header
required

Body

application/json
webhook_url
string<uri>
required

URL that receives the imported company records.

Example:

"https://your-company.com/webhooks/stack"

stacks
string[]
required

Technology slugs to match. Resolve names to slugs with GET /accounts/technologies.

Example:
stack_match
enum<string>
default:or

How stacks combine. or matches companies using any listed technology; and requires all of them.

Available options:
or,
and
Example:

"or"

excluded_stacks
string[]

Technology slugs to exclude.

Example:
countries
string[]

ISO country codes, OR-matched against the company's country.

Example:
included_industries
string[]

LinkedIn industry IDs to include, OR-matched.

Example:
excluded_industries
string[]

LinkedIn industry IDs to exclude.

Example:
company_size
enum<string>[]

Company size display buckets to include.

Available options:
Self-employed,
1-10,
11-50,
51-200,
201-500,
501-1000,
1001-5000,
5001-10000,
10001+
Example:
limit
integer
default:1000

Caps how many companies are imported (and billed). Defaults to 1000, which is also the hard ceiling.

Required range: 1 <= x <= 1000
Example:

200

streaming
boolean

When true, companies are POSTed to the webhook one at a time instead of in a single payload.

Example:

false

name
string

Optional import name.

Example:

"Shopify prospects"

Response

No matching companies; no import created

total_count
integer
required
Example:

0

total_available
integer
required
Example:

0

message
string
required
Example:

"No results found"