GeoLead Search: Create

Use this API endpoint to create a GeoLead Search and build targeted lists of local businesses with verified emails in seconds.

Endpoint

POST

https://api.anymailfinder.com
/v5.1/geo-lead

Pricing

This endpoint is free to use.

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

Authentication

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

Code example

curl -X POST "https://api.anymailfinder.com/v5.1/geo-lead" \
  -H "Authorization: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "file_name": "restaurants_in_new_york",
    "find_company_emails": true,
    "find_decision_maker_categories": ["ceo"],
    "latitude": 40.7127753,
    "longitude": -74.0059728,
    "query": "restaurants",
    "radius_km": 1
  }'

Request parameters

Send as JSON in the POST body:

Parameter	Example value	Description
`file_name` string - optional	`null`	A label to identify the GeoLead search.
`find_company_emails` boolean	`true`	Whether to search for company emails.
`find_decision_maker_categories` string[]	[ "ceo" ]	Decision maker categories to search for. To disable Decision Maker search pass in an empty array.
`latitude` number	`40.7127753`	The latitude coordinate for the search center point.
`longitude` number	`-74.0059728`	The longitude coordinate for the search center point.
`query` string	`"restaurants"`	The search query to find businesses or locations within the specified radius.
`radius_km` integer	`10`	The search radius in km from the center point.
`result_limit` integer - optional	`null`	Optional limit on the number of leads to extract. If specified, the extraction will stop once this limit is reached.

Headers

Parameter	Example value	Description
`x-webhook-url` string - optional	`"https://yourdomain.com/webhook"`	URL to receive a webhook notification when processing completes.

Response

200OK

The search has been successfully created and will process asynchronously.

If you specified a webhook URL, you will receive a notification when the search is completed.
Otherwise, use the GeoLead Search Detail API endpoint to check the search status.

{
  "counts": {
    "failed": 0,
    "found_unknown": 0,
    "found_valid": 0,
    "not_found": 0,
    "total": 0
  },
  "created_at": "2025-01-08T13:25:36.457Z",
  "credits_needed": 0,
  "file_name": "string",
  "find_company_emails": true,
  "find_decision_maker_categories": [
    "ceo"
  ],
  "id": "string",
  "latitude": 40.7127753,
  "longitude": -74.0059728,
  "paid": false,
  "query": "restaurants",
  "radius_km": 2,
  "result_limit": null,
  "started_running_at": "2025-09-15T13:50:42.000Z",
  "status": "queued"
}

Property	Type	Description
`status`	string	The current status of the GeoLead search. Possible values: `extraction_queued`: The search for companies matching the specified criteria is queued and will start soon. `extraction_running`: The search for companies is in progress. `queued`: The search for emails of the found companies is queued and will start soon. `running`: The search for emails of the found companies is in progress. `paused`: The GeoLead search has been temporarily paused. `completed`: The GeoLead search has finished successfully. `failed`: The GeoLead search processing failed due to an error.
`counts.failed`	integer	Number of rows where the search failed.
`counts.found_unknown`	integer	Number of rows with risky emails found.
`counts.found_valid`	integer	Number of rows with valid emails found.
`counts.not_found`	integer	Number of rows where no email was found.
`counts.total`	integer	Total number of rows in the search.
`created_at`	string	The datetime when the search was created.
`credits_needed`	integer	The maximum credits required to download the results. Duplicate searches within a month are not charged.
`file_name`	string	The label provided to identify this GeoLead search.
`find_company_emails`	boolean	If company emails have been searched.
`find_decision_maker_categories`	string[]	The decision maker categories that have been searched.
`id`	string	Unique identifier for this GeoLead search.
`latitude`	number	The searched position latitude.
`longitude`	number	The searched position longitude.
`paid`	boolean	Indicates whether this search was paid for.
`query`	string	The searched type of companies (eg. "restaurants").
`radius_km`	integer	The searched position radius (in km).
`result_limit`	integer \| null	If a limit of result was set when the search was created.
`started_running_at`	string \| null	The datetime when the search started processing.

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.