Stay organized with collectionsSave and categorize content based on your preferences.
Thecompetitive visibility
reporthelps you understand
your competitive landscape on a product category level, and take action to
improve your visibility based on displayed impressions from your Shopping ads
and organic listings. For information on specific products and brands, see thebest sellers
reports.
Your account must meet minimum eligibility requirements, and you must ensure
that your use, or any third party's use, of Competitive visibility data complies
with theMerchant Center terms and
conditions.
See which reportingtables and
fieldsare
available with the Merchant API.
Competitive visibility data
Competitive visibility data is grouped by country,Google product
categoryand traffic source.
You must specify country and category values in aWHEREclause for all
competitive visibility queries. You can change the values in theWHEREclause
to customize the report for dates, traffic sources, countries, and categories.
Queries with multiple country and category values might take longer to execute,
or time out.
View businesses with similar visibility
You can querycompetitive_visibility_competitor_viewto view businesses with a
similar number of impressions to your business.
Here's a sample. To make the request, pass the following Merchant Center Query
Language statement to theaccounts.reports.searchmethod:
You can querycompetitive_visibility_top_merchant_viewto see which businesses
are getting the most impressions across Google in a specific category, and how
your business compares.
You can querycompetitive_visibility_benchmark_viewto see how your number of
impressions trends over time compared to the average trend of other sellers.
Here's a sample. To make the request, pass the following Merchant Center Query
Language statement to theaccounts.reports.searchmethod:
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Missing the information I need","missingTheInformationINeed","thumb-down"],["Too complicated / too many steps","tooComplicatedTooManySteps","thumb-down"],["Out of date","outOfDate","thumb-down"],["Samples / code issue","samplesCodeIssue","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-07 UTC."],[[["\u003cp\u003eThe Competitive Visibility report helps you understand your product category's competitive landscape on Google Shopping and organic listings, allowing you to improve your visibility based on impression data.\u003c/p\u003e\n"],["\u003cp\u003eYou can identify businesses with similar and highest visibility, compare your visibility to the category benchmark, and customize reports by date, traffic source, country, and category using the Merchant Center Query Language.\u003c/p\u003e\n"],["\u003cp\u003eTo access Competitive Visibility data, your account must meet eligibility requirements and comply with Merchant Center terms and conditions.\u003c/p\u003e\n"],["\u003cp\u003eData is grouped by country, Google product category, and traffic source, requiring specification of country and category values in queries.\u003c/p\u003e\n"],["\u003cp\u003eThree distinct views—\u003ccode\u003ecompetitive_visibility_competitor_view\u003c/code\u003e, \u003ccode\u003ecompetitive_visibility_top_merchant_view\u003c/code\u003e, and \u003ccode\u003ecompetitive_visibility_benchmark_view\u003c/code\u003e—offer insights into different aspects of competitive visibility, each with its own set of queryable fields.\u003c/p\u003e\n"]]],["The competitive visibility report analyzes product category performance, focusing on Shopping ads and organic listings. Users query data using `competitive_visibility_competitor_view`, `competitive_visibility_top_merchant_view`, or `competitive_visibility_benchmark_view`. These queries, specifying country, category, and traffic source, reveal businesses with similar visibility, top-performing businesses, and visibility trends relative to category benchmarks. Customizable reports adjust for dates, traffic, and categories, enabling insight into the competitive landscape.\n"],null,["# Explore your competitive landscape\n\nThe [competitive visibility\nreport](//support.google.com/merchants/answer/11366442) helps you understand\nyour competitive landscape on a product category level, and take action to\nimprove your visibility based on displayed impressions from your Shopping ads\nand organic listings. For information on specific products and brands, see the\n[best sellers\nreports](/merchant/api/guides/reports/understand-the-market#identify_best-sellers).\n\nYour account must meet minimum eligibility requirements, and you must ensure\nthat your use, or any third party's use, of Competitive visibility data complies\nwith the [Merchant Center terms and\nconditions](//support.google.com/merchants/answer/12628444).\n\nSee which reporting [tables and\nfields](/merchant/api/reference/rest/reports_v1/accounts.reports/search) are\navailable with the Merchant API.\n\nCompetitive visibility data\n---------------------------\n\nCompetitive visibility data is grouped by country, [Google product\ncategory](//support.google.com/merchants/answer/6324436) and traffic source.\n\nYou must specify country and category values in a `WHERE` clause for all\ncompetitive visibility queries. You can change the values in the `WHERE` clause\nto customize the report for dates, traffic sources, countries, and categories.\n\nQueries with multiple country and category values might take longer to execute,\nor time out.\n\nView businesses with similar visibility\n---------------------------------------\n\nYou can query `competitive_visibility_competitor_view` to view businesses with a\nsimilar number of impressions to your business.\n\nHere's a sample. To make the request, pass the following Merchant Center Query\nLanguage statement to the\n[`accounts.reports.search`](/merchant/api/reference/rest/reports_v1/accounts.reports/search)\nmethod: \n\n SELECT\n report_country_code,\n report_category_id,\n traffic_source,\n domain,\n is_your_domain,\n rank,\n ads_organic_ratio,\n page_overlap_rate,\n higher_position_rate,\n relative_visibility\n FROM competitive_visibility_competitor_view\n WHERE date BETWEEN '2023-06-02' AND '2023-06-27'\n AND report_country_code = 'US'\n AND report_category_id = 536\n AND traffic_source = 'ADS'\n ORDER BY rank\n\nYou can change the values in the `WHERE` clause to customize the report for\nother dates, traffic sources, countries, and\n[categories](//support.google.com/merchants/answer/6324436).\n\nHere's a sample response from the preceding query: \n\n {\n \"results\": [\n {\n \"competitiveVisibilityCompetitorView\": {\n \"reportCountryCode\": \"US\",\n \"reportCategoryId\": \"536\",\n \"trafficSource\": \"ADS\",\n \"domain\": \"examplepetstore.com\",\n \"isYourDomain\": false,\n \"rank\": \"4\",\n \"adsOrganicRatio\": 8,\n \"pageOverlapRate\": 0.19,\n \"higherPositionRate\": 0.46,\n \"relativeVisibility\": 0.5\n }\n },\n {\n \"competitiveVisibilityCompetitorView\": {\n \"reportCountryCode\": \"US\",\n \"reportCategoryId\": \"536\",\n \"trafficSource\": \"ADS\",\n \"domain\": \"example.com\",\n \"isYourDomain\": true,\n \"rank\": \"5\",\n \"adsOrganicRatio\": 30,\n \"pageOverlapRate\": 1,\n \"higherPositionRate\": 0,\n \"relativeVisibility\": 0\n }\n },\n ]\n }\n\nFor more information about the fields available for query, see the [Fields in `competitiveVisibilityCompetitorView` table](/merchant/api/reference/rest/reports_v1/accounts.reports#CompetitiveVisibilityCompetitorView.FIELDS).\n\nView businesses with highest visibility\n---------------------------------------\n\nYou can query `competitive_visibility_top_merchant_view` to see which businesses\nare getting the most impressions across Google in a specific category, and how\nyour business compares.\n\nHere's a sample. To make the request, pass the following [Merchant Center Query\nLanguage](/merchant/api/guides/reports/query-language) statement to the\n[`accounts.reports.search`](/merchant/api/reference/rest/reports_v1/accounts.reports/search)\nmethod: \n\n SELECT\n report_country_code,\n report_category_id,\n traffic_source,\n domain,\n is_your_domain,\n rank,\n ads_organic_ratio,\n page_overlap_rate,\n higher_position_rate\n FROM competitive_visibility_top_merchant_view\n WHERE date BETWEEN '2022-08-01' AND '2022-09-01'\n AND report_country_code = 'US'\n AND report_category_id = 100\n AND traffic_source = 'ORGANIC'\n ORDER BY rank\n\nHere's a sample response from the preceding query: \n\n {\n \"results\": [\n {\n \"competitiveVisibilityTopMerchantView\": {\n \"reportCountryCode\": \"US\",\n \"reportCategoryId\": \"100\",\n \"trafficSource\": \"ORGANIC\",\n \"domain\": \"examplepetstore.com\",\n \"isYourDomain\": false,\n \"rank\": \"1\",\n \"adsOrganicRatio\": 0.2,\n \"pageOverlapRate\": 0.3,\n \"higherPositionRate\": 0.45\n }\n },\n {\n \"competitiveVisibilityTopMerchantView\": {\n \"reportCountryCode\": \"US\",\n \"reportCategoryId\": \"100\",\n \"trafficSource\": \"ORGANIC\",\n \"domain\": \"example.com\",\n \"isYourDomain\": false,\n \"rank\": \"2\",\n \"adsOrganicRatio\": 5,\n \"pageOverlapRate\": 0.67,\n \"higherPositionRate\": 0.89\n }\n },\n ]\n }\n\nFor more information about the fields available for query, see the [Fields in `competitiveVisibilityTopMerchantView` table](/merchant/api/reference/rest/reports_v1/accounts.reports#CompetitiveVisibilityTopMerchantView.FIELDS).\n\nCompare your visibility to the category benchmark\n-------------------------------------------------\n\nYou can query `competitive_visibility_benchmark_view` to see how your number of\nimpressions trends over time compared to the average trend of other sellers.\n\nHere's a sample. To make the request, pass the following Merchant Center Query\nLanguage statement to the\n[`accounts.reports.search`](/merchant/api/reference/rest/reports_v1/accounts.reports/search)\nmethod: \n\n SELECT\n report_country_code,\n report_category_id,\n traffic_source,\n date,\n your_domain_visibility_trend,\n category_benchmark_visibility_trend\n FROM competitive_visibility_benchmark_view\n WHERE date BETWEEN '2022-09-01' AND '2022-09-07'\n AND report_country_code = 'US'\n AND report_category_id = 100\n AND traffic_source = 'ORGANIC'\n ORDER BY date\n\nHere's a sample response from the preceding query: \n\n {\n \"results\": [\n {\n \"competitiveVisibilityBenchmarkView\": {\n \"date\": {\n \"year\": 2022,\n \"month\": 9,\n \"day\": 1\n },\n \"reportCountryCode\": \"US\",\n \"reportCategoryId\": \"100\",\n \"trafficSource\": \"ORGANIC\",\n \"yourDomainVisibilityTrend\": 0,\n \"categoryBenchmarkVisibilityTrend\": 0\n }\n },\n {\n \"competitiveVisibilityBenchmarkView\": {\n \"date\": {\n \"year\": 2022,\n \"month\": 9,\n \"day\": 2\n },\n \"reportCountryCode\": \"US\",\n \"reportCategoryId\": \"100\",\n \"trafficSource\": \"ORGANIC\",\n \"yourDomainVisibilityTrend\": 0.3,\n \"categoryBenchmarkVisibilityTrend\": -0.15\n }\n },\n ]\n }\n\nFor more information about the fields available for query, see the [Fields in `competitiveVisibilityBenchmarkView` table](/merchant/api/reference/rest/reports_v1/accounts.reports#CompetitiveVisibilityBenchmarkView.FIELDS)."]]
