> ## Documentation Index
> Fetch the complete documentation index at: https://docs.socq.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Traffic Estimate

> Estimate the Google search traffic of up to 1,000 domains at once.

# Traffic Estimate

Estimate the search traffic of many sites in one call. Send up to 1,000 domains and get, for each, the estimated monthly visits from organic results, the number of keywords it ranks for, and the same two figures for paid search. Use it to rank a list of prospects or partners by size, enrich a CRM, or compare a whole category of competitors at once.

```json theme={"dark"}
{
  "targets": [
    "notion.so",
    "figma.com",
    "canva.com"
  ],
  "location_code": 2840,
  "language_code": "en"
}
```

Provide up to 1000 domains in targets. Choose a supported country and a language available in that country; the defaults are United States (2840) and English (en). Each domain returns one row. Each request costs 3 credits plus 0.1 credits per domain.

## Standard Result Fields

Task results use the stable SocQ fields below. Source-specific field names and formats are normalized without inferring or enriching values that the source did not provide. To request a smaller field set, use `fields` for MCP queries, `_result_fields` for typed tools, or `--result-fields` in the CLI. Declared fields remain present when their value is `null`.

| Field | Type | Nullable | Description |
| - | - | - | - |
| `id` | `string` | Yes | The estimated domain, used as the identifier. |
| `platform` | `string` | No | Platform the result belongs to, such as `instagram` or `linkedin`. |
| `resource` | `string` | No | SocQ resource represented by the result, such as `videos` or `comments`. |
| `type` | `string` | No | Category of the result item, such as `video`, `post`, or `comment`. |
| `url` | `string` | Yes | Homepage URL of the domain. |
| `published_at` | `string` | Yes | Time the source item was published, in ISO 8601 format when available. |
| `collected_at` | `string` | No | Time SocQ collected or processed this result, in ISO 8601 format. |
| `domain` | `string` | Yes | Domain that was estimated. |
| `organic_traffic` | `number` | Yes | Estimated monthly visits from organic search results. |
| `organic_keywords_count` | `integer` | Yes | Number of keywords the domain ranks for organically. |
| `paid_traffic` | `number` | Yes | Estimated monthly visits from paid search ads. |
| `paid_keywords_count` | `integer` | Yes | Number of keywords the domain bids on in search ads. |

The following example shows the response format for a completed task. Actual data depends on your query.

## Completed Task Response

```json theme={"dark"}
{
  "code": 200,
  "data": {
    "task_id": "example-seo-traffic-estimate",
    "status": "succeeded",
    "public_id": "seo/traffic-estimate",
    "result_count": 3,
    "credits_amount": 3.3,
    "results": {
      "limit": 50,
      "next_cursor": null,
      "has_more": false,
      "schema_id": "traffic-estimate",
      "schema_version": "1.0",
      "items": [
        {
          "id": "figma.com",
          "platform": "seo",
          "resource": "traffic-estimate",
          "type": "traffic-estimate",
          "url": "https://figma.com",
          "published_at": null,
          "collected_at": "2026-11-17T15:30:19.383645Z",
          "domain": "figma.com",
          "organic_traffic": 1026703.1318624247,
          "organic_keywords_count": 167848,
          "paid_traffic": 38.05037307739258,
          "paid_keywords_count": 2
        },
        {
          "id": "notion.so",
          "platform": "seo",
          "resource": "traffic-estimate",
          "type": "traffic-estimate",
          "url": "https://notion.so",
          "published_at": null,
          "collected_at": "2026-11-17T15:30:19.384480Z",
          "domain": "notion.so",
          "organic_traffic": 13302.66677077845,
          "organic_keywords_count": 399,
          "paid_traffic": 0.0,
          "paid_keywords_count": 0
        },
        {
          "id": "canva.com",
          "platform": "seo",
          "resource": "traffic-estimate",
          "type": "traffic-estimate",
          "url": "https://canva.com",
          "published_at": null,
          "collected_at": "2026-11-17T15:30:19.384621Z",
          "domain": "canva.com",
          "organic_traffic": 22780312.5278251,
          "organic_keywords_count": 666024,
          "paid_traffic": 0.0,
          "paid_keywords_count": 0
        }
      ]
    }
  }
}
```


