Technology Lists

Start a technology list

Queues a full export of every website running one technology and returns straight away with a report_id. Generation takes minutes, so nothing useful could be returned synchronously. Poll GET /v1/tech-lookup/lists/{id} until status is ready, then follow download_url.

Costs 1 standard credit, flat, no matter how large the list. Asking for the same technology again inside the same billing period is free. One credit buys that technology for the period, so a nightly refresh costs one credit a month, not one a night.

This spends STANDARD credits, not the bulk-lookup credits the other endpoints use. GET /v1/me reports both balances.

Nothing is charged when the request is refused: an unknown technology, or a filter combination that matches no websites, both return an error with the wallet untouched.

Rate limit: 6 requests per minute, counted per API token. Going over returns 429 with error_code: rate_limited and a Retry-After header in seconds. A 429 costs no credits. Traffic is also subject to a higher shared ceiling per network address, applied before authentication.

post/v1/tech-lookup/lists

Request

  • Base URL: https://api.stackscan.com/api
  • URL: https://api.stackscan.com/api/v1/tech-lookup/lists
  • Auth: HTTP bearer and API key in header X-Tenant-Id

Request body

technologystring

Any one identifies the technology. techapi_id is exact and is what responses now return; stack_id keeps working for integrations written before the change; technology resolves by name the same way GET technologies/lookup does.

techapi_idstring
stack_idinteger
countryinteger[]

Filters, mirroring the dashboard's own filter set. Anything omitted means "no filter", which is the full list.

country_condition'include' | 'exclude'
tldstring[]
tld_condition'include' | 'exclude'
company_sizestring[]
only_with_company_infoboolean

Example request

{
  "technology": "Shopify"
}

Response

202: accepted, not done. The file does not exist yet.

successboolean required
report_idinteger required
status'ready' | 'queued' | 'failed' required
technologystring nullable required
techapi_idstring nullable required
credits_chargednumber required
credit_type'standard' required
reused_billing_periodboolean required

Free because already paid for this period, not free because it failed.

estimated_rowsinteger nullable required

Estimate. The final figure is result_count on the status endpoint.

status_urlstring required

Changes

No recorded changes to this operation across all 1 revision of this API.