HELP CENTER

What is replace_with_core_keyword in the Related Keywords endpoint?

As you might have noticed, we’ve added the replace_with_core_keyword parameter to the Related Keywords endpoint of DataForSEO Labs API. It can help you collect SERP info and related keywords for terms that otherwise wouldn’t have returned such data.

Let us explain how the new parameter works.

In a nutshell, each keyword belongs to some keyword group, and each group has its main keyword (or the core_keyword as it comes in the API response). For example, the keywords holiday and holidays belong to the same group, where holiday is the core keyword and holidays is the related keyword.

To optimize the size of our keyword database, we don’t collect data for related keywords. Thus, if you try to find SERP info and related keywords for the word holidays, you will fail.

Example of a POST request

[
    {
        "keyword": "holidays",
        "language_name": "English",
        "location_code": 2840,
        "limit": 100,
        "include_serp_info": "true"
    }
]

Response

{
    "version": "0.1.20220216",
    "status_code": 20000,
    "status_message": "Ok.",
    "time": "0.0713 sec.",
    "cost": 0.0101,
    "tasks_count": 1,
    "tasks_error": 0,
    "tasks": [
        {
            "id": "03211147-2806-0387-0000-d4cf6830c251",
            "status_code": 20000,
            "status_message": "Ok.",
            "time": "0.0265 sec.",
            "cost": 0.0101,
            "result_count": 1,
            "path": [
                "v3",
                "dataforseo_labs",
                "google",
                "related_keywords",
                "live"
            ],
            "data": {
                "api": "dataforseo_labs",
                "function": "related_keywords",
                "se_type": "google",
                "keyword": "holidays",
                "language_name": "English",
                "location_code": 2840,
                "limit": 100,
                "include_serp_info": "true"
            },
            "result": [
                {
                    "se_type": "google",
                    "seed_keyword": "holidays",
                    "seed_keyword_data": null,
                    "location_code": 2840,
                    "language_code": "en",
                    "total_count": 1,
                    "items_count": 1,
                    "items": [
                        {
                            "se_type": "google",
                            "keyword_data": {
                                "se_type": "google",
                                "keyword": "holidays",
                                "location_code": 2840,
                                "language_code": "en",
                                "keyword_info": {
                                    "se_type": "google",
                                    "last_updated_time": "2022-03-17 03:32:20 +00:00",
                                    "competition": 0.005086750746544331,
                                    "cpc": 0.607887,
                                    "search_volume": 301000,
                                    "categories": [
                                        10017,
                                        10145,
                                        10151,
                                        10154,
                                        13582
                                    ],
                                    "monthly_searches": [
                                        {
                                            "year": 2022,
                                            "month": 2,
                                            "search_volume": 246000
                                        },
                                        {
                                            "year": 2022,
                                            "month": 1,
                                            "search_volume": 246000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 12,
                                            "search_volume": 550000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 11,
                                            "search_volume": 368000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 10,
                                            "search_volume": 301000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 9,
                                            "search_volume": 301000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 8,
                                            "search_volume": 201000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 7,
                                            "search_volume": 201000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 6,
                                            "search_volume": 246000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 5,
                                            "search_volume": 246000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 4,
                                            "search_volume": 201000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 3,
                                            "search_volume": 246000
                                        }
                                    ]
                                },
                                "keyword_properties": {
                                    "se_type": "google",
                                    "core_keyword": "holiday",
                                    "keyword_difficulty": 100
                                },
                                "impressions_info": {
                                    "se_type": "google",
                                    "last_updated_time": "2022-03-18 01:04:16 +00:00",
                                    "bid": 999,
                                    "match_type": "exact",
                                    "ad_position_min": 1.58,
                                    "ad_position_max": 1,
                                    "ad_position_average": 1.43,
                                    "cpc_min": 323.97,
                                    "cpc_max": 395.96,
                                    "cpc_average": 359.97,
                                    "daily_impressions_min": 20.72,
                                    "daily_impressions_max": 25.32,
                                    "daily_impressions_average": 23.02,
                                    "daily_clicks_min": 1.14,
                                    "daily_clicks_max": 1.4,
                                    "daily_clicks_average": 1.27,
                                    "daily_cost_min": 411.52,
                                    "daily_cost_max": 502.97,
                                    "daily_cost_average": 457.24
                                },
                                "serp_info": {
                                    "se_type": "google",
                                    "check_url": null,
                                    "serp_item_types": null,
                                    "se_results_count": null,
                                    "last_updated_time": "0001-01-01 00:00:00 +00:00",
                                    "previous_updated_time": null
                                }
                            },
                            "depth": 0,
                            "related_keywords": null
                        }
                    ]
                }
            ]
        }
    ]
}

