#  Count Building

## OpenAPI Specification

```yaml
openapi: 3.0.1
info:
  title: ''
  description: ''
  version: 1.0.0
paths:
  /resolve/keyword_to_lead/count:
    post:
      summary: ' Count Building'
      deprecated: false
      description: >-
        <p style="margin: 0 0 24px 0; font-size:16px; color:#888;">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.</p>
      operationId: resolveKeywordToLead
      tags:
        - 🔍  Keyword To Lead
        - Resolve
      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
                cities:
                  type: array
                  items:
                    type: string
                  description: A single city name to filter leads by location
                states:
                  type: array
                  items:
                    type: string
                    description: A single US state code (e.g. CA, TX, FL)
                  description: List of US 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
                callback_url:
                  type: string
                  description: >-
                    URL to receive the results asynchronously when processing is
                    complete
                lead_type:
                  type: string
                  description: 'Type of lead to return. Accepted values: b2b or b2c'
                zips:
                  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.
              required:
                - keywords
                - date_start
                - date_end
              x-apidog-orders:
                - keywords
                - date_start
                - date_end
                - days_recency
                - callback_url
                - cities
                - states
                - zips
                - lead_type
            examples:
              byOrganization:
                value:
                  keywords:
                    - b2b intent
                    - hvac services
                  cities:
                    - Austin
                    - Dallas
                  states:
                    - TX
                  zips:
                    - '73301'
                    - '75001'
                  lead_type: b2b
                  date_start: '2026-06-18'
                  date_end: '2026-06-25'
                  callback_url: https://your-webhook-url.com/callback
                summary: By organization name
      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
                    required:
                      - id
                      - status
                      - requested_at
                      - callback_url
                    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
                    required:
                      - keywords
                      - cities
                      - states
                      - date_start
                      - date_end
                      - limit
                      - deanonymize
                      - callback_url
                    x-apidog-orders:
                      - keywords
                      - cities
                      - states
                      - date_start
                      - date_end
                      - limit
                      - deanonymize
                      - callback_url
                x-apidog-orders:
                  - success
                  - message
                  - resolution
                  - payload
              example:
                success: true
                message: Resolution successfully completed!
                resolution:
                  id: res_a12fY536bY4860Y8d52Y8e822afdf503
                  status: completed
                  requested_at: '2026-06-22T18:00:35.440Z'
                  callback_url: https://your-webhook-url.com/callback
                result:
                  input:
                    keywords:
                      - b2b intent
                      - hvac services
                    date_start: '2026-06-17T00:00:00.000Z'
                    date_end: '2026-06-22T00:00:00.000Z'
                    lead_type: B2B
                    cities:
                      - Austin
                      - Dallas
                    states:
                      - TX
                    zips:
                      - '73301'
                      - '75001'
                    deanonymize: false
                  count:
                    emails_hashed: 97
                    by_keyword:
                      - keyword: b2b intent
                        emails_hashed: 35
                      - keyword: hvac services
                        emails_hashed: 62
          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-33427679-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: []

```