companies

Query and export companies with rich filtering. Filter by industry, headcount, location, tags, custom_attrs, or external

get/api/v1/companies

Request

  • Base URL: https://crispy.sh
  • URL: https://crispy.sh/api/v1/companies
  • Auth: HTTP bearer

Query parameters

list_idstring

Scope to a company list (kind='companies') by list ID.

industrystring[]

Filter by industry tags (TEXT[] containment — all must match).

headcount_minnumber

Minimum employee count (inclusive).

headcount_maxnumber

Maximum employee count (inclusive).

locationstring

ilike filter on headquarters city or country (e.g. 'London' or 'UK').

has_employees_in_my_networkboolean

true = only companies with at least one contact linked via company_id in your account.

custom_attrsobject

JSONB containment filter on custom_attrs (e.g. {tier: 'A'}).

external_ids_matchobject

JSONB containment filter on external_ids (e.g. {hubspot_company_id: 'hs-123'}).

tagsstring[]

Any-match filter on tags (OR).

format'json' | 'csv'

Response format (default json).

limitnumber

Results per page (default 100, max 1000).

cursorstring

Pagination cursor from previous response.

Response

Success

Changes

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