# List Building ## OpenAPI Specification ```yaml openapi: 3.0.1 info: title: '' description: '' version: 1.0.0 paths: /resolve/keyword_to_lead: post: summary: List Building deprecated: false description: >-

The flagship Springbolt X endpoint. Submit any keyword set: product terms, competitor brands, problem statements, buying-stage phrases, and Springbolt X resolves them against a rolling 8-day window of real search activity, returning the actual people who searched. Unlike Bombora or G2 (account-level surges, monthly latency), Keyword-to-Lead delivers person-level intent within hours of the search itself, the highest-converting window in the entire buying cycle. Output is ready to push directly into Meta, Google, LinkedIn, and CTV custom audiences, into email and SMS sequences, or into your CRM as priority outbound calls.

operationId: resolveKeywordToLead tags: - 🔍 Keyword To Lead parameters: [] requestBody: content: application/json: schema: type: object properties: keywords: type: array items: type: string description: >- List of keywords or topics to search for leads. Minimum 2 characters per keyword. 2-character keywords are case-sensitive (ex: 14, 17, 1x, aa, AC, AI, dd, ED, HR, it, m3, m5, na, Q3, x1, x5, IT, 3D, 4K). Forbidden words: &, a, all, and, are, at, for, in, is, no, of, on, that, the, this, to, with. cities: type: array items: type: string description: List of cities to filter leads by location states: type: array items: type: string description: List of states to filter leads by location date_start: type: string description: >- Start date for the search range (format: YYYY-MM-DD). Not required if days_recency is provided date_end: type: string description: >- End date for the search range (format: YYYY-MM-DD). Not required if days_recency is provided limit: type: integer description: Maximum number of leads to return deanonymize: type: boolean description: >- When true, applies deanonymization to enrich the lead profiles callback_url: type: string description: >- URL to receive the results asynchronously when processing is complete lead_type: type: string enum: - b2b - b2c x-apidog-enum: - value: b2b name: '' description: '' - value: b2c name: '' description: '' description: 'Type of lead to return: b2b or b2c' zips: type: array items: type: string description: List of zip codes to filter leads by location days_recency: type: integer description: >- Number of days to look back from today. Accepted values: 1, 2, 3, 4, 5, 6, 7. When provided, date_start and date_end are automatically calculated and don't need to be included in the request. limit_by_keyword: type: array items: type: string required: - keywords - date_start - date_end x-apidog-orders: - keywords - date_start - date_end - days_recency - callback_url - lead_type - cities - states - zips - deanonymize - limit - limit_by_keyword examples: byOrganization: value: keywords: - b2b intent - hvac services date_start: '2026-06-17' date_end: '2026-06-23' days_recency: 7 callback_url: https://webhook.site/your-id lead_type: B2C cities: - los angeles states: - CA zips: - '90210' deanonymize: true limit: 10 limit_by_keyword: - keywords: b2b intent emails_hashed: 5 - keywords: hvac services emails_hashed: 5 summary: Request Example responses: '200': description: Domain resolved successfully content: application/json: schema: type: object properties: success: type: boolean message: type: string resolution: type: object properties: id: type: string status: type: string requested_at: type: string callback_url: type: string x-apidog-orders: - id - status - requested_at - callback_url payload: type: object properties: keywords: type: array items: type: string cities: type: array items: type: string states: type: array items: type: string date_start: type: string date_end: type: string limit: type: integer deanonymize: type: boolean callback_url: type: string lead_type: type: string zips: type: array items: type: string limit_by_keyword: type: string x-apidog-orders: - keywords - date_start - date_end - callback_url - lead_type - cities - states - zips - limit - limit_by_keyword - deanonymize x-apidog-orders: - success - message - resolution - payload example: success: true message: Resolution successfully completed! resolution: id: res_9a88Kadb5K4db8Kb434Kb4235c3b8bec status: completed requested_at: '2026-06-24T19:12:34.000Z' callback_url: https://webhook.site/your-id result: input: keywords: - b2b intent - hvac services date_start: '2026-06-17T00:00:00.000Z' date_end: '2026-06-23T00:00:00.000Z' lead_type: B2B cities: - Austin - Dallas states: - TX zips: - '73301' - '75001' deanonymize: true limit: 10 limit_by_keyword: null emails_hashed: - email: 4ec0111a5a73802a77c2ce403875e541 type: md5 keywords: - b2b intent last_searched_at: 06/24/2026, 3:13:17 PM - email: 0293c43e05336d98fad32feb08669711 type: md5 keywords: - hvac services last_searched_at: 06/24/2026, 3:13:38 PM leads: - name_first: Carlos name_last: Lamas linkedin_url: linkedin.com/in/carlos-lamas-61689854 email_work: email: clamas@hntb.com validity: valid email_personal: email: marklamas58@yahoo.com validity: valid email_alt: email: carlos.lamas@fiserv.com validity: likely emails_hashed: - email: 4ec0111a5a73802a77c2ce403875e541 type: md5 keywords: - b2b intent last_searched_at: '2026-06-24T19:13:17.000Z' phone: number: '+15126912299' line_type: mobile validity: valid phone_alt: number: '+15126912200' line_type: mobile validity: likely job_title: Marketing Manager job_seniority: Manager job_department: Marketing company: name: Acme Corp domain: acmecorp.com linkedin_url: linkedin.com/company/acmecorp industry: Software & Technology revenue: 10 Million To 50 Million employee_count: 51-200 Employees year_founded: 2005 address: street: 123 Main St zip_code: '75001' city: Dallas state: TX logo: https://example.com/logo.jpg about: >- Acme Corp is a leading provider of B2B marketing solutions. address: street: 456 Commerce St zip_code: '75201' city: Dallas state: Texas - name_first: Sarah name_last: Mitchell linkedin_url: linkedin.com/in/sarah-mitchell-82341 email_work: email: s.mitchell@hvacpros.com validity: likely email_personal: email: sarahmitchell91@gmail.com validity: valid email_alt: email: sarah.m@hvacservices.com validity: likely emails_hashed: - email: 0293c43e05336d98fad32feb08669711 type: md5 keywords: - hvac services last_searched_at: 06/24/2026, 3:13:38 PM phone: number: '+14695552847' line_type: mobile validity: valid phone_alt: number: '+14695558801' line_type: mobile validity: likely job_title: HVAC Services Director job_seniority: Director job_department: Operations company: name: HVAC Pros LLC domain: hvacpros.com linkedin_url: linkedin.com/company/hvac-pros industry: Facilities Services revenue: 1 Million To 10 Million employee_count: 11-50 Employees year_founded: 2012 address: street: 301 Industrial Blvd zip_code: '75001' city: Dallas state: TX logo: https://example.com/hvacpros-logo.jpg about: >- HVAC Pros LLC provides commercial and residential HVAC installation, maintenance, and repair services across the Dallas-Fort Worth metroplex. address: street: 789 Oak Ave zip_code: '78701' city: Austin state: Texas headers: {} x-apidog-name: '' security: [] x-apidog-folder: 🔍 Keyword To Lead x-apidog-status: released x-run-in-apidog: https://app.apidog.com/web/project/1235890/apis/api-31493660-run components: schemas: {} securitySchemes: bearerAuth: type: jwt scheme: bearer bearerFormat: JWT description: >- Organization JWT or API key from Core API. Send in header: Authorization: Bearer {token} sysAuth: type: apikey in: header name: x-sys-key description: >- System authentication key for internal endpoints. Only for inter-service calls. servers: - url: https://api.lead.springbolt.app description: Prod Env security: [] ```