> ## Documentation Index
> Fetch the complete documentation index at: https://similarweb-zp8zf.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Keyword Research

> Returns the keywords driving search clicks for a specified domain.



## OpenAPI

````yaml keywords-api.json get /keywords
openapi: 3.1.0
info:
  title: keywords30
  version: '4.0'
servers:
  - url: https://api.similarweb.com/v4/website-analysis/
security:
  - {}
paths:
  /keywords:
    get:
      summary: Website Keywords
      description: Returns the keywords driving search clicks for a specified domain.
      operationId: website-analysis-keywords
      parameters:
        - name: api_key
          in: query
          description: Your Similarweb API key.
          required: true
          schema:
            type: string
            default: Add_Your_API_KEY
        - name: URL
          in: query
          description: Enter a domain of interest, without 'www.' or brackets {}.
          required: true
          schema:
            type: string
            default: cnn.com
        - name: start_date
          in: query
          description: 'Start month (format: YYYY-MM)'
          schema:
            type: string
            default: 2023-03
        - name: end_date
          in: query
          description: 'End month (format: YYYY-MM)'
          schema:
            type: string
            default: 2023-03
        - name: country
          in: query
          description: >-
            Country filter, as a 2-letter ISO country code, or "world" for
            worldwide. To see the country filters you have access to, please
            refer to the Check Capabilities endpoint.
          required: true
          schema:
            type: string
            default: us
        - name: traffic_source
          in: query
          description: >-
            [optional] Set the traffic source type. Possible values: Organic,
            Paid, or All.
          schema:
            type: string
            default: All
        - name: web_source
          in: query
          description: >-
            [optional] Select the web source. Possible values: Desktop,
            MobileWeb, or Total.
          schema:
            type: string
            default: Total
        - name: branded_type
          in: query
          description: >-
            [optional]: Select the branded type. Possible values: Branded,
            NonBranded, or All.
          schema:
            type: string
            default: All
        - name: limit
          in: query
          description: >-
            [optional] Select the number of results that are returned. Default:
            100.
          schema:
            type: string
            default: '100'
        - name: offset
          in: query
          description: '[optional] Specify an offset from where to start returning data.'
          schema:
            type: string
      responses:
        '200':
          description: '200'
          content:
            application/json:
              examples:
                VIEW EXAMPLE RESPONSE:
                  value: |-
                    {
                      "keywords": [
                        {
                          "keyword": "cnn",
                          "clicks": 6527609,
                          "traffic_share": 0.20739891001023394,
                          "difficulty": 95,
                          "competition": null,
                          "primary_intent": "Navigational",
                          "secondary_intent": null,
                          "volume": 7670020,
                          "cpc": 1.42,
                          "cpc_low_bid": 0.01,
                          "cpc_high_bid": 0.27,
                          "zero_clicks_share": 0.1498,
                          "position": 1,
                          "serp_features": [
                            "news",
                            "video",
                            "organic",
                            "organic_sitelinks",
                            "organic_expanded_sitelinks",
                            "related_questions"
                          ],
                          "top_url": "cnn.com"
                        },
                        {
                          "keyword": "weather",
                          "clicks": 1136378,
                          "traffic_share": 0.03610564887688733,
                          "difficulty": 99,
                          "competition": 1,
                          "primary_intent": "Navigational",
                          "secondary_intent": null,
                          "volume": 111557650,
                          "cpc": 0.62,
                          "cpc_low_bid": 0.03,
                          "cpc_high_bid": 0.53,
                          "zero_clicks_share": 0.8304,
                          "position": 2,
                          "serp_features": [
                            "news",
                            "video",
                            "organic",
                            "organic_sitelinks",
                            "organic_expanded_sitelinks",
                            "related_questions",
                            "organic_inline_sitelinks"
                          ],
                          "top_url": "cnn.com/weather"
                        },
                        {
                          "keyword": "trump",
                          "clicks": 750832,
                          "traffic_share": 0.023855861832533777,
                          "difficulty": 99,
                          "competition": null,
                          "primary_intent": "Informational",
                          "secondary_intent": null,
                          "volume": 18826790,
                          "cpc": 0,
                          "cpc_low_bid": 0,
                          "cpc_high_bid": 0,
                          "zero_clicks_share": 0.6185,
                          "position": 1,
                          "serp_features": [
                            "news",
                            "video",
                            "organic"
                          ],
                          "top_url": "amp.cnn.com/cnn/2023/03/18/politics/donald-trump-manhattan-da-arrest-protests/index.html"
                        },
                        {
                          "keyword": "nashville shooting",
                          "clicks": 515556,
                          "traffic_share": 0.01638053879287748,
                          "difficulty": null,
                          "competition": null,
                          "primary_intent": "Informational",
                          "secondary_intent": "Navigational",
                          "volume": 11347940,
                          "cpc": 0,
                          "cpc_low_bid": 0,
                          "cpc_high_bid": 0,
                          "zero_clicks_share": 0.4053,
                          "position": 2,
                          "serp_features": [
                            "news",
                            "organic"
                          ],
                          "top_url": "amp.cnn.com/cnn/2023/03/29/us/covenant-school-shooting-nashville-tennessee-wednesday/index.html"
                        },
                        {
                          "keyword": "cnn news",
                          "clicks": 490768,
                          "traffic_share": 0.015592960342432044,
                          "difficulty": 95,
                          "competition": null,
                          "primary_intent": "Navigational",
                          "secondary_intent": null,
                          "volume": 571720,
                          "cpc": 0.65,
                          "cpc_low_bid": 0.03,
                          "cpc_high_bid": 1.87,
                          "zero_clicks_share": 0.1431,
                          "position": 1,
                          "serp_features": [
                            "news",
                            "video",
                            "organic",
                            "organic_sitelinks",
                            "organic_expanded_sitelinks",
                            "organic_inline_sitelinks"
                          ],
                          "top_url": "cnn.com"
                        },
                        {
                          "keyword": "alex murdaugh",
                          "clicks": 432002,
                          "traffic_share": 0.013725813528696508,
                          "difficulty": 19,
                          "competition": null,
                          "primary_intent": "Informational",
                          "secondary_intent": null,
                          "volume": 4818190,
                          "cpc": 0.17,
                          "cpc_low_bid": 0.01,
                          "cpc_high_bid": 3.25,
                          "zero_clicks_share": 0.5657,
                          "position": 1,
                          "serp_features": [
                            "news",
                            "video",
                            "organic",
                            "related_questions",
                            "organic_inline_sitelinks"
                          ],
                          "top_url": "amp.cnn.com/cnn/2023/03/03/us/alex-murdaugh-sentencing-friday/index.html"
                        },
                        {
                          "keyword": "ukraine news",
                          "clicks": 337799,
                          "traffic_share": 0.010732742172906958,
                          "difficulty": 98,
                          "competition": 3,
                          "primary_intent": "Informational",
                          "secondary_intent": null,
                          "volume": 1786460,
                          "cpc": 1.49,
                          "cpc_low_bid": 1.51,
                          "cpc_high_bid": 3.04,
                          "zero_clicks_share": 0.4331,
                          "position": 1,
                          "serp_features": [
                            "news",
                            "video",
                            "organic",
                            "organic_sitelinks",
                            "organic_expanded_sitelinks",
                            "related_questions",
                            "organic_inline_sitelinks"
                          ],
                          "top_url": "cnn.com/europe/live-news/russia-ukraine-war-news-03-21-23/index.html"
                        },
                        {
                          "keyword": "chatgpt",
                          "clicks": 299962,
                          "traffic_share": 0.009530563464277624,
                          "difficulty": 80,
                          "competition": 3,
                          "primary_intent": "Navigational",
                          "secondary_intent": null,
                          "volume": 15088000,
                          "cpc": 0.78,
                          "cpc_low_bid": 0.34,
                          "cpc_high_bid": 0.91,
                          "zero_clicks_share": 0.1854,
                          "position": 2,
                          "serp_features": [
                            "news",
                            "video",
                            "organic",
                            "organic_sitelinks",
                            "organic_expanded_sitelinks",
                            "related_questions"
                          ],
                          "top_url": "amp.cnn.com/cnn/2023/03/21/tech/google-bard/index.html"
                        },
                        {
                          "keyword": "trump arrested",
                          "clicks": 298307,
                          "traffic_share": 0.009477979861910058,
                          "difficulty": null,
                          "competition": null,
                          "primary_intent": "Informational",
                          "secondary_intent": null,
                          "volume": 1970240,
                          "cpc": 0,
                          "cpc_low_bid": 0,
                          "cpc_high_bid": 0,
                          "zero_clicks_share": 0.6764,
                          "position": 4,
                          "serp_features": [
                            "news",
                            "video",
                            "organic"
                          ],
                          "top_url": "amp.cnn.com/cnn/2023/03/18/politics/donald-trump-manhattan-da-arrest-protests/index.html"
                        },
                        {
                          "keyword": "ukraine",
                          "clicks": 281471,
                          "traffic_share": 0.008943056883384185,
                          "difficulty": 94,
                          "competition": 1,
                          "primary_intent": "Informational",
                          "secondary_intent": null,
                          "volume": 5042320,
                          "cpc": 1.67,
                          "cpc_low_bid": 1.17,
                          "cpc_high_bid": 3.08,
                          "zero_clicks_share": 0.6196,
                          "position": 1,
                          "serp_features": [
                            "news",
                            "video",
                            "organic",
                            "twitter",
                            "related_questions",
                            "organic_inline_sitelinks"
                          ],
                          "top_url": "amp.cnn.com/cnn/europe/live-news/russia-ukraine-war-news-03-06-23/index.html"
                        }
                      ],
                      "keywords_count": 478711,
                      "meta": {
                        "query": {
                          "limit": 10,
                          "offset": 0,
                          "asc": null,
                          "sort": null
                        },
                        "request": {
                          "traffic_source": "All",
                          "branded_type": "All",
                          "web_source": "MobileWeb",
                          "page_search_type": "Domain",
                          "domain": "cnn.com",
                          "format": "json",
                          "start_date": "2023-03-01",
                          "end_date": "2023-03-31",
                          "country": "us"
                        },
                        "status": "Success",
                        "last_updated": "2024-09-30"
                      }
                    }
              schema:
                type: object
                properties:
                  keywords:
                    type: array
                    items:
                      type: object
                      properties:
                        keyword:
                          type: string
                          example: cnn
                        clicks:
                          type: integer
                          example: 6527609
                          default: 0
                        traffic_share:
                          type: number
                          example: 0.20739891001023394
                          default: 0
                        difficulty:
                          type: integer
                          example: 95
                          default: 0
                        competition: {}
                        primary_intent:
                          type: string
                          example: Navigational
                        secondary_intent: {}
                        volume:
                          type: integer
                          example: 7670020
                          default: 0
                        cpc:
                          type: number
                          example: 1.42
                          default: 0
                        cpc_low_bid:
                          type: number
                          example: 0.01
                          default: 0
                        cpc_high_bid:
                          type: number
                          example: 0.27
                          default: 0
                        zero_clicks_share:
                          type: number
                          example: 0.1498
                          default: 0
                        position:
                          type: integer
                          example: 1
                          default: 0
                        serp_features:
                          type: array
                          items:
                            type: string
                            example: news
                        top_url:
                          type: string
                          example: cnn.com
                  keywords_count:
                    type: integer
                    example: 478711
                    default: 0
                  meta:
                    type: object
                    properties:
                      query:
                        type: object
                        properties:
                          limit:
                            type: integer
                            example: 10
                            default: 0
                          offset:
                            type: integer
                            example: 0
                            default: 0
                          asc: {}
                          sort: {}
                      request:
                        type: object
                        properties:
                          traffic_source:
                            type: string
                            example: All
                          branded_type:
                            type: string
                            example: All
                          web_source:
                            type: string
                            example: MobileWeb
                          page_search_type:
                            type: string
                            example: Domain
                          domain:
                            type: string
                            example: cnn.com
                          format:
                            type: string
                            example: json
                          start_date:
                            type: string
                            example: '2023-03-01'
                          end_date:
                            type: string
                            example: '2023-03-31'
                          country:
                            type: string
                            example: us
                      status:
                        type: string
                        example: Success
                      last_updated:
                        type: string
                        example: '2024-09-30'
      deprecated: false

````