One of the ways to determine whether keywords are relevant to your SEO strategy is to analyze the keyword data, which includes core metrics and keyword specifications. But how can you get quality keyword data in bulk? You can do this effortlessly with the new Keyword Overview and Historical Keyword Data endpoints of the DataForSEO Labs API.
These endpoints replace the DataForSEO Labs Historical Search Volume endpoint, offering you better flexibility in fetching keyword data:
1. The Keyword Overview endpoint provides actual keyword data for up to 700 keywords in a single request. For each keyword specified, you will receive current cost-per-click, competition values for paid search, search volume, monthly searches, as well as backlink information. What distinguishes this endpoint from the Historical Search Volume endpoint is that it also provides search intent data for specified keywords. Besides, you can get SERP and clickstream data for keywords by specifying include_serp_info and include_clickstream_data parameters.
2. The Historical Keyword Data endpoint retrieves only historical data for keywords. Like in the Keyword Overview endpoint, you can specify up to 700 keywords in one request. You will receive historical Google keyword data for each keyword since the beginning of 2019. The data for each keyword in the response includes historical search volume, cost-per-click, competition values for paid search, monthly searches, and search volume trends.
The main advantage of using the Keyword Overview and Historical Keyword Data endpoints is that you can retrieve actual and historical keyword data separately. Previously, when using the Historical Search Volume endpoint, both historical and actual keyword data were included in a single response, even when you only needed one of them. Now, you can request only the specific data, reducing unnecessary data processing and focusing on what you actually need for keyword research.
Let’s see how to set the tasks for these endpoints and what data you will get in the responses.
1 How to use the Keyword Overview endpoint
1. First, make a call to the Keyword Overview endpoint:
POST https://api.dataforseo.com/v3/dataforseo_labs/google/keyword_overview/live
2. Specify the keywords you want to get data for in the keywords array. You can specify up to 700 keywords in a single request. Learn more about the rules and limitations of the keyword field in this Help Center article.
3. Using the location_name or location_code field, specify the location. To get the list of available locations, make a separate request to the DataForSEO Labs API Locations and Languages endpoint.
4. Then, specify the language using the language_name or language_code field. Similarly, make a call to the DataForSEO Labs API Locations and Languages endpoint to get the list of available languages.
5. If you want to get data from SERP for each keyword, such as the number of search results and SERP features, set the include_serp_info parameter to true.
6. To get clickstream data for keywords, such as search volume normalized with clickstreams and clickstream-based metrics, specify the include_clickstream_data parameter to true. You can learn more about clickstream-based metrics and clickstream data in this Help Center article and the dedicated blog post.
The request should be structured like this:
[
{
"language_code": "en",
"location_code": 2840,
"include_clickstream_data": true,
"include_serp_info": true,
"keywords": [
"iphone"
]
}
]
After sending the request, you will get the following response in JSON:
{
"version": "0.1.20241227",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.1183 sec.",
"cost": 0.0201,
"tasks_count": 1,
"tasks_error": 0,
"tasks": [
{
"id": "03171337-1535-0607-0000-6c5f325e6fa7",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.0751 sec.",
"cost": 0.0201,
"result_count": 1,
"path": [
"v3",
"dataforseo_labs",
"google",
"keyword_overview",
"live"
],
"data": {
"api": "dataforseo_labs",
"function": "keyword_overview",
"se_type": "google",
"language_code": "en",
"location_code": 2840,
"include_clickstream_data": true,
"include_serp_info": true,
"keywords": [
"iphone"
]
},
"result": [
{
"se_type": "google",
"location_code": 2840,
"language_code": "en",
"items_count": 1,
"items": [
{
"se_type": "google",
"keyword": "iphone",
"location_code": 2840,
"language_code": "en",
"search_partners": false,
"keyword_info": {
"se_type": "google",
"last_updated_time": "2025-03-06 03:08:24 +00:00",
"competition": 1,
"competition_level": "HIGH",
"cpc": 6.45,
"search_volume": 1220000,
"low_top_of_page_bid": 2.6,
"high_top_of_page_bid": 5.14,
"categories": [
10007,
10878,
12161,
13054,
13381
],
"monthly_searches": [
{
"year": 2025,
"month": 2,
"search_volume": 1220000
},
{
"year": 2025,
"month": 1,
"search_volume": 1220000
},
{
"year": 2024,
"month": 12,
"search_volume": 1500000
},
{
"year": 2024,
"month": 11,
"search_volume": 1220000
},
{
"year": 2024,
"month": 10,
"search_volume": 1220000
},
{
"year": 2024,
"month": 9,
"search_volume": 1830000
},
{
"year": 2024,
"month": 8,
"search_volume": 1500000
},
{
"year": 2024,
"month": 7,
"search_volume": 1500000
},
{
"year": 2024,
"month": 6,
"search_volume": 1220000
},
{
"year": 2024,
"month": 5,
"search_volume": 1220000
},
{
"year": 2024,
"month": 4,
"search_volume": 1000000
},
{
"year": 2024,
"month": 3,
"search_volume": 1000000
},
{
"year": 2024,
"month": 2,
"search_volume": 1000000
},
{
"year": 2024,
"month": 1,
"search_volume": 1000000
},
{
"year": 2023,
"month": 12,
"search_volume": 1220000
},
{
"year": 2023,
"month": 11,
"search_volume": 1220000
},
{
"year": 2023,
"month": 10,
"search_volume": 1000000
},
{
"year": 2023,
"month": 9,
"search_volume": 1830000
},
{
"year": 2023,
"month": 8,
"search_volume": 1000000
},
{
"year": 2023,
"month": 7,
"search_volume": 1000000
},
{
"year": 2023,
"month": 6,
"search_volume": 1000000
},
{
"year": 2023,
"month": 5,
"search_volume": 1000000
},
{
"year": 2023,
"month": 4,
"search_volume": 823000
},
{
"year": 2023,
"month": 3,
"search_volume": 1000000
},
{
"year": 2023,
"month": 2,
"search_volume": 823000
},
{
"year": 2023,
"month": 1,
"search_volume": 1000000
},
{
"year": 2022,
"month": 12,
"search_volume": 1220000
},
{
"year": 2022,
"month": 11,
"search_volume": 1220000
},
{
"year": 2022,
"month": 10,
"search_volume": 1000000
},
{
"year": 2022,
"month": 9,
"search_volume": 1500000
},
{
"year": 2022,
"month": 8,
"search_volume": 1000000
},
{
"year": 2022,
"month": 7,
"search_volume": 1000000
},
{
"year": 2022,
"month": 6,
"search_volume": 1000000
},
{
"year": 2022,
"month": 5,
"search_volume": 1000000
},
{
"year": 2022,
"month": 4,
"search_volume": 1000000
},
{
"year": 2022,
"month": 3,
"search_volume": 1000000
},
{
"year": 2022,
"month": 2,
"search_volume": 823000
},
{
"year": 2022,
"month": 1,
"search_volume": 1000000
},
{
"year": 2021,
"month": 12,
"search_volume": 1220000
},
{
"year": 2021,
"month": 11,
"search_volume": 1220000
},
{
"year": 2021,
"month": 10,
"search_volume": 1220000
},
{
"year": 2021,
"month": 9,
"search_volume": 1500000
},
{
"year": 2021,
"month": 8,
"search_volume": 1000000
},
{
"year": 2021,
"month": 7,
"search_volume": 1000000
},
{
"year": 2021,
"month": 6,
"search_volume": 1000000
},
{
"year": 2021,
"month": 5,
"search_volume": 1000000
},
{
"year": 2021,
"month": 4,
"search_volume": 1000000
},
{
"year": 2021,
"month": 3,
"search_volume": 1000000
},
{
"year": 2021,
"month": 2,
"search_volume": 823000
},
{
"year": 2021,
"month": 1,
"search_volume": 1000000
},
{
"year": 2020,
"month": 12,
"search_volume": 1220000
},
{
"year": 2020,
"month": 11,
"search_volume": 1500000
},
{
"year": 2020,
"month": 10,
"search_volume": 1830000
},
{
"year": 2020,
"month": 9,
"search_volume": 1500000
},
{
"year": 2020,
"month": 8,
"search_volume": 1220000
},
{
"year": 2020,
"month": 7,
"search_volume": 1220000
},
{
"year": 2020,
"month": 6,
"search_volume": 1220000
},
{
"year": 2020,
"month": 5,
"search_volume": 1500000
},
{
"year": 2020,
"month": 4,
"search_volume": 1500000
},
{
"year": 2020,
"month": 3,
"search_volume": 1000000
},
{
"year": 2020,
"month": 2,
"search_volume": 1000000
},
{
"year": 2020,
"month": 1,
"search_volume": 1000000
},
{
"year": 2019,
"month": 12,
"search_volume": 1220000
},
{
"year": 2019,
"month": 11,
"search_volume": 1500000
},
{
"year": 2019,
"month": 10,
"search_volume": 1220000
},
{
"year": 2019,
"month": 9,
"search_volume": 2240000
},
{
"year": 2019,
"month": 8,
"search_volume": 1220000
},
{
"year": 2019,
"month": 7,
"search_volume": 1220000
},
{
"year": 2019,
"month": 6,
"search_volume": 1220000
},
{
"year": 2019,
"month": 5,
"search_volume": 1000000
},
{
"year": 2019,
"month": 4,
"search_volume": 1000000
},
{
"year": 2019,
"month": 3,
"search_volume": 1220000
}
],
"search_volume_trend": {
"monthly": 0,
"quarterly": -19,
"yearly": 22
}
},
"keyword_info_normalized_with_bing": {
"last_updated_time": "2025-03-12 15:18:56 +00:00",
"search_volume": 601842,
"is_normalized": true,
"monthly_searches": [
{
"year": 2025,
"month": 2,
"search_volume": 601842
},
{
"year": 2025,
"month": 1,
"search_volume": 601842
},
{
"year": 2024,
"month": 12,
"search_volume": 739970
},
{
"year": 2024,
"month": 11,
"search_volume": 601842
},
{
"year": 2024,
"month": 10,
"search_volume": 601842
},
{
"year": 2024,
"month": 9,
"search_volume": 902763
},
{
"year": 2024,
"month": 8,
"search_volume": 739970
},
{
"year": 2024,
"month": 7,
"search_volume": 739970
},
{
"year": 2024,
"month": 6,
"search_volume": 601842
},
{
"year": 2024,
"month": 5,
"search_volume": 601842
},
{
"year": 2024,
"month": 4,
"search_volume": 493313
},
{
"year": 2024,
"month": 3,
"search_volume": 493313
}
]
},
"keyword_info_normalized_with_clickstream": {
"last_updated_time": "2025-03-12 15:18:56 +00:00",
"search_volume": 1176877,
"is_normalized": true,
"monthly_searches": [
{
"year": 2025,
"month": 2,
"search_volume": 1176877
},
{
"year": 2025,
"month": 1,
"search_volume": 1176877
},
{
"year": 2024,
"month": 12,
"search_volume": 1446980
},
{
"year": 2024,
"month": 11,
"search_volume": 1176877
},
{
"year": 2024,
"month": 10,
"search_volume": 1176877
},
{
"year": 2024,
"month": 9,
"search_volume": 1765316
},
{
"year": 2024,
"month": 8,
"search_volume": 1446980
},
{
"year": 2024,
"month": 7,
"search_volume": 1446980
},
{
"year": 2024,
"month": 6,
"search_volume": 1176877
},
{
"year": 2024,
"month": 5,
"search_volume": 1176877
},
{
"year": 2024,
"month": 4,
"search_volume": 964653
},
{
"year": 2024,
"month": 3,
"search_volume": 964653
}
]
},
"clickstream_keyword_info": {
"search_volume": 737851,
"last_updated_time": "2025-01-04 00:08:42 +00:00",
"gender_distribution": {
"female": 51,
"male": 49
},
"age_distribution": {
"18-24": 22,
"25-34": 19,
"35-44": 25,
"45-54": 32,
"55-64": 2
},
"monthly_searches": [
{
"year": 2024,
"month": 12,
"search_volume": 737850
},
{
"year": 2024,
"month": 11,
"search_volume": 693290
},
{
"year": 2024,
"month": 10,
"search_volume": 650060
},
{
"year": 2024,
"month": 9,
"search_volume": 610650
},
{
"year": 2024,
"month": 8,
"search_volume": 568000
},
{
"year": 2024,
"month": 7,
"search_volume": 543520
},
{
"year": 2024,
"month": 6,
"search_volume": 525870
},
{
"year": 2024,
"month": 5,
"search_volume": 512420
},
{
"year": 2024,
"month": 4,
"search_volume": 511900
},
{
"year": 2024,
"month": 3,
"search_volume": 508440
},
{
"year": 2024,
"month": 2,
"search_volume": 515800
},
{
"year": 2024,
"month": 1,
"search_volume": 520500
}
]
},
"keyword_properties": {
"se_type": "google",
"core_keyword": null,
"synonym_clustering_algorithm": "text_processing",
"keyword_difficulty": 89,
"detected_language": "en",
"is_another_language": false
},
"serp_info": {
"se_type": "google",
"check_url": "https://www.google.com/search?q=iphone&num=100&hl=en&gl=US&gws_rd=cr&ie=UTF-8&oe=UTF-8&glp=1&uule=w+CAIQIFISCQs2MuSEtepUEUK33kOSuTsc",
"serp_item_types": [
"organic",
"popular_products",
"people_also_ask",
"images",
"perspectives",
"people_also_search",
"related_searches",
"knowledge_graph"
],
"se_results_count": 13380000000,
"last_updated_time": "2025-02-26 21:10:59 +00:00",
"previous_updated_time": "2025-01-16 07:38:29 +00:00"
},
"avg_backlinks_info": {
"se_type": "google",
"backlinks": 1333333.7,
"dofollow": 1048624.3,
"referring_pages": 1077104.1,
"referring_domains": 9109.9,
"referring_main_domains": 8417.2,
"rank": 415.6,
"main_domain_rank": 818.7,
"last_updated_time": "2025-02-26 19:11:00 +00:00"
},
"search_intent_info": {
"se_type": "google",
"main_intent": "informational",
"foreign_intent": null,
"last_updated_time": "2023-02-28 15:25:15 +00:00"
}
}
]
}
]
}
]
}
In the items array of the response, you will receive the following list of items that contain keyword data:
keyword_info– contains core data and metrics for each keyword, such as competition, search volume, product and service categories, and monthly searches;keyword_info_normalized_with_bing– contains search volume and monthly searches for the keyword, normalized with Bing search volume data. This item returns only when theinclude_clickstream_dataparameter is set totrue.
Learn more about the Bing normalized search volume in this Help Center article;keyword_info_normalized_with_clickstream– contains search volume and monthly searches for the keyword normalized with clickstream data. This item returns only when theinclude_clickstream_dataparameter is set totrue.
Learn more about clickstream-normalized search volume in this Help Center article;clickstream_keyword_info– provides you with clickstream-based data for keywords such as clickstream search volume, age and gender distribution and monthly searches. This item returns only when theinclude_clickstream_dataparameter is set totrue.
Learn more about clickstream-based metrics and clickstream data in this Help Center article and this blog post;keyword_properties– contains additional information about the keyword, such as core keyword, keyword difficulty, etc;serp_info– provides the SERP data for keywords, such as URLs to search engine results and SERP item types. This item returns only when theinclude_serp_infoparameter is set totrue;avg_backlinks_info– contains backlink data for keywords, such as average number of backlinks, their type, and average rank by specified keywords;search_intent_info– contains information about the keyword’s main and foreign search intent.
This data provides a complete overview of specified keyword stats and can help you evaluate the relevance of keywords for your keyword strategy. You can also incorporate the data from this endpoint into your custom keyword tool, allowing your users to examine the data on particular keywords in their keyword lists.
2 How to use the Historical Keyword Data endpoint
1. Call the Historical Keyword Data endpoint:
POST https://api.dataforseo.com/v3/dataforseo_labs/google/historical_keyword_data/live
2. Specify the keywords in the keywords array. As in the Keyword Overview endpoint, you can specify up to 700 keywords in a single request. Learn more about the rules and limitations of the keyword field in this Help Center article.
3. Specify the location using the location_name or location_code field. To get a list of available locations, make a separate request to the DataForSEO Labs API Locations and Languages endpoint.
4. Using the language_name or language_code field, specify the language. Call the DataForSEO Labs API Locations and Languages endpoint to get the list of available languages.
Request example:
[
{
"language_code": "en",
"location_code": 2840,
"keywords": [
"iphone"
]
}
]
Response example:
{
"version": "0.1.20241227",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.1138 sec.",
"cost": 0.0101,
"tasks_count": 1,
"tasks_error": 0,
"tasks": [
{
"id": "03171338-1535-0608-0000-5330fd442f25",
"status_code": 20000,
"status_message": "Ok.",
"time": "0.0767 sec.",
"cost": 0.0101,
"result_count": 1,
"path": [
"v3",
"dataforseo_labs",
"google",
"historical_keyword_data",
"live"
],
"data": {
"api": "dataforseo_labs",
"function": "historical_keyword_data",
"se_type": "google",
"language_code": "en",
"location_code": 2840,
"keywords": [
"iphone"
]
},
"result": [
{
"se_type": "google",
"location_code": 2840,
"language_code": "en",
"items_count": 1,
"items": [
{
"se_type": "google",
"keyword": "iphone",
"location_code": 2840,
"language_code": "en",
"history": [
{
"year": 2025,
"month": 2,
"keyword_info": {
"se_type": "google",
"last_updated_time": "2025-03-06 03:08:24 +00:00",
"competition": 1,
"competition_level": "HIGH",
"cpc": 6.45,
"search_volume": 1220000,
"low_top_of_page_bid": 2.6,
"high_top_of_page_bid": 5.14,
"categories": [
10007,
10878,
12161,
13054,
13381
],
"monthly_searches": [
{
"year": 2025,
"month": 2,
"search_volume": 1220000
},
{
"year": 2025,
"month": 1,
"search_volume": 1220000
},
{
"year": 2024,
"month": 12,
"search_volume": 1500000
},
{
"year": 2024,
"month": 11,
"search_volume": 1220000
},
{
"year": 2024,
"month": 10,
"search_volume": 1220000
},
{
"year": 2024,
"month": 9,
"search_volume": 1830000
},
{
"year": 2024,
"month": 8,
"search_volume": 1500000
},
{
"year": 2024,
"month": 7,
"search_volume": 1500000
},
{
"year": 2024,
"month": 6,
"search_volume": 1220000
},
{
"year": 2024,
"month": 5,
"search_volume": 1220000
},
{
"year": 2024,
"month": 4,
"search_volume": 1000000
},
{
"year": 2024,
"month": 3,
"search_volume": 1000000
}
],
"search_volume_trend": {
"monthly": 0,
"quarterly": -19,
"yearly": 22
}
}
},
{
"year": 2025,
"month": 1,
"keyword_info": {
"se_type": "google",
"last_updated_time": "2025-02-06 05:57:16 +00:00",
"competition": 1,
"competition_level": "HIGH",
"cpc": 5.72,
"search_volume": 1220000,
"low_top_of_page_bid": 2.66,
"high_top_of_page_bid": 4.49,
"categories": [
10007,
10878,
12161,
13054,
13381
],
"monthly_searches": [
{
"year": 2025,
"month": 1,
"search_volume": 1220000
},
{
"year": 2024,
"month": 12,
"search_volume": 1500000
},
{
"year": 2024,
"month": 11,
"search_volume": 1220000
},
{
"year": 2024,
"month": 10,
"search_volume": 1220000
},
{
"year": 2024,
"month": 9,
"search_volume": 1830000
},
{
"year": 2024,
"month": 8,
"search_volume": 1500000
},
{
"year": 2024,
"month": 7,
"search_volume": 1500000
},
{
"year": 2024,
"month": 6,
"search_volume": 1220000
},
{
"year": 2024,
"month": 5,
"search_volume": 1220000
},
{
"year": 2024,
"month": 4,
"search_volume": 1000000
},
{
"year": 2024,
"month": 3,
"search_volume": 1000000
},
{
"year": 2024,
"month": 2,
"search_volume": 1000000
}
],
"search_volume_trend": {
"monthly": -19,
"quarterly": 0,
"yearly": 22
}
}
},
{
"year": 2024,
"month": 12,
"keyword_info": {
"se_type": "google",
"last_updated_time": "2025-01-14 06:26:52 +00:00",
"competition": 1,
"competition_level": "HIGH",
"cpc": 7.71,
"search_volume": 1220000,
"low_top_of_page_bid": 2.66,
"high_top_of_page_bid": 6.65,
"categories": [
10007,
10878,
12161,
13054,
13381
],
"monthly_searches": [
{
"year": 2024,
"month": 12,
"search_volume": 1500000
},
{
"year": 2024,
"month": 11,
"search_volume": 1220000
},
{
"year": 2024,
"month": 10,
"search_volume": 1220000
},
{
"year": 2024,
"month": 9,
"search_volume": 1830000
},
{
"year": 2024,
"month": 8,
"search_volume": 1500000
},
{
"year": 2024,
"month": 7,
"search_volume": 1500000
},
{
"year": 2024,
"month": 6,
"search_volume": 1220000
},
{
"year": 2024,
"month": 5,
"search_volume": 1220000
},
{
"year": 2024,
"month": 4,
"search_volume": 1000000
},
{
"year": 2024,
"month": 3,
"search_volume": 1000000
},
{
"year": 2024,
"month": 2,
"search_volume": 1000000
},
{
"year": 2024,
"month": 1,
"search_volume": 1000000
}
],
"search_volume_trend": {
"monthly": 23,
"quarterly": 23,
"yearly": 23
}
}
},
{
"year": 2024,
"month": 11,
"keyword_info": {
"se_type": "google",
"last_updated_time": "2024-12-13 02:17:17 +00:00",
"competition": 1,
"competition_level": "HIGH",
"cpc": 6.95,
"search_volume": 1220000,
"low_top_of_page_bid": 2.54,
"high_top_of_page_bid": 5.89,
"categories": [
10007,
10878,
12161,
13054,
13381
],
"monthly_searches": [
{
"year": 2024,
"month": 11,
"search_volume": 1220000
},
{
"year": 2024,
"month": 10,
"search_volume": 1220000
},
{
"year": 2024,
"month": 9,
"search_volume": 1830000
},
{
"year": 2024,
"month": 8,
"search_volume": 1500000
},
{
"year": 2024,
"month": 7,
"search_volume": 1500000
},
{
"year": 2024,
"month": 6,
"search_volume": 1220000
},
{
"year": 2024,
"month": 5,
"search_volume": 1220000
},
{
"year": 2024,
"month": 4,
"search_volume": 1000000
},
{
"year": 2024,
"month": 3,
"search_volume": 1000000
},
{
"year": 2024,
"month": 2,
"search_volume": 1000000
},
{
"year": 2024,
"month": 1,
"search_volume": 1000000
},
{
"year": 2023,
"month": 12,
"search_volume": 1220000
}
],
"search_volume_trend": {
"monthly": 0,
"quarterly": -33,
"yearly": 0
}
}
},
{
"year": 2024,
"month": 10,
"keyword_info": {
"se_type": "google",
"last_updated_time": "2024-11-09 03:50:46 +00:00",
"competition": 1,
"competition_level": "HIGH",
"cpc": 4.3,
"search_volume": 1220000,
"low_top_of_page_bid": 1.56,
"high_top_of_page_bid": 4.23,
"categories": [
10007,
10878,
12161,
13054,
13381
],
"monthly_searches": [
{
"year": 2024,
"month": 10,
"search_volume": 1220000
},
{
"year": 2024,
"month": 9,
"search_volume": 1830000
},
{
"year": 2024,
"month": 8,
"search_volume": 1500000
},
{
"year": 2024,
"month": 7,
"search_volume": 1500000
},
{
"year": 2024,
"month": 6,
"search_volume": 1220000
},
{
"year": 2024,
"month": 5,
"search_volume": 1220000
},
{
"year": 2024,
"month": 4,
"search_volume": 1000000
},
{
"year": 2024,
"month": 3,
"search_volume": 1000000
},
{
"year": 2024,
"month": 2,
"search_volume": 1000000
},
{
"year": 2024,
"month": 1,
"search_volume": 1000000
},
{
"year": 2023,
"month": 12,
"search_volume": 1220000
},
{
"year": 2023,
"month": 11,
"search_volume": 1220000
}
],
"search_volume_trend": {
"monthly": -33,
"quarterly": -19,
"yearly": 22
}
}
},
{
"year": 2024,
"month": 9,
"keyword_info": {
"se_type": "google",
"last_updated_time": "2024-10-06 14:40:29 +00:00",
"competition": 1,
"competition_level": "HIGH",
"cpc": 3.98,
"search_volume": 1220000,
"low_top_of_page_bid": 1.43,
"high_top_of_page_bid": 4.5,
"categories": [
10007,
10878,
12161,
13054,
13381
],
"monthly_searches": [
{
"year": 2024,
"month": 9,
"search_volume": 1830000
},
{
"year": 2024,
"month": 8,
"search_volume": 1500000
},
{
"year": 2024,
"month": 7,
"search_volume": 1500000
},
{
"year": 2024,
"month": 6,
"search_volume": 1220000
},
{
"year": 2024,
"month": 5,
"search_volume": 1220000
},
{
"year": 2024,
"month": 4,
"search_volume": 1000000
},
{
"year": 2024,
"month": 3,
"search_volume": 1000000
},
{
"year": 2024,
"month": 2,
"search_volume": 1000000
},
{
"year": 2024,
"month": 1,
"search_volume": 1000000
},
{
"year": 2023,
"month": 12,
"search_volume": 1220000
},
{
"year": 2023,
"month": 11,
"search_volume": 1220000
},
{
"year": 2023,
"month": 10,
"search_volume": 1000000
}
],
"search_volume_trend": {
"monthly": 22,
"quarterly": 22,
"yearly": 0
}
}
},
{
"year": 2021,
"month": 7,
"keyword_info": {
"se_type": "google",
"last_updated_time": "2021-08-13 09:21:16 +00:00",
"competition": 0.999989726874962,
"competition_level": null,
"cpc": 2.527432,
"search_volume": 1220000,
"low_top_of_page_bid": null,
"high_top_of_page_bid": null,
"categories": [
10007,
10019,
10167,
10872,
10878,
11511,
12133,
12161,
13054,
13381,
13419
],
"monthly_searches": [
{
"year": 2021,
"month": 7,
"search_volume": 1000000
},
{
"year": 2021,
"month": 6,
"search_volume": 823000
},
{
"year": 2021,
"month": 5,
"search_volume": 1000000
},
{
"year": 2021,
"month": 4,
"search_volume": 1000000
},
{
"year": 2021,
"month": 3,
"search_volume": 1000000
},
{
"year": 2021,
"month": 2,
"search_volume": 823000
},
{
"year": 2021,
"month": 1,
"search_volume": 1000000
},
{
"year": 2020,
"month": 12,
"search_volume": 1220000
},
{
"year": 2020,
"month": 11,
"search_volume": 1500000
},
{
"year": 2020,
"month": 10,
"search_volume": 1830000
},
{
"year": 2020,
"month": 9,
"search_volume": 1220000
},
{
"year": 2020,
"month": 8,
"search_volume": 1220000
}
],
"search_volume_trend": {
"monthly": 22,
"quarterly": 0,
"yearly": null
}
}
}
]
}
]
}
]
}
]
}
In the items array of response, locate history arrays. These arrays contain objects with historical keyword data for each specified keyword since the beginning of 2019. Each object represents keyword data for a particular year and month and contains the following elements:
keyword_info– an object that contains historical data and metrics for the keyword, such as competition, CPC, search volume, and product and service categories;montly_searches– an array of objects representing the approximate number of monthly searches for the keyword targeted to the specified geographic locations;search_volume_trend– an object representing search volume change in percent compared to the previous period.
As you can see, this endpoint can provide detailed historical data for multiple keywords simultaneously, enabling you to explore the historical changes in the keywords’ metrics. This data is invaluable for conducting in-depth keyword research and powering up keyword tools with extensive historical data.
Wrap-up
The Keyword Overview and Historical Keyword Data endpoints are powerful tools for retrieving actual and historical keyword data for keyword research. Compared to the Historical Search Volume endpoint, which they replaced, these new endpoints provide greater flexibility in keyword data retrieval. With them, you can access historical and actual keyword insights separately, freeing you from dealing with unnecessary data.
If you have any questions or need additional information, you can always contact our support team.