However, if you add the replace_with_core_keyword parameter and set it to true, you will find what you need.

Example of a POST request

[
    {
    	"keyword": "holidays",
    	"language_name": "English",
        "location_code": 2840,
		"limit": 100,
        "include_serp_info": "true",
        "replace_with_core_keyword": "true"
    }
]

Response

{
    "version": "0.1.20220216",
    "status_code": 20000,
    "status_message": "Ok.",
    "time": "0.1106 sec.",
    "cost": 0.0108,
    "tasks_count": 1,
    "tasks_error": 0,
    "tasks": [
        {
            "id": "03211148-2806-0387-0000-aff16c22fb76",
            "status_code": 20000,
            "status_message": "Ok.",
            "time": "0.0573 sec.",
            "cost": 0.0108,
            "result_count": 1,
            "path": [
                "v3",
                "dataforseo_labs",
                "google",
                "related_keywords",
                "live"
            ],
            "data": {
                "api": "dataforseo_labs",
                "function": "related_keywords",
                "se_type": "google",
                "keyword": "holidays",
                "language_name": "English",
                "location_code": 2840,
                "limit": 100,
                "include_serp_info": "true",
                "replace_with_core_keyword": "true"
            },
            "result": [
                {
                    "se_type": "google",
                    "seed_keyword": "holidays",
                    "seed_keyword_data": null,
                    "location_code": 2840,
                    "language_code": "en",
                    "total_count": 8,
                    "items_count": 8,
                    "items": [
                        {
                            "se_type": "google",
                            "keyword_data": {
                                "se_type": "google",
                                "keyword": "holiday today",
                                "location_code": 2840,
                                "language_code": "en",
                                "keyword_info": {
                                    "se_type": "google",
                                    "last_updated_time": "2022-02-11 16:25:27 +00:00",
                                    "competition": 0.00021990509801461268,
                                    "cpc": 0.715873,
                                    "search_volume": 450000,
                                    "categories": [
                                        10017,
                                        10145,
                                        10151,
                                        10154,
                                        13582
                                    ],
                                    "monthly_searches": [
                                        {
                                            "year": 2022,
                                            "month": 1,
                                            "search_volume": 450000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 12,
                                            "search_volume": 201000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 11,
                                            "search_volume": 450000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 10,
                                            "search_volume": 823000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 9,
                                            "search_volume": 450000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 8,
                                            "search_volume": 301000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 7,
                                            "search_volume": 368000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 6,
                                            "search_volume": 450000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 5,
                                            "search_volume": 450000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 4,
                                            "search_volume": 450000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 3,
                                            "search_volume": 550000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 2,
                                            "search_volume": 673000
                                        }
                                    ]
                                },
                                "keyword_properties": {
                                    "se_type": "google",
                                    "core_keyword": null,
                                    "keyword_difficulty": 80
                                },
                                "impressions_info": {
                                    "se_type": "google",
                                    "last_updated_time": "2022-03-16 12:32:38 +00:00",
                                    "bid": 999,
                                    "match_type": "exact",
                                    "ad_position_min": null,
                                    "ad_position_max": null,
                                    "ad_position_average": null,
                                    "cpc_min": null,
                                    "cpc_max": null,
                                    "cpc_average": null,
                                    "daily_impressions_min": null,
                                    "daily_impressions_max": null,
                                    "daily_impressions_average": null,
                                    "daily_clicks_min": null,
                                    "daily_clicks_max": null,
                                    "daily_clicks_average": null,
                                    "daily_cost_min": null,
                                    "daily_cost_max": null,
                                    "daily_cost_average": null
                                },
                                "serp_info": {
                                    "se_type": "google",
                                    "check_url": "https://www.google.com/search?q=holiday%20today&num=100&hl=en&gl=US&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCQs2MuSEtepUEUK33kOSuTsc",
                                    "serp_item_types": [
                                        "organic",
                                        "images",
                                        "related_searches",
                                        "multi_carousel"
                                    ],
                                    "se_results_count": null,
                                    "last_updated_time": "2022-03-13 15:36:05 +00:00",
                                    "previous_updated_time": null
                                }
                            },
                            "depth": 1,
                            "related_keywords": [
                                "what holiday is today 2021",
                                "u.s. holiday today",
                                "what special day is today",
                                "jewish holiday today",
                                "is today a bank holiday",
                                "what religious holiday is today",
                                "what holiday is tomorrow",
                                "public holiday today"
                            ]
                        },
                        {
                            "se_type": "google",
                            "keyword_data": {
                                "se_type": "google",
                                "keyword": "holidays",
                                "location_code": 2840,
                                "language_code": "en",
                                "keyword_info": {
                                    "se_type": "google",
                                    "last_updated_time": "2022-03-17 03:32:20 +00:00",
                                    "competition": 0.005086750746544331,
                                    "cpc": 0.607887,
                                    "search_volume": 301000,
                                    "categories": [
                                        10017,
                                        10145,
                                        10151,
                                        10154,
                                        13582
                                    ],
                                    "monthly_searches": [
                                        {
                                            "year": 2022,
                                            "month": 2,
                                            "search_volume": 246000
                                        },
                                        {
                                            "year": 2022,
                                            "month": 1,
                                            "search_volume": 246000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 12,
                                            "search_volume": 550000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 11,
                                            "search_volume": 368000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 10,
                                            "search_volume": 301000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 9,
                                            "search_volume": 301000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 8,
                                            "search_volume": 201000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 7,
                                            "search_volume": 201000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 6,
                                            "search_volume": 246000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 5,
                                            "search_volume": 246000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 4,
                                            "search_volume": 201000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 3,
                                            "search_volume": 246000
                                        }
                                    ]
                                },
                                "keyword_properties": {
                                    "se_type": "google",
                                    "core_keyword": "holiday",
                                    "keyword_difficulty": 100
                                },
                                "impressions_info": {
                                    "se_type": "google",
                                    "last_updated_time": "2022-03-18 01:04:16 +00:00",
                                    "bid": 999,
                                    "match_type": "exact",
                                    "ad_position_min": 1.58,
                                    "ad_position_max": 1,
                                    "ad_position_average": 1.43,
                                    "cpc_min": 323.97,
                                    "cpc_max": 395.96,
                                    "cpc_average": 359.97,
                                    "daily_impressions_min": 20.72,
                                    "daily_impressions_max": 25.32,
                                    "daily_impressions_average": 23.02,
                                    "daily_clicks_min": 1.14,
                                    "daily_clicks_max": 1.4,
                                    "daily_clicks_average": 1.27,
                                    "daily_cost_min": 411.52,
                                    "daily_cost_max": 502.97,
                                    "daily_cost_average": 457.24
                                },
                                "serp_info": {
                                    "se_type": "google",
                                    "check_url": null,
                                    "serp_item_types": null,
                                    "se_results_count": null,
                                    "last_updated_time": "0001-01-01 00:00:00 +00:00",
                                    "previous_updated_time": null
                                }
                            },
                            "depth": 0,
                            "related_keywords": [
                                "holiday today",
                                "holiday meaning",
                                "holiday movie",
                                "u.s. holidays",
                                "holidays 2021",
                                "list of holidays",
                                "holidays 2022",
                                "holiday gas"
                            ]
                        },
                        {
                            "se_type": "google",
                            "keyword_data": {
                                "se_type": "google",
                                "keyword": "holidays 2021",
                                "location_code": 2840,
                                "language_code": "en",
                                "keyword_info": {
                                    "se_type": "google",
                                    "last_updated_time": "2022-03-20 10:58:19 +00:00",
                                    "competition": 0.005114308614175032,
                                    "cpc": 2.859286,
                                    "search_volume": 135000,
                                    "categories": [
                                        10017,
                                        10145,
                                        10151,
                                        10154,
                                        13582
                                    ],
                                    "monthly_searches": [
                                        {
                                            "year": 2022,
                                            "month": 2,
                                            "search_volume": 8100
                                        },
                                        {
                                            "year": 2022,
                                            "month": 1,
                                            "search_volume": 18100
                                        },
                                        {
                                            "year": 2021,
                                            "month": 12,
                                            "search_volume": 60500
                                        },
                                        {
                                            "year": 2021,
                                            "month": 11,
                                            "search_volume": 110000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 10,
                                            "search_volume": 135000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 9,
                                            "search_volume": 135000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 8,
                                            "search_volume": 165000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 7,
                                            "search_volume": 135000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 6,
                                            "search_volume": 135000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 5,
                                            "search_volume": 201000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 4,
                                            "search_volume": 201000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 3,
                                            "search_volume": 246000
                                        }
                                    ]
                                },
                                "keyword_properties": {
                                    "se_type": "google",
                                    "core_keyword": "2021 holidays",
                                    "keyword_difficulty": 67
                                },
                                "impressions_info": {
                                    "se_type": "google",
                                    "last_updated_time": "2022-03-16 17:20:14 +00:00",
                                    "bid": 999,
                                    "match_type": "exact",
                                    "ad_position_min": null,
                                    "ad_position_max": null,
                                    "ad_position_average": null,
                                    "cpc_min": null,
                                    "cpc_max": null,
                                    "cpc_average": null,
                                    "daily_impressions_min": null,
                                    "daily_impressions_max": null,
                                    "daily_impressions_average": null,
                                    "daily_clicks_min": null,
                                    "daily_clicks_max": null,
                                    "daily_clicks_average": null,
                                    "daily_cost_min": null,
                                    "daily_cost_max": null,
                                    "daily_cost_average": null
                                },
                                "serp_info": {
                                    "se_type": "google",
                                    "check_url": "https://www.google.com/search?q=holidays%202021&num=100&hl=en&gl=US&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCQs2MuSEtepUEUK33kOSuTsc",
                                    "serp_item_types": [
                                        "featured_snippet",
                                        "organic",
                                        "video",
                                        "top_stories",
                                        "images",
                                        "related_searches",
                                        "multi_carousel"
                                    ],
                                    "se_results_count": 3410000000,
                                    "last_updated_time": "2022-01-13 22:40:27 +00:00",
                                    "previous_updated_time": null
                                }
                            },
                            "depth": 1,
                            "related_keywords": [
                                "fun holidays 2021",
                                "uk holidays 2021",
                                "government holidays 2021",
                                "canada holidays 2021",
                                "us bank holidays 2021",
                                "christmas holidays 2021",
                                "india holidays 2021",
                                "monday holidays 2021"
                            ]
                        },
                        {
                            "se_type": "google",
                            "keyword_data": {
                                "se_type": "google",
                                "keyword": "holiday movie",
                                "location_code": 2840,
                                "language_code": "en",
                                "keyword_info": {
                                    "se_type": "google",
                                    "last_updated_time": "2022-02-10 02:25:30 +00:00",
                                    "competition": 0.22955295378791685,
                                    "cpc": 0.26801,
                                    "search_volume": 49500,
                                    "categories": [
                                        10013,
                                        10103,
                                        10108,
                                        10111,
                                        10560,
                                        10562,
                                        10606,
                                        10756,
                                        13417,
                                        13572
                                    ],
                                    "monthly_searches": [
                                        {
                                            "year": 2022,
                                            "month": 1,
                                            "search_volume": 27100
                                        },
                                        {
                                            "year": 2021,
                                            "month": 12,
                                            "search_volume": 201000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 11,
                                            "search_volume": 165000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 10,
                                            "search_volume": 60500
                                        },
                                        {
                                            "year": 2021,
                                            "month": 9,
                                            "search_volume": 14800
                                        },
                                        {
                                            "year": 2021,
                                            "month": 8,
                                            "search_volume": 12100
                                        },
                                        {
                                            "year": 2021,
                                            "month": 7,
                                            "search_volume": 12100
                                        },
                                        {
                                            "year": 2021,
                                            "month": 6,
                                            "search_volume": 14800
                                        },
                                        {
                                            "year": 2021,
                                            "month": 5,
                                            "search_volume": 14800
                                        },
                                        {
                                            "year": 2021,
                                            "month": 4,
                                            "search_volume": 12100
                                        },
                                        {
                                            "year": 2021,
                                            "month": 3,
                                            "search_volume": 12100
                                        },
                                        {
                                            "year": 2021,
                                            "month": 2,
                                            "search_volume": 12100
                                        }
                                    ]
                                },
                                "keyword_properties": {
                                    "se_type": "google",
                                    "core_keyword": "holiday movies",
                                    "keyword_difficulty": 77
                                },
                                "impressions_info": {
                                    "se_type": "google",
                                    "last_updated_time": "2022-03-16 13:00:41 +00:00",
                                    "bid": 999,
                                    "match_type": "exact",
                                    "ad_position_min": 1.11,
                                    "ad_position_max": 1,
                                    "ad_position_average": 1.06,
                                    "cpc_min": 694.14,
                                    "cpc_max": 848.4,
                                    "cpc_average": 771.27,
                                    "daily_impressions_min": 0.12,
                                    "daily_impressions_max": 0.15,
                                    "daily_impressions_average": 0.14,
                                    "daily_clicks_min": null,
                                    "daily_clicks_max": null,
                                    "daily_clicks_average": null,
                                    "daily_cost_min": 1.76,
                                    "daily_cost_max": 2.15,
                                    "daily_cost_average": 1.95
                                },
                                "serp_info": {
                                    "se_type": "google",
                                    "check_url": "https://www.google.com/search?q=holiday%20movie&num=100&hl=en&gl=US&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCQs2MuSEtepUEUK33kOSuTsc",
                                    "serp_item_types": [
                                        "organic",
                                        "video",
                                        "people_also_ask",
                                        "top_stories",
                                        "related_searches",
                                        "multi_carousel",
                                        "knowledge_graph"
                                    ],
                                    "se_results_count": 3010000000,
                                    "last_updated_time": "2022-01-13 23:11:50 +00:00",
                                    "previous_updated_time": null
                                }
                            },
                            "depth": 1,
                            "related_keywords": [
                                "holiday movie 1938",
                                "holiday movie netflix",
                                "holiday movie full",
                                "holiday movie 2020",
                                "holiday movie akshay kumar",
                                "holiday movie 2019",
                                "holiday movie black and white",
                                "the holiday"
                            ]
                        },
                        {
                            "se_type": "google",
                            "keyword_data": {
                                "se_type": "google",
                                "keyword": "holidays 2022",
                                "location_code": 2840,
                                "language_code": "en",
                                "keyword_info": {
                                    "se_type": "google",
                                    "last_updated_time": "2022-02-12 13:10:33 +00:00",
                                    "competition": 0.006563111126826071,
                                    "cpc": 3.107466,
                                    "search_volume": 40500,
                                    "categories": null,
                                    "monthly_searches": [
                                        {
                                            "year": 2022,
                                            "month": 1,
                                            "search_volume": 201000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 12,
                                            "search_volume": 110000
                                        },
                                        {
                                            "year": 2021,
                                            "month": 11,
                                            "search_volume": 60500
                                        },
                                        {
                                            "year": 2021,
                                            "month": 10,
                                            "search_volume": 33100
                                        },
                                        {
                                            "year": 2021,
                                            "month": 9,
                                            "search_volume": 22200
                                        },
                                        {
                                            "year": 2021,
                                            "month": 8,
                                            "search_volume": 18100
                                        },
                                        {
                                            "year": 2021,
                                            "month": 7,
                                            "search_volume": 12100
                                        },
                                        {
                                            "year": 2021,
                                            "month": 6,
                                            "search_volume": 9900
                                        },
                                        {
                                            "year": 2021,
                                            "month": 5,
                                            "search_volume": 6600
                                        },
                                        {
                                            "year": 2021,
                                            "month": 4,
                                            "search_volume": 5400
                                        },
                                        {
                                            "year": 2021,
                                            "month": 3,
                                            "search_volume": 4400
                                        },
                                        {
                                            "year": 2021,
                                            "month": 2,
                                            "search_volume": 3600
                                        }
                                    ]
                                },
                                "keyword_properties": {
                                    "se_type": "google",
                                    "core_keyword": null,
                                    "keyword_difficulty": 77
                                },
                                "impressions_info": {
                                    "se_type": "google",
                                    "last_updated_time": "2022-03-17 00:01:42 +00:00",
                                    "bid": 999,
                                    "match_type": "exact",
                                    "ad_position_min": 1.3,
                                    "ad_position_max": 1,
                                    "ad_position_average": 1.19,
                                    "cpc_min": 180.05,
                                    "cpc_max": 220.07,
                                    "cpc_average": 200.06,
                                    "daily_impressions_min": 18.43,
                                    "daily_impressions_max": 22.53,
                                    "daily_impressions_average": 20.48,
                                    "daily_clicks_min": 1.29,
                                    "daily_clicks_max": 1.58,
                                    "daily_clicks_average": 1.44,
                                    "daily_cost_min": 258.63,
                                    "daily_cost_max": 316.1,
                                    "daily_cost_average": 287.36
                                },
                                "serp_info": {
                                    "se_type": "google",
                                    "check_url": "https://www.google.com/search?q=holidays%202022&num=100&hl=en&gl=US&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCQs2MuSEtepUEUK33kOSuTsc",
                                    "serp_item_types": [
                                        "organic",
                                        "people_also_ask",
                                        "top_stories",
                                        "images",
                                        "related_searches",
                                        "multi_carousel"
                                    ],
                                    "se_results_count": 4210000000,
                                    "last_updated_time": "2022-03-13 16:08:50 +00:00",
                                    "previous_updated_time": null
                                }
                            },
                            "depth": 1,
                            "related_keywords": [
                                "fun national holidays 2022",
                                "uk holidays 2022",
                                "jewish holidays 2022",
                                "corporate holidays 2022",
                                "us holidays 2022 february",
                                "august holidays 2022",
                                "april holidays 2022",
                                "may 2022 holidays"
                            ]
                        },
                        {
                            "se_type": "google",
                            "keyword_data": {
                                "se_type": "google",
                                "keyword": "list of holidays",
                                "location_code": 2840,
                                "language_code": "en",
                                "keyword_info": {
                                    "se_type": "google",
                                    "last_updated_time": "2022-03-19 00:01:55 +00:00",
                                    "competition": 0.005649600880814755,
                                    "cpc": 3.319643,
                                    "search_volume": 14800,
                                    "categories": [
                                        10006,
                                        10017,
                                        10151,
                                        10154,
                                        13509
                                    ],
                                    "monthly_searches": [
                                        {
                                            "year": 2022,
                                            "month": 2,
                                            "search_volume": 22200
                                        },
                                        {
                                            "year": 2022,
                                            "month": 1,
                                            "search_volume": 18100
                                        },
                                        {
                                            "year": 2021,
                                            "month": 12,
                                            "search_volume": 22200
                                        },
                                        {
                                            "year": 2021,
                                            "month": 11,
                                            "search_volume": 22200
                                        },
                                        {
                                            "year": 2021,
                                            "month": 10,
                                            "search_volume": 18100
                                        },
                                        {
                                            "year": 2021,
                                            "month": 9,
                                            "search_volume": 14800
                                        },
                                        {
                                            "year": 2021,
                                            "month": 8,
                                            "search_volume": 12100
                                        },
                                        {
                                            "year": 2021,
                                            "month": 7,
                                            "search_volume": 12100
                                        },
                                        {
                                            "year": 2021,
                                            "month": 6,
                                            "search_volume": 12100
                                        },
                                        {
                                            "year": 2021,
                                            "month": 5,
                                            "search_volume": 12100
                                        },
                                        {
                                            "year": 2021,
                                            "month": 4,
                                            "search_volume": 14800
                                        },
                                        {
                                            "year": 2021,
                                            "month": 3,
                                            "search_volume": 14800
                                        }
                                    ]
                                },
                                "keyword_properties": {
                                    "se_type": "google",
                                    "core_keyword": "holiday list",
                                    "keyword_difficulty": 89
                                },
                                "impressions_info": {
                                    "se_type": "google",
                                    "last_updated_time": "2022-03-18 17:18:13 +00:00",
                                    "bid": 999,
                                    "match_type": "exact",
                                    "ad_position_min": 1.11,
                                    "ad_position_max": 1,
                                    "ad_position_average": 1.06,
                                    "cpc_min": 23,
                                    "cpc_max": 28.11,
                                    "cpc_average": 25.56,
                                    "daily_impressions_min": 1.58,
                                    "daily_impressions_max": 1.93,
                                    "daily_impressions_average": 1.76,
                                    "daily_clicks_min": 0.1,
                                    "daily_clicks_max": 0.13,
                                    "daily_clicks_average": 0.11,
                                    "daily_cost_min": 2.63,
                                    "daily_cost_max": 3.21,
                                    "daily_cost_average": 2.92
                                },
                                "serp_info": {
                                    "se_type": "google",
                                    "check_url": "https://www.google.com/search?q=list%20of%20holidays&num=100&hl=en&gl=US&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCQs2MuSEtepUEUK33kOSuTsc",
                                    "serp_item_types": [
                                        "featured_snippet",
                                        "organic",
                                        "people_also_ask",
                                        "top_stories",
                                        "images",
                                        "video",
                                        "related_searches",
                                        "multi_carousel",
                                        "carousel",
                                        "knowledge_graph"
                                    ],
                                    "se_results_count": null,
                                    "last_updated_time": "2021-05-27 16:43:35 +00:00",
                                    "previous_updated_time": null
                                }
                            },
                            "depth": 1,
                            "related_keywords": [
                                "us holiday list 2021",
                                "holidays",
                                "holiday calendar 2021",
                                "us holiday list 2022",
                                "u.s. holidays",
                                "what holiday is tomorrow",
                                "holiday calendar 2022",
                                "what holiday is today"
                            ]
                        },
                        {
                            "se_type": "google",
                            "keyword_data": {
                                "se_type": "google",
                                "keyword": "holiday gas",
                                "location_code": 2840,
                                "language_code": "en",
                                "keyword_info": {
                                    "se_type": "google",
                                    "last_updated_time": "2022-03-20 21:29:18 +00:00",
                                    "competition": 0.01686046511627907,
                                    "cpc": 0.345666,
                                    "search_volume": 3600,
                                    "categories": [
                                        10004,
                                        10017,
                                        10018,
                                        10151,
                                        10160,
                                        10295,
                                        10829,
                                        12114
                                    ],
                                    "monthly_searches": [
                                        {
                                            "year": 2022,
                                            "month": 2,
                                            "search_volume": 3600
                                        },
                                        {
                                            "year": 2022,
                                            "month": 1,
                                            "search_volume": 3600
                                        },
                                        {
                                            "year": 2021,
                                            "month": 12,
                                            "search_volume": 5400
                                        },
                                        {
                                            "year": 2021,
                                            "month": 11,
                                            "search_volume": 3600
                                        },
                                        {
                                            "year": 2021,
                                            "month": 10,
                                            "search_volume": 4400
                                        },
                                        {
                                            "year": 2021,
                                            "month": 9,
                                            "search_volume": 2900
                                        },
                                        {
                                            "year": 2021,
                                            "month": 8,
                                            "search_volume": 3600
                                        },
                                        {
                                            "year": 2021,
                                            "month": 7,
                                            "search_volume": 3600
                                        },
                                        {
                                            "year": 2021,
                                            "month": 6,
                                            "search_volume": 2900
                                        },
                                        {
                                            "year": 2021,
                                            "month": 5,
                                            "search_volume": 2900
                                        },
                                        {
                                            "year": 2021,
                                            "month": 4,
                                            "search_volume": 2400
                                        },
                                        {
                                            "year": 2021,
                                            "month": 3,
                                            "search_volume": 2400
                                        }
                                    ]
                                },
                                "keyword_properties": {
                                    "se_type": "google",
                                    "core_keyword": null,
                                    "keyword_difficulty": 58
                                },
                                "impressions_info": {
                                    "se_type": "google",
                                    "last_updated_time": "2022-03-10 21:55:00 +00:00",
                                    "bid": 999,
                                    "match_type": "exact",
                                    "ad_position_min": null,
                                    "ad_position_max": null,
                                    "ad_position_average": null,
                                    "cpc_min": null,
                                    "cpc_max": null,
                                    "cpc_average": null,
                                    "daily_impressions_min": null,
                                    "daily_impressions_max": null,
                                    "daily_impressions_average": null,
                                    "daily_clicks_min": null,
                                    "daily_clicks_max": null,
                                    "daily_clicks_average": null,
                                    "daily_cost_min": null,
                                    "daily_cost_max": null,
                                    "daily_cost_average": null
                                },
                                "serp_info": {
                                    "se_type": "google",
                                    "check_url": "https://www.google.com/search?q=holiday%20gas&num=100&hl=en&gl=US&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCQs2MuSEtepUEUK33kOSuTsc",
                                    "serp_item_types": [
                                        "organic",
                                        "local_pack",
                                        "people_also_ask",
                                        "top_stories",
                                        "images",
                                        "related_searches"
                                    ],
                                    "se_results_count": 2630000000,
                                    "last_updated_time": "2022-03-14 00:05:05 +00:00",
                                    "previous_updated_time": null
                                }
                            },
                            "depth": 1,
                            "related_keywords": [
                                "holiday gas station prices",
                                "holiday gas station website",
                                "holiday gas station rewards",
                                "holiday gas station near me",
                                "holiday gas station game",
                                "holiday gas station game 2021",
                                "holiday gas coupon",
                                "holiday gas station menu"
                            ]
                        },
                        {
                            "se_type": "google",
                            "keyword_data": {
                                "se_type": "google",
                                "keyword": "holiday meaning",
                                "location_code": 2840,
                                "language_code": "en",
                                "keyword_info": {
                                    "se_type": "google",
                                    "last_updated_time": "2022-03-18 14:52:48 +00:00",
                                    "competition": 9.467007478935907e-5,
                                    "cpc": null,
                                    "search_volume": 2400,
                                    "categories": [
                                        10013,
                                        10017,
                                        10108,
                                        10109,
                                        10589,
                                        10756,
                                        13429
                                    ],
                                    "monthly_searches": [
                                        {
                                            "year": 2022,
                                            "month": 2,
                                            "search_volume": 1600
                                        },
                                        {
                                            "year": 2022,
                                            "month": 1,
                                            "search_volume": 1900
                                        },
                                        {
                                            "year": 2021,
                                            "month": 12,
                                            "search_volume": 6600
                                        },
                                        {
                                            "year": 2021,
                                            "month": 11,
                                            "search_volume": 4400
                                        },
                                        {
                                            "year": 2021,
                                            "month": 10,
                                            "search_volume": 2400
                                        },
                                        {
                                            "year": 2021,
                                            "month": 9,
                                            "search_volume": 1900
                                        },
                                        {
                                            "year": 2021,
                                            "month": 8,
                                            "search_volume": 1300
                                        },
                                        {
                                            "year": 2021,
                                            "month": 7,
                                            "search_volume": 1600
                                        },
                                        {
                                            "year": 2021,
                                            "month": 6,
                                            "search_volume": 1300
                                        },
                                        {
                                            "year": 2021,
                                            "month": 5,
                                            "search_volume": 1300
                                        },
                                        {
                                            "year": 2021,
                                            "month": 4,
                                            "search_volume": 1300
                                        },
                                        {
                                            "year": 2021,
                                            "month": 3,
                                            "search_volume": 2400
                                        }
                                    ]
                                },
                                "keyword_properties": {
                                    "se_type": "google",
                                    "core_keyword": null,
                                    "keyword_difficulty": 58
                                },
                                "impressions_info": {
                                    "se_type": "google",
                                    "last_updated_time": "2022-03-18 03:26:53 +00:00",
                                    "bid": 999,
                                    "match_type": "exact",
                                    "ad_position_min": null,
                                    "ad_position_max": null,
                                    "ad_position_average": null,
                                    "cpc_min": null,
                                    "cpc_max": null,
                                    "cpc_average": null,
                                    "daily_impressions_min": null,
                                    "daily_impressions_max": null,
                                    "daily_impressions_average": null,
                                    "daily_clicks_min": null,
                                    "daily_clicks_max": null,
                                    "daily_clicks_average": null,
                                    "daily_cost_min": null,
                                    "daily_cost_max": null,
                                    "daily_cost_average": null
                                },
                                "serp_info": {
                                    "se_type": "google",
                                    "check_url": "https://www.google.com/search?q=holiday%20meaning&num=100&hl=en&gl=US&gws_rd=cr&ie=UTF-8&oe=UTF-8&uule=w+CAIQIFISCQs2MuSEtepUEUK33kOSuTsc",
                                    "serp_item_types": [
                                        "answer_box",
                                        "people_also_ask",
                                        "organic",
                                        "related_searches"
                                    ],
                                    "se_results_count": 3060000000,
                                    "last_updated_time": "2022-03-14 13:49:39 +00:00",
                                    "previous_updated_time": null
                                }
                            },
                            "depth": 1,
                            "related_keywords": [
                                "school holiday meaning",
                                "holiday meaning in hindi",
                                "holiday meaning in arabic",
                                "public holiday meaning",
                                "holiday meaning in urdu",
                                "take holiday meaning",
                                "holiday meaning in american english",
                                "holiday definition origin"
                            ]
                        }
                    ]
                }
            ]
        }
    ]
}

That’s because when you set replace_with_core_keyword to true, the API returns SERP info and related keywords not for the keyword specified in a POST request, but for the core keyword that the term specified in a POST request belongs to. That’s what the new parameter is all about.

Thus, if our API fails to find SERP info or related keywords for some keyword, that means we already have data for a very similar term in our database. Adding replace_with_core_keyword: "true" to your POST request will enable you to access it.

Embed DataForSeo widget on your website


Embed code:
Preview: