Keyword To Lead - Count Building

Plan campaigns with confidence. Keyword-to-Lead Count returns the volume of resolvable hashed-email leads for any keyword batch in seconds, so media buyers and SDR leaders can validate audience size, refine keyword strategy, and forecast pipeline before committing to a full enrichment run. Ideal for testing competitor terms, evaluating long-tail keywords, and right-sizing ad spend.

How to Use

After subscribing, you will receive an API key to authenticate your requests. Send a POST request to the endpoint below with any combination of the input parameters. At least one identifier is required.

Input Parameters

• keywords (required) - List of keywords to search for.
• date_start (required) - Start date of the search period (YYYY-MM-DD).
• date_end (required) - End date of the search period (YYYY-MM-DD).
• lead_type (optional) - Type of leads to return. Accepted values: b2b, b2c.
• cities (optional) - Filter by city names.
• states (optional) - Filter by state abbreviations.
• zips (optional) - Filter by zip codes.
• callback_url (required) - The URL where the resolved result will be delivered via POST request.

Input Sample

curl -X POST https://vdfb5c2b01.execute-api.us-east-1.amazonaws.com/prod/resolve/keyword_to_lead/count  \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"keywords": ["b2b intent", "hvac services"],
"date_start": "2026-06-17",
"date_end": "2026-06-23",
"cities": ["Austin", "Dallas"],
"states": ["TX"],
"zips": ["73301", "75001"],
"lead_type": "b2b",
"callback_url": "https://webhook.site/your-id "
}'

Callback Response Sample

result.input

• keywords: "b2b intent", "hvac services"
• date_start: "2026-06-17"
• date_end: "2026-06-23"
• lead_type: "B2B"
• cities: "Austin", "Dallas"
• states: "TX"
• zips: "73301", "75001"

result.count

• emails_hashed: 142

result.leads

• email: "2886f652a2796429367e945ad9bd12d8"
• type: "md5"
• keyword: "hvac services"
• email: "9f3a1c8b2e4d7f6a0b5c3e9d2f1a8b4c"
• type: "md5"
• keyword: "b2b intent"