Merchant Center best sellers
get_gmc_best_sellersGoogle's best sellers ranking for one country from the Google Merchant Center account linked to a GSC Wizard site: the most popular product clusters ("product_cluster", the default) or brands ("brand") per Google product category, with rank, previous rank, relative demand (VERY_LOW..VERY_HIGH), its direction (SINKER / FLAT / RISER) and, for product clusters, whether any of your offers matches (inventoryStatus). Each product-cluster row carries demandGap: true when Google ranks the cluster but you do not stock it, the classic assortment-gap signal; note that inventory status ignores the report country. Pick WEEKLY (Monday-dated) or MONTHLY (1st-dated) reports; omit reportDate for the newest report Google has published (reports lag up to two weeks). countryCode is required because the Merchant API answers one country per request; categoryId (Google product taxonomy id) narrows to one category, otherwise every top-level category is returned. reportUnavailable (with no rows) means Google refuses this report for the Merchant Center account (eligibility); the other reports are unaffected. Returns a notConfigured result (not an error) when Merchant Center is not connected or no Merchant Center account is linked to the site in the GSC Wizard app.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| view | No | "product_cluster" (ranked product clusters with title, category path, GTINs and your inventory status, the default) or "brand" (ranked brands, no inventory data). | product_cluster |
| limit | No | Rows to return, ordered by (country, category, rank) (default 100, max 1000). | |
| siteUrl | Yes | The property URL as returned by list_sites (e.g. "sc-domain:example.com"). | |
| categoryId | No | Optional. Google product taxonomy id as a digits-only string (e.g. "166" for Apparel & Accessories). Omit for every top-level category. | |
| reportDate | No | Optional. The report to read as YYYY-MM-DD: a Monday for WEEKLY, the 1st of a month for MONTHLY. Omit for the newest published report (recommended: reports lag up to two weeks). Never pass null or the string "null". | |
| countryCode | Yes | Required. Report country as ISO 3166-1 alpha-2 (e.g. "US", "NL"). Case-insensitive. | |
| granularity | No | "WEEKLY" (Monday-dated reports, the default) or "MONTHLY" (1st-of-month reports). | WEEKLY |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hint | No | ||
| rows | No | ||
| view | No | ||
| range | No | ||
| reason | No | ||
| account | No | ||
| hasMore | No | ||
| lagNote | No | ||
| siteUrl | No | ||
| cachedAt | No | ||
| rowCount | No | ||
| emptyNote | No | ||
| truncated | No | ||
| categoryId | No | ||
| dataSource | No | ||
| reportDate | No | ||
| countryCode | No | ||
| granularity | No | ||
| reportsSeen | No | ||
| gmcAccountId | No | ||
| countryCaveat | No | ||
| notConfigured | No | ||
| demandGapCount | No | ||
| truncationNote | No | ||
| fetchedRowCount | No | ||
| truncationReason | No | ||
| reportUnavailable | No | ||
| requestedReportDate | No |