---
title: "Create a new GeoLead search based on geographic coordinates and search query."
method: POST
path: "/v5.1/geo-lead"
tags: ["geo-lead"]
---

# Create a new GeoLead search based on geographic coordinates and search query.

`POST /v5.1/geo-lead`

## Request

- Base URL: `https://api.anymailfinder.com`
- URL: `https://api.anymailfinder.com/v5.1/geo-lead`
- Auth: API key in header `Authorization`

Creates a bulk search that will generate leads from a specific geographic area. The search will find businesses or locations matching the provided query within the specified radius from the given coordinates. This is useful for location-based lead generation and market research.

## Headers

- `x-webhook-url` string

## Request body

- Api51GeoLeadCreateBodyDto
  - `file_name` string: A label to identify the geo lead search.
  - `find_company_emails` boolean, required: Whether to search for company emails. If false, only decision maker emails will be searched. Defaults to true.
  - `find_decision_maker_categories` string[], required: Decision maker categories to search for. If not provided, defaults to ["ceo"]. If empty array [], no decision maker search will be performed. Valid categories: "ceo", "engineering", "finance", "hr", "it", "logistics", "marketing", "operations", "buyer", "sales".
  - `latitude` number, required: The latitude coordinate for the search center point.
  - `longitude` number, required: The longitude coordinate for the search center point.
  - `query` string, required: The search query to find businesses or locations within the specified radius.
  - `radius_km` number, required: The search radius in km from the center point.
  - `result_limit` number, nullable: Optional limit on the number of leads to extract. If specified, the extraction will stop once this limit is reached.

## Response `200`

Created.

- Api5GeoLeadDto
  - `status` 'on_deck' | 'queued' | 'running' | 'paused' | 'completed' | 'deleted' | 'extraction_queued' | 'extraction_running', required: The current status of the GeoLead search:<br /> - "extraction_queued": The search for companies matching the specified criteria is queued and will start soon.<br /> - "extraction_running": The search for companies is in progress.<br /> - "queued": The search for emails of the found companies is queued and will start soon.<br /> - "running": The search for emails of the found companies is in progress.<br /> - "paused": The GeoLead search has been temporarily paused.<br /> - "completed": The GeoLead search has finished successfully.<br /> - "failed": The GeoLead search has failed. This indicates that an error occurred during processing and the operation could not complete.
  - `counts` object, required
    - `failed` number, required
    - `found_unknown` number, required
    - `found_valid` number, required
    - `not_found` number, required
    - `total` number, required
  - `created_at` string, date-time, required
  - `credits_needed` number, required
  - `file_name` string, required
  - `find_company_emails` boolean, required
  - `find_decision_maker_categories` string[], required
  - `id` string, required
  - `latitude` number, required
  - `longitude` number, required
  - `paid` boolean, required
  - `query` string, required
  - `radius_km` number, required
  - `result_limit` number, nullable
  - `started_running_at` string, date-time, nullable, required

## Other responses

- `400`: Bad Request
- `401`: Unauthorized

---

[API](https://skmtc.dev/anymailfinder/apis/anymail-finder-api.md) · [All operations](https://skmtc.dev/anymailfinder/apis/anymail-finder-api/llms.txt) · [OpenAPI document](https://skmtc.dev/anymailfinder/apis/anymail-finder-api/revisions/cd6d62ec7603?raw)