GET /v1/companies

Companies currently running a technology, each row carrying its whole detected stack.

Available for technologies we have validated for list use. Others return 422 with the reason — never an empty array, which would read as "nobody uses this".

Parameters

technology required, comma-separated

Counts against your plan's technology quota.

not_technology comma-separated

Exclude companies running these. Absence queries are only sound on complete observation.

employee_range comma-separated

e.g. 11-50, 51-200, 201-500

country comma-separated

Lowercase country names, e.g. united states

industry comma-separated

Normalised industry labels

max_rank integer

CrUX rank ceiling. Lower is more trafficked.

has_phone / has_linkedin boolean

Restrict to rows with that field present. Check the fill rate first.

limit / cursor integer / string

Up to 1000 per page. Cursor pagination, never offset.

Example

curl "https://www.ansafi.com/api/v1/companies?technology=Klaviyo\
&not_technology=Recharge&employee_range=51-200&country=united%20states" \
  -H "Authorization: Bearer $ANSAFI_KEY"

Response

{
  "data": [{
    "domain": "example.com",
    "company_name": "Example Inc",
    "employee_range": "51-200",
    "industry": "consumer goods",
    "country": "united states",
    "crux_rank": 100000,
    "phone": "1-800-555-0100",
    "linkedin_url": "https://linkedin.com/company/example",
    "tech_count": 39,
    "technologies": [{ "t": "Klaviyo", "c": "Marketing automation", "v": null },
                     { "t": "Shopify", "c": "Ecommerce", "v": null }]
  }],
  "meta": {
    "source": { "dataset": "HTTP Archive", "method": "monthly crawl, rendered page",
                "publisher": "Internet Archive", "history_since": "2011" },
    "field_fill_rates": { "phone": 3.94, "linkedin_url": 3.52, "description": 50.66 },
    "scope": "CrUX rank <= 1,000,000"
  },
  "next_cursor": "ZXhhbXBsZS5jb20"
}

technologies is the differentiated field. A competitor tells you the prospect uses the technology you filtered on; this is everything we detected on them.