Get apicompanies
Search for business leads matching the given filters and return a preview.
Prerequisites: Authenticated with a valid JWT.
The response includes totalCount which tells you how many credits an export will cost. Use this endpoint to refine filters before calling /api/download-csv/.
Authorizations
API key. Format: Token
Query Parameters
Filter by category ID (from GET /api/categories/).
Filter by country alpha-2 codes (e.g. 'FR', 'AU'). Repeat for multiple.
Set to 'true' to include permanently closed businesses in the preview count. Defaults to 'false'.
false, true Filter by level-2 location codes (states/departments).
Response
Paginated list of matching companies (preview only, no full contact data).
Total number of leads matching the filters. Use this to estimate credit cost before exporting.
Distinct cities in the result set.
Distinct zip/postal codes in the result set.
Categories represented in the result set.