How to pull ranked keywords from AI Overviews
in
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.