How can I query an ad's quality score using GAQL?

[MS]

Hi,

I'd like to query our ads' quality score using GAQL. How would I do that?

Your help is appreciated.

[Google Ads API Forum Advisor]

Hi,

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

In order to assist you further, could you provide the uncropped screenshot of the UI by highlighting the fields you wanted to retrieve from the API with the visibility of Google Ads customer ID.

You can send the details via Reply privately to the author option or direct private reply to this email.

 

Thanks,
 

Google Ads API Team

Feedback
How was our support today?

               
[2025-10-08 15:48:34Z GMT] This message is in relation to case "ref:!00D1U01174p.!500Ht01u8YXz:ref" (ADR-00334936)

[MS]

Hi,

there is no screenshot to provide with Google Ads Query Language (GAQL).

Perhaps I didn't phrase my question the best way. Let me rephrase it: What is the GAQL query for querying an ad's quality score?

Your helps is appreciated.

[Google Ads API Forum Advisor]

Hi,

Based on the information provided, I understand that you are trying to retrieve the quality score for an ad using the Google Ads API. Kindly note that 'Quality Score' is a diagnostic tool meant to give you a sense of how well your ad quality compares to other advertisers. This score is measured on a scale from 1-10 and available at the keyword level. I would recommend you to refer to this help center article for more detailed information. Currently, there is no way to compare the 'Quality Score' at the ad level instead you can compare the quality score at the keyword level. I would recommend you to use the keyword_view report to fetch the quality score at a keyword level. However, I am providing you the sample GAQL query to fetch the 'Quality Score' at the keyword level:

SELECT keyword_view.resource_name, ad_group_criterion.criterion_id, ad_group_criterion.type, 
ad_group_criterion.quality_info.quality_score FROM keyword_view WHERE 
ad_group_criterion.criterion_id = {ad_group_criterion_ID} AND ad_group_criterion.type = 'KEYWORD'

You can use the search or searchStream methods in making the API calls while retrieving the data. Additionally, you can utilize the Google Ads Query Builder and Query Validator to build and validate the queries for retrieving the data from the Google Ads API.
 

Thanks,
 

Google Ads API Team

Feedback
How was our support today?

               

[2025-10-09 02:44:58Z GMT] This message is in relation to case "ref:!00D1U01174p.!500Ht01u8YXz:ref" (ADR-00334936)