Site icon DataForSEO

How to pull ranked keywords from AI Overviews

To track or pull ranked keywords from AI Overviews, you can use the DataForSEO Labs Ranked Keywords endpoint. This endpoint provides a list of keywords for which any domain or page is ranking. It also retrieves SERP elements related to the ranked keywords, including AI Overviews.

You can customize the request to retrieve data only on keywords that you rank for in AI Overviews.

Step-by-step guide

1. Call the DataForSEO Labs Ranked Keywords endpoint:

POST https://api.dataforseo.com/v3/dataforseo_labs/google/ranked_keywords/live

2. In the target field, specify the target domain name or page URL.

3. Set the location using location_name, or location_code.

4. Define the language with the language_name or language_code field.

5. Specify the item_types parameter with ["ai_overview_reference"]. This ensures the response contains only keywords from AI Overviews.

Example: "item_types": ["ai_overview_reference"]

6. Optionally, limit the number of retrieved results with the limit parameter.

Request example:

[
  {
    "target": "medium.com",
    "language_name": "English",
    "location_name": "United States",
    "item_types": ["ai_overview_reference"],
    "limit": 2
  }
]

The response will return as follows:

{
  "version": "0.1.20250812",
  "status_code": 20000,
  "status_message": "Ok.",
  "time": "0.0651 sec.",
  "cost": 0.0102,
  "tasks_count": 1,
  "tasks_error": 0,
  "tasks": [
    {
      "id": "08181607-1535-0381-0000-b4f8ce69e326",
      "status_code": 20000,
      "status_message": "Ok.",
      "time": "0.0410 sec.",
      "cost": 0.0102,
      "result_count": 1,
      "path": [
        "v3",
        "dataforseo_labs",
        "google",
        "ranked_keywords",
        "live"
      ],
      "data": {
        "api": "dataforseo_labs",
        "function": "ranked_keywords",
        "se_type": "google",
        "target": "medium.com",
        "language_name": "English",
        "location_name": "United States",
        "item_types": [
          "ai_overview_reference"
        ],
        "limit": 2
      },
      "result": [
        {
          "se_type": "google",
          "target": "medium.com",
          "location_code": 2840,
          "language_code": "en",
          "total_count": 986598,
          "items_count": 2,
          "metrics": {
            "organic": null,
            "paid": null,
            "featured_snippet": null,
            "local_pack": null,
            "ai_overview_reference": {
              "pos_1": 59249,
              "pos_2_3": 134769,
              "pos_4_10": 326895,
              "pos_11_20": 296157,
              "pos_21_30": 118357,
              "pos_31_40": 37618,
              "pos_41_50": 10338,
              "pos_51_60": 2493,
              "pos_61_70": 530,
              "pos_71_80": 143,
              "pos_81_90": 36,
              "pos_91_100": 9,
              "etv": 22972498.799742892,
              "count": 986598,
              "estimated_paid_traffic_cost": 31158220.927724153,
              "is_new": 2,
              "is_up": 0,
              "is_down": 0,
              "is_lost": 0,
              "clickstream_etv": null,
              "clickstream_gender_distribution": null,
              "clickstream_age_distribution": null
            }
          },
          "metrics_absolute": null,
          "items": [
            {
              "se_type": "google",
              "keyword_data": {
                "se_type": "google",
                "keyword": "0 money",
                "location_code": 2840,
                "language_code": "en",
                "keyword_info": {
                  "se_type": "google",
                  "last_updated_time": "2025-07-17 14:06:36 +00:00",
                  "competition": null,
                  "competition_level": "LOW",
                  "cpc": null,
                  "search_volume": 50,
                  "low_top_of_page_bid": null,
                  "high_top_of_page_bid": null,
                  "categories": [
                    10012,
                    10094
                  ],
                  "monthly_searches": [
                    {
                      "year": 2025,
                      "month": 6,
                      "search_volume": 50
                    },
                    {
                      "year": 2025,
                      "month": 5,
                      "search_volume": 70
                    },
                    {
                      "year": 2025,
                      "month": 4,
                      "search_volume": 70
                    },
                    {
                      "year": 2025,
                      "month": 3,
                      "search_volume": 70
                    },
                    {
                      "year": 2025,
                      "month": 2,
                      "search_volume": 40
                    },
                    {
                      "year": 2025,
                      "month": 1,
                      "search_volume": 50
                    },
                    {
                      "year": 2024,
                      "month": 12,
                      "search_volume": 30
                    },
                    {
                      "year": 2024,
                      "month": 11,
                      "search_volume": 20
                    },
                    {
                      "year": 2024,
                      "month": 10,
                      "search_volume": 40
                    },
                    {
                      "year": 2024,
                      "month": 9,
                      "search_volume": 90
                    },
                    {
                      "year": 2024,
                      "month": 8,
                      "search_volume": 50
                    },
                    {
                      "year": 2024,
                      "month": 7,
                      "search_volume": 50
                    }
                  ],
                  "search_volume_trend": {
                    "monthly": -29,
                    "quarterly": -29,
                    "yearly": 67
                  }
                },
                "keyword_info_normalized_with_bing": null,
                "keyword_info_normalized_with_clickstream": null,
                "clickstream_keyword_info": null,
                "keyword_properties": {
                  "se_type": "google",
                  "core_keyword": null,
                  "synonym_clustering_algorithm": "text_processing",
                  "keyword_difficulty": 8,
                  "detected_language": "en",
                  "is_another_language": false
                },
                "serp_info": {
                  "se_type": "google",
                  "check_url": "https://www.google.com/search?q=0%20money&num=100&hl=en&gl=US&gws_rd=cr&ie=UTF-8&oe=UTF-8&glp=1&uule=w+CAIQIFISCQs2MuSEtepUEUK33kOSuTsc",
                  "serp_item_types": [
                    "ai_overview",
                    "images",
                    "people_also_ask",
                    "organic",
                    "related_searches"
                  ],
                  "se_results_count": 3750000000,
                  "last_updated_time": "2025-07-09 12:29:30 +00:00",
                  "previous_updated_time": "2025-05-26 19:40:00 +00:00"
                },
                "avg_backlinks_info": {
                  "se_type": "google",
                  "backlinks": 29.100000381469727,
                  "dofollow": 26,
                  "referring_pages": 28.299999237060547,
                  "referring_domains": 8.899999618530273,
                  "referring_main_domains": 7.599999904632568,
                  "rank": 56,
                  "main_domain_rank": 818.7999877929688,
                  "last_updated_time": "2025-07-09 12:29:31 +00:00"
                },
                "search_intent_info": {
                  "se_type": "google",
                  "main_intent": "informational",
                  "foreign_intent": null,
                  "last_updated_time": "2023-03-03 20:24:00 +00:00"
                }
              },
              "ranked_serp_element": {
                "se_type": "google",
                "serp_item": {
                  "se_type": "google",
                  "type": "ai_overview_reference",
                  "rank_group": 1,
                  "rank_absolute": 3,
                  "source": "Medium",
                  "domain": "medium.com",
                  "title": "The Value of Zero. Many people think of zero as a number… | by Jackie Ochola | The Andela Way",
                  "url": "https://medium.com/the-andela-way/the-value-of-zero-4581275b3b18",
                  "text": "Jul 2, 2019 — A zero bank account balance means that I have no money on my account. It also means that I do not owe any money to the ...",
                  "main_domain": "medium.com",
                  "relative_url": "/the-andela-way/the-value-of-zero-4581275b3b18",
                  "etv": 15.199999809265137,
                  "estimated_paid_traffic_cost": null,
                  "clickstream_etv": null,
                  "rank_changes": {
                    "previous_rank_absolute": null,
                    "is_new": false,
                    "is_up": false,
                    "is_down": false
                  },
                  "backlinks_info": null,
                  "rank_info": {
                    "page_rank": 0,
                    "main_domain_rank": 754
                  }
                },
                "check_url": "https://www.google.com/search?q=0%20money&num=100&hl=en&gl=US&gws_rd=cr&ie=UTF-8&oe=UTF-8&glp=1&uule=w+CAIQIFISCQs2MuSEtepUEUK33kOSuTsc",
                "serp_item_types": [
                  "ai_overview",
                  "images",
                  "people_also_ask",
                  "organic",
                  "related_searches"
                ],
                "se_results_count": 3750000000,
                "keyword_difficulty": 8,
                "is_lost": false,
                "last_updated_time": "2025-07-09 12:29:30 +00:00",
                "previous_updated_time": "2025-05-26 19:40:00 +00:00"
              }
            },
            {
              "se_type": "google",
              "keyword_data": {
                "se_type": "google",
                "keyword": "0 o'clock",
                "location_code": 2840,
                "language_code": "en",
                "keyword_info": {
                  "se_type": "google",
                  "last_updated_time": "2025-07-17 00:05:37 +00:00",
                  "competition": null,
                  "competition_level": "LOW",
                  "cpc": null,
                  "search_volume": 110,
                  "low_top_of_page_bid": null,
                  "high_top_of_page_bid": null,
                  "categories": [
                    10009,
                    10021,
                    10171,
                    10405,
                    10899,
                    11531
                  ],
                  "monthly_searches": [
                    {
                      "year": 2025,
                      "month": 6,
                      "search_volume": 170
                    },
                    {
                      "year": 2025,
                      "month": 5,
                      "search_volume": 170
                    },
                    {
                      "year": 2025,
                      "month": 4,
                      "search_volume": 140
                    },
                    {
                      "year": 2025,
                      "month": 3,
                      "search_volume": 170
                    },
                    {
                      "year": 2025,
                      "month": 2,
                      "search_volume": 110
                    },
                    {
                      "year": 2025,
                      "month": 1,
                      "search_volume": 90
                    },
                    {
                      "year": 2024,
                      "month": 12,
                      "search_volume": 110
                    },
                    {
                      "year": 2024,
                      "month": 11,
                      "search_volume": 90
                    },
                    {
                      "year": 2024,
                      "month": 10,
                      "search_volume": 90
                    },
                    {
                      "year": 2024,
                      "month": 9,
                      "search_volume": 90
                    },
                    {
                      "year": 2024,
                      "month": 8,
                      "search_volume": 90
                    },
                    {
                      "year": 2024,
                      "month": 7,
                      "search_volume": 110
                    }
                  ],
                  "search_volume_trend": {
                    "monthly": 0,
                    "quarterly": 21,
                    "yearly": 21
                  }
                },
                "keyword_info_normalized_with_bing": null,
                "keyword_info_normalized_with_clickstream": null,
                "clickstream_keyword_info": null,
                "keyword_properties": {
                  "se_type": "google",
                  "core_keyword": null,
                  "synonym_clustering_algorithm": "text_processing",
                  "keyword_difficulty": 15,
                  "detected_language": "en",
                  "is_another_language": false
                },
                "serp_info": {
                  "se_type": "google",
                  "check_url": "https://www.google.com/search?q=0%20o%27clock&num=100&hl=en&gl=US&gws_rd=cr&ie=UTF-8&oe=UTF-8&glp=1&uule=w+CAIQIFISCQs2MuSEtepUEUK33kOSuTsc",
                  "serp_item_types": [
                    "ai_overview",
                    "organic",
                    "people_also_ask",
                    "images",
                    "related_searches"
                  ],
                  "se_results_count": 63200000,
                  "last_updated_time": "2025-07-04 05:15:08 +00:00",
                  "previous_updated_time": "2025-05-19 22:52:10 +00:00"
                },
                "avg_backlinks_info": {
                  "se_type": "google",
                  "backlinks": 52.900001525878906,
                  "dofollow": 34.099998474121094,
                  "referring_pages": 37,
                  "referring_domains": 6.199999809265137,
                  "referring_main_domains": 6,
                  "rank": 90.5999984741211,
                  "main_domain_rank": 815.0999755859375,
                  "last_updated_time": "2025-07-04 05:15:08 +00:00"
                },
                "search_intent_info": {
                  "se_type": "google",
                  "main_intent": "informational",
                  "foreign_intent": null,
                  "last_updated_time": "2023-03-03 20:24:01 +00:00"
                }
              },
              "ranked_serp_element": {
                "se_type": "google",
                "serp_item": {
                  "se_type": "google",
                  "type": "ai_overview_reference",
                  "rank_group": 1,
                  "rank_absolute": 1,
                  "source": "Medium",
                  "domain": "medium.com",
                  "title": "The Problem With 12:00…. Twelve o'clock is both midnight and… |",
                  "url": "https://medium.com/@corbinhoffmann/the-problem-with-12-00-4dbe8a5cc7e4",
                  "text": "Dec 9, 2023 — The zero o'clock or 0:00 is actually 12:00. Now that's weird to think about, that the 12 represents a zero.",
                  "main_domain": "medium.com",
                  "relative_url": "/@corbinhoffmann/the-problem-with-12-00-4dbe8a5cc7e4",
                  "etv": 33.439998626708984,
                  "estimated_paid_traffic_cost": null,
                  "clickstream_etv": null,
                  "rank_changes": {
                    "previous_rank_absolute": null,
                    "is_new": false,
                    "is_up": false,
                    "is_down": false
                  },
                  "backlinks_info": null,
                  "rank_info": {
                    "page_rank": 0,
                    "main_domain_rank": 754
                  }
                },
                "check_url": "https://www.google.com/search?q=0%20o%27clock&num=100&hl=en&gl=US&gws_rd=cr&ie=UTF-8&oe=UTF-8&glp=1&uule=w+CAIQIFISCQs2MuSEtepUEUK33kOSuTsc",
                "serp_item_types": [
                  "ai_overview",
                  "organic",
                  "people_also_ask",
                  "images",
                  "related_searches"
                ],
                "se_results_count": 63200000,
                "keyword_difficulty": 15,
                "is_lost": false,
                "last_updated_time": "2025-07-04 05:15:08 +00:00",
                "previous_updated_time": "2025-05-19 22:52:10 +00:00"
              }
            }
          ]
        }
      ]
    }
  ]
}

In the response, the metrics object contains an ai_overview_reference object with aggregated ranking data for all keywords where your target website appears in AI Overviews. It includes estimated traffic volume and the number of AI Overviews where the website ranks in specific positions. Additionally, in the items array, you can explore detailed ranking and traffic data for each keyword, including individual AI Overview SERP elements.

That’s it! Using the Ranked Keywords endpoint, you can track keywords that you rank for in AI Overviews with little to no effort.

Exit mobile version