Bulk Email Search: Download Results
Use this API endpoint to download the results of a previously completed Bulk Email 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
https://api.anymailfinder.com
/v5.1/bulk/{searchId}/downloadPricing
The cost of downloading results is based on the type of search and the verification level of the emails. Credits are charged per row as follows:
- 1 Credit per Row:
- For Person searches with valid emails.
- For Company searches, regardless of the number of verified emails returned (up to 20 emails per company).
- For LinkedIn URL searches with valid emails.
- 2 Credits per Row:
- For Decision Maker searches with valid emails.
- Free:
- If no emails are found.
- If all emails are classified as risky.
- For duplicate searches performed within the last month.
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/bulk/{searchId}/download?download_as=csv" \-H "Authorization: YOUR_API_KEY" \--output "./output.csv"
Request parameters
Path parameters
| Parameter | Example value | Description |
|---|---|---|
searchIdstring | "blk_123a4b5c" | The unique identifier of the bulk search. |
Query parameters
| Parameter | Example value | Description |
|---|---|---|
download_asstring - optional | "xlsx" | Specifies the output file format. Available values:
|
formatstring - optional | "default" | Determines how the output file is formatted. Available values:
|
file_name_column_namestring - optional | "file_name" | If specified, appends a column containing the file name to the downloaded file. |
preview_onlystring - optional | "true" | When true, downloads a preview version of the results without charging credits. Preview files exclude all paid information (such as emails or other data depending on the bulk search type). Defaults to false. |
Response
200OK
Bulk Email Search results will be downloaded as csv or xlsx format (as specified in the download_as query parameter).
400Bad Request
The request is missing required data or is improperly formatted.
Review the message field to identify and correct the issue.
{"error": "bad_request","message": "..."}
401Unauthorized
The request did not include a valid API key.
Refer to the Authentication page to ensure your API key is properly included.
{"error": "unauthorized","message": "Missing or invalid API key."}
402Payment Needed
Your account does not have enough credits to complete this request.
You can purchase additional credits to continue.
{"error": "upgrade_needed","message": "Your account does not have enough credits. Purchase more at https://app.anymailfinder.com/purchase."}
404Not Found
This error indicates that the bulk search was not found.
Ensure the searchId provided in the URL is correct.
{"error": "not_found","message": "The requested resource could not be found."}
Need Help?
Our team is experienced with APIs and is here to help.
Chat with us.