Post apidownload csv
Initiate an asynchronous lead export.
Prerequisites: Authenticated. Sufficient credits (1 per lead).
Credits are deducted immediately. The response contains a search_id — use it to poll /api/download-status/{search_id}/ until the file is ready.
Authorizations
API key. Format: Token
Query Parameters
Category ID to filter.
Country alpha-2 codes to export.
Output format: 'excel' (default), 'csv', or 'xlsx'.
csv, excel, xlsx Set to 'true' to append coordinates, rating, review count, claimed status, opening hours, and business status to the export. Defaults to 'false'.
false, true Set to 'true' to include permanently closed businesses in the search and export. Defaults to 'false'.
false, true Response
'processing' on success, 'error' on failure.
Machine-readable status code: 'processing_started', 'no_leads_found', 'insufficient_credits'.
ID to poll download status. Only present when status='processing'.
Number of leads being exported (= credits deducted). Present on success and no_leads_found.