API to Retrieve Keyword Suggestions Using URL

[Amit Tomar]

Dear Team,

I am currently working with Ad Group APIs and would like to know if there is an available API that provides keyword suggestions based on a given URL, similar to the functionality in the Google Ads UI (as shown in the attached screenshot). For example, entering the Decathlon website URL suggests keywords along with their relevance scores.

Could you please guide me on which API or endpoint can be used to achieve this?

Thank you for your assistance.

[Google Ads API Forum Advisor]

Hi,

Thank you for reaching out to the Google Ads API support team.

I would recommend you to refer to the GenerateKeywordIdeasRequest feature, which is used to provide keyword suggestions based on a specified URL. This functionality is accessible via the customers.generateKeywordIdeas service. It utilizes the seed union field to generate keyword ideas, where the seed field must be one of the following types: KeywordAndUrlSeed, KeywordSeed, UrlSeed, SiteSeed. 

Specifically, when you choose the UrlSeed option, the service focuses on generating keyword suggestions related to the specified URL. This can be particularly useful for optimizing your content or targeting specific keywords relevant to a webpage (url).

 

Thanks,
 

Google Ads API Team

Feedback
How was our support today?

               
[2025-04-30 22:57:50Z GMT] This message is in relation to case "ref:!00D1U01174p.!500Ht01qVTx7:ref" (ADR-00303099)

[Amit Tomar]

Hello,

I hope you are doing well.

I am currently using the GenerateKeywordIdeasRequest method from the Google Ads API to generate keyword suggestions based on a website URL. While the API is returning results, I have noticed some differences compared to the suggestions shown in the Google Ads UI. I would appreciate your clarification on the following points to help ensure parity between the UI and API outputs:

Points for Clarification:

1. Keyword Suggestions Based on "Product or Service" Input:

   • In the Google Ads UI (under the "Get keyword ideas" section), there is an option to input a "product or service" alongside or instead of a website URL.

   • Could you please confirm which seed type (KeywordSeed, KeywordAndUrlSeed, etc.) corresponds to this functionality in the API?

   • Is there any specific recommendation for how to use this feature effectively via the API?

2. Differences in Keyword Suggestions Between API and UI (for URL input):

   • I observe that the suggested keywords in the UI differ from those returned by the API, even when using the same landing page URL.

   • Are there any additional fields or parameters I should pass in the GenerateKeywordIdeasRequest to better align API results with what is shown in the UI?

   • Does the API omit any filtering, prioritization, or personalization logic that the UI includes?

3. Relevance Score:

   • In the UI, each keyword suggestion includes a "Relevance" score (e.g., 99, 94, 89).

   • Could you please confirm whether this relevance score is available through the API, and if not, is there any alternative metric or approach recommended to approximate it?

I would greatly appreciate your guidance on the above points so I can ensure I am leveraging the API correctly and effectively.

[Amit Tomar]

Hi Team,

just following up on my question posted yesterday. I haven’t received a response yet and would appreciate any guidance or input.

Thanks in advance!

[Google Ads API Forum Advisor]

Hi,

Thank you for reaching out to the Google Ads API support team.

After reviewing your concern, I understand that you are observing the data discrepancy in the values of Keyword Planner between the Google Ads UI and the API. Please find the answers for your questions below:

1. Could you please confirm which seed type (KeywordSeed, KeywordAndUrlSeed, etc.) corresponds to this functionality in the API?

I would suggest you to use UrlSeed for the URL of a webpage or entire website related to your business. The URL seed targets only a specific URL. If there are no hits, the search automatically expands up to the pages from the same domain.

2. Are there any additional fields or parameters I should pass in the GenerateKeywordIdeasRequest to better align API results with what is shown in the UI?

I would suggest you to exactly match the API and UI with all the filters mentioned in this link.

3. Could you please confirm whether this relevance score is available through the API, and if not, is there any alternative metric or approach recommended to approximate it?

Kindly note that  the relevance score (like 99, 94, 89) displayed in the Google Ads UI's Keyword Planner is not directly available through the Google Ads API. You can see that there is no field for "relevance score" in KeywordPlanIdeaService.GenerateKeywordIdeas.

If you still face descripancies after following the above suggestions, kindly provide us with the complete API logs (request and response logs with request-id and request header) generated at your end along with the corresponding uncropped UI screenshot (from Google Ads account) highlighting the keywords generated.

If you are using a client library and haven't enabled the logging yet, I would request you to enable logging for the specific client library that you are using. You can refer to the guides Java, .Net, PHP, Python, Ruby or Perl to enable logging at your end. For REST interface requests, you can enable logging via the curl command by using the -i flag.

Thanks,
 

Google Ads API Team

Feedback
How was our support today?

               

[2025-05-02 09:04:10Z GMT] This message is in relation to case "ref:!00D1U01174p.!500Ht01qVTx7:ref" (ADR-00303099)