Bulk Email Search: Create with File Upload

Use this API endpoint to create a Bulk Email Search by uploading a file (CSV or Excel). The system determines the type of email search to perform based on the fields you map.

Endpoint

POST

https://api.anymailfinder.com
/v5.0/bulk/multipart

Pricing

This endpoint is free to use.

Credits are only charged when you download the results for the first time.

Authentication

You must include your API key in the Authorization header to access this endpoint.
Refer to the Authentication page for details on how to authenticate your requests.

Request example

curl -X POST \
  'https://api.anymailfinder.com/v5.0/bulk/multipart' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -F 'file=@example.csv' \
  -F 'domain_field_index=0' \
  -F 'first_name_field_index=1' \
  -F 'last_name_field_index=2'

Request parameters

POST body parameters

Parameters should be sent as multipart/form-data in the POST Body.

Parameter	Example value	Description
`file` file	`"example.csv"`	A CSV or Excel file containing your data. The first row should contain headers.
`company_name_field_index` integer - optional	`null`	The zero-based index of the column containing the company name.
`decision_maker_category` string - optional	`null`	The category of the decision maker to search for. Possible values: ceo, engineering, finance, hr, it, logistics, marketing, operations, buyer, sales.
`domain_field_index` integer - optional	`0`	The zero-based index of the column containing the domain.
`file_name` string - optional	`null`	A label to identify the bulk search.
`first_name_field_index` integer - optional	`1`	The zero-based index of the column containing the first name.
`full_name_field_index` integer - optional	`null`	The zero-based index of the column containing the full name.
`last_name_field_index` integer - optional	`2`	The zero-based index of the column containing the last name.
`linkedin_url_field_index` integer - optional	`null`	The zero-based index of the column containing the LinkedIn URL.
`webhook_url` string - optional	`null`	URL to receive a webhook notification when processing completes.

Notes:

The type of email search performed depends on the fields you map:

Email Search by Name:
- map domain_field_index or company_name_field_index (domain_field_index is recommended for better accuracy).
- map full_name_field_index or first_name_field_index and last_name_field_index (full_name_field_index is recommended for better accuracy).
Email Search by Decision Maker:
- map domain_field_index or company_name_field_index (domain_field_index is recommended for better accuracy).
- specify a decision_maker_category.
Email Search by LinkedIn URL:
- map linkedin_url_field_index.
Email Search by Company:
- map domain_field_index or company_name_field_index (domain_field_index is recommended for better accuracy).

Response

200OK

400Bad Request

401Unauthorized

Need Help?

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