GeoLead Search: Download Results

Use this API endpoint to download the results of a previously completed GeoLead search. If this is the first time you're downloading the results, credits will be deducted based on the number of valid emails found and the type of search that was run.

Endpoint

GET

https://api.anymailfinder.com
/v5.1/geo-lead/{searchId}/download

Pricing

Credits are charged per row:

Only valid company emails found: 1 credit per row.
Only valid decision maker emails found: 2 credits per row.
Both valid company emails and decision maker emails found: 2 credits per row.
Risky or no emails found: Free.

Notes:

Duplicates already paid for within 30 days are free.
Credits are only charged the first time results are downloaded.

Authentication

Include your API key using the Authorization header.
Refer to the Authentication page for setup instructions.

Code example

curl -X GET "https://api.anymailfinder.com/v5.1/geo-lead/{searchId}/download?download_as=csv" \
  -H "Authorization: YOUR_API_KEY" \
  --output "./output.csv"

Request parameters

Path parameters

Parameter	Example value	Description
`searchId` string	`"blk_123a4b5c"`	The unique identifier of the GeoLead search.

Query parameters

Parameter	Example value	Description
`download_as` string - optional	`"xlsx"`	Specifies the output file format. Available values: `csv` (default) `json_arr` `json_obj` `xlsx`
`format` string - optional	`"default"`	Determines how the output file is formatted. Available values: `default`: Default formatting. `company-one-email-per-line`: For company searches, reformats results to have one email per row instead of grouping all emails in one row.
`file_name_column_name` string - optional	`"file_name"`	If specified, appends a column containing the file name to the downloaded file.

Response

200OK

GeoLead Search results will be downloaded as csv or xlsx format (as specified in the download_as query parameter).

400Bad Request

401Unauthorized

402Payment Needed

404Not Found

Need Help?

Our team is experienced with APIs and is here to help. Contact us via chat or email at team@anymailfinder.com.