Skip to main content
GET
Export signals to CSV API

Frequently asked questions

One credit per exported row, charged after the export completes. The X-Credits-Cost and X-Export-Rows response headers report the exact figures. Because the underlying scan runs regardless of how many rows you take, every export that runs debits at least 1 credit — a key can never trigger more scans than it holds credits.
The export is capped to your remaining credits. You receive the most recent N rows, you are charged N, and the response carries X-Export-Capped: credits. Top up and run it again to pull the rest. A key with zero credits gets a 402 and the scan never runs at all.
Pass limit. It bounds both the delivered rows and the bill, and is clamped to 10,000. Omit it for a full export up to that cap. For extraction beyond 10,000 rows, use lead lists instead — they run as a background job built for volume.
Always the same 27, in the same order, regardless of which filters produced the export: 10 signal columns, 9 LinkedIn company columns, and 8 website columns from the crawl (emails, phones, five social profile URLs, and site language). The company and website blocks ride every export, so a query filtered on has_email=true actually returns the email addresses. Both blocks are left-joined, so a domain with no match exports empty cells rather than being dropped.
Not yet. Export covers churn and adoption only, because switch and whitespace have different row shapes. For those, page through the JSON endpoints or build a lead list.

Authorizations

Authorization
string
header
required

API key in format tapi_live_[32-char] (live) or tapi_test_[32-char] (test)

Path Parameters

type
enum<string>
required

The signal type to export. Switch and whitespace have different row shapes and are not exportable.

Available options:
churn,
adoption
Example:

"adoption"

Query Parameters

technology_id
integer

Scope by BuiltWith technology id. Provide exactly one of technology_id, technology or category_id.

technology
string

Scope by exact technology name. The technology must be detectable.

category_id
integer

Scope by category — fans out to every detectable technology whose primary category is this one.

window
string
default:30

Look-back window in days. Clamped to 1–365.

limit
integer

Bounds both the delivered rows and the bill. Clamped to 10,000. Omit for a full export up to that cap.

Required range: x <= 10000
min_confidence
number<float>
default:0.5

Minimum detection_rate for a row to be exported.

include_first_seen
boolean
default:false

Adoption only. Disables the first-seen gate.

country
string

Filter to companies in this country (case-insensitive).

city
string

Filter to companies in this city (case-insensitive).

state
string

Filter to companies in this state or region (case-insensitive).

industry
string

Filter to companies in this industry (case-insensitive).

industry_code
integer

Filter by exact LinkedIn industry code.

employees
string

Filter by exact LinkedIn employee band. Unknown bands are rejected with INVALID_EMPLOYEE_BAND and the allowed list.

company_type
string

Filter by exact company type.

founded_min
integer

Only companies founded in or after this year.

Required range: 1800 <= x <= 2025
founded_max
integer

Only companies founded in or before this year.

Required range: 1800 <= x <= 2025
company
boolean

Set to true to attach the company card without filtering results (enrich-only mode).

has_email
boolean

Filter to domains where the crawler found (or did not find) an email address. false is a real filter, not a no-op.

has_phone
boolean

Filter to domains where the crawler found (or did not find) a phone number.

social
enum<string>

Filter to domains publishing a profile on this platform.

Available options:
linkedin,
x,
facebook,
instagram,
youtube,
github,
tiktok,
discord,
reddit,
crunchbase,
slack
language
string

Filter by the site's primary language.

web_country
string

Filter by the country the site declares in its schema.org markup. Accepts ISO-2, English name or common variants.

segment_id
string

Apply a saved audience instead of inline filters. Filter audiences replay their firmographic predicates; list audiences restrict rows to their member domains. Mutually exclusive with inline firmographic parameters.

Response

CSV file with a fixed 27-column header

The response is of type file.