## OpenAPI

````yaml api-manual/agent-api/agent-api.json POST /v1/seo/traffic-estimate
openapi: 3.1.0
info:
  title: SocQ Agent API
  version: v1-87892a6484c2
  description: Asynchronous social data API generated from the SocQ Capability Registry.
servers:
  - url: https://api.socq.ai
security: []
paths:
  /v1/seo/traffic-estimate:
    post:
      tags:
        - seo
      summary: Traffic Estimate API
      description: Estimate the search traffic of many domains at once.
      operationId: socq_seo_traffic_estimate
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $schema: https://json-schema.org/draft/2020-12/schema
              type: object
              additionalProperties: false
              properties:
                callback_url:
                  type: string
                  format: uri
                language:
                  type: string
                  minLength: 1
                  enum:
                    - Albanian
                    - Arabic
                    - Armenian
                    - Azeri
                    - Bengali
                    - Bosnian
                    - Bulgarian
                    - Chinese (Simplified)
                    - Chinese (Traditional)
                    - Croatian
                    - Czech
                    - Danish
                    - Dutch
                    - English
                    - Estonian
                    - Finnish
                    - French
                    - German
                    - Greek
                    - Hebrew
                    - Hindi
                    - Hungarian
                    - Indonesian
                    - Italian
                    - Japanese
                    - Korean
                    - Latvian
                    - Lithuanian
                    - Macedonian
                    - Malay
                    - Norwegian (Bokmål)
                    - Polish
                    - Portuguese
                    - Romanian
                    - Russian
                    - Serbian
                    - Slovak
                    - Slovenian
                    - Spanish
                    - Swedish
                    - Tagalog
                    - Thai
                    - Turkish
                    - Ukrainian
                    - Urdu
                    - Vietnamese
                  description: Language name must be supported for the selected country.
                language_code:
                  type: string
                  minLength: 2
                  maxLength: 10
                  enum:
                    - ar
                    - az
                    - bg
                    - bn
                    - bs
                    - cs
                    - da
                    - de
                    - el
                    - en
                    - es
                    - et
                    - fi
                    - fr
                    - he
                    - hi
                    - hr
                    - hu
                    - hy
                    - id
                    - it
                    - ja
                    - ko
                    - lt
                    - lv
                    - mk
                    - ms
                    - nb
                    - nl
                    - pl
                    - pt
                    - ro
                    - ru
                    - sk
                    - sl
                    - sq
                    - sr
                    - sv
                    - th
                    - tl
                    - tr
                    - uk
                    - ur
                    - vi
                    - zh-CN
                    - zh-TW
                  default: en
                  description: >-
                    Language code must be supported for the selected country. A
                    globally supported language can still be unavailable in a
                    particular country.
                location_code:
                  type: integer
                  minimum: 1
                  description: >-
                    Supported country code for this SEO research endpoint.
                    Support differs from live SERP and Keyword Search Volume;
                    2156 is unavailable here.
                  enum:
                    - 2008
                    - 2012
                    - 2024
                    - 2031
                    - 2032
                    - 2036
                    - 2040
                    - 2048
                    - 2050
                    - 2051
                    - 2056
                    - 2068
                    - 2070
                    - 2076
                    - 2100
                    - 2104
                    - 2116
                    - 2120
                    - 2124
                    - 2144
                    - 2152
                    - 2158
                    - 2170
                    - 2188
                    - 2191
                    - 2196
                    - 2203
                    - 2208
                    - 2218
                    - 2222
                    - 2233
                    - 2246
                    - 2250
                    - 2276
                    - 2288
                    - 2300
                    - 2320
                    - 2344
                    - 2348
                    - 2356
                    - 2360
                    - 2372
                    - 2376
                    - 2380
                    - 2384
                    - 2392
                    - 2398
                    - 2400
                    - 2404
                    - 2410
                    - 2428
                    - 2440
                    - 2458
                    - 2470
                    - 2484
                    - 2492
                    - 2498
                    - 2504
                    - 2528
                    - 2554
                    - 2558
                    - 2566
                    - 2578
                    - 2586
                    - 2591
                    - 2600
                    - 2604
                    - 2608
                    - 2616
                    - 2620
                    - 2642
                    - 2682
                    - 2686
                    - 2688
                    - 2702
                    - 2703
                    - 2704
                    - 2705
                    - 2710
                    - 2724
                    - 2752
                    - 2756
                    - 2764
                    - 2784
                    - 2788
                    - 2792
                    - 2804
                    - 2807
                    - 2818
                    - 2826
                    - 2840
                    - 2854
                    - 2858
                    - 2862
                  default: 2840
                location_name:
                  type: string
                  minLength: 1
                  description: >-
                    Supported country name; use either location_code or
                    location_name.
                  enum:
                    - Albania
                    - Algeria
                    - Angola
                    - Argentina
                    - Armenia
                    - Australia
                    - Austria
                    - Azerbaijan
                    - Bahrain
                    - Bangladesh
                    - Belgium
                    - Bolivia
                    - Bosnia and Herzegovina
                    - Brazil
                    - Bulgaria
                    - Burkina Faso
                    - Cambodia
                    - Cameroon
                    - Canada
                    - Chile
                    - Colombia
                    - Costa Rica
                    - Cote d'Ivoire
                    - Croatia
                    - Cyprus
                    - Czechia
                    - Denmark
                    - Ecuador
                    - Egypt
                    - El Salvador
                    - Estonia
                    - Finland
                    - France
                    - Germany
                    - Ghana
                    - Greece
                    - Guatemala
                    - Hong Kong
                    - Hungary
                    - India
                    - Indonesia
                    - Ireland
                    - Israel
                    - Italy
                    - Japan
                    - Jordan
                    - Kazakhstan
                    - Kenya
                    - Latvia
                    - Lithuania
                    - Malaysia
                    - Malta
                    - Mexico
                    - Moldova
                    - Monaco
                    - Morocco
                    - Myanmar (Burma)
                    - Netherlands
                    - New Zealand
                    - Nicaragua
                    - Nigeria
                    - North Macedonia
                    - Norway
                    - Pakistan
                    - Panama
                    - Paraguay
                    - Peru
                    - Philippines
                    - Poland
                    - Portugal
                    - Romania
                    - Saudi Arabia
                    - Senegal
                    - Serbia
                    - Singapore
                    - Slovakia
                    - Slovenia
                    - South Africa
                    - South Korea
                    - Spain
                    - Sri Lanka
                    - Sweden
                    - Switzerland
                    - Taiwan
                    - Thailand
                    - Tunisia
                    - Turkiye
                    - Ukraine
                    - United Arab Emirates
                    - United Kingdom
                    - United States
                    - Uruguay
                    - Venezuela
                    - Vietnam
                targets:
                  type: array
                  items:
                    type: string
                    minLength: 1
                  minItems: 1
                  maxItems: 1000
                  description: Domains to estimate, up to 1000, such as example.com.
              required:
                - targets
              description: >-
                Provide up to 1000 domains in targets. Choose a supported
                country and a language available in that country; the defaults
                are United States (2840) and English (en). Each domain returns
                one row.
      responses:
        '200':
          description: Task accepted
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentSubmitResponse'
        '422':
          description: Input validation failed
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/AgentValidationErrorResponse'
      security:
        - bearerAuth: []
        - apiKeyAuth: []
components:
  schemas:
    AgentSubmitResponse:
      type: object
      properties:
        code:
          type: integer
          const: 200
        data:
          type: object
          properties:
            task_id:
              type: string
            status:
              type: string
            created_time:
              type:
                - string
                - 'null'
          required:
            - task_id
            - status
    AgentValidationErrorResponse:
      type: object
      properties:
        code:
          type: integer
          const: 422
        error:
          type: object
          properties:
            message:
              type: string
            type:
              type: string
            details:
              type: object
          required:
            - message
            - type
      required:
        - code
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
    apiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.