Merchant listings performance
get_merchant_listings_performanceSearch Console performance for one search appearance, defaulting to MERCHANT_LISTINGS: the appearance inventory of the property, a daily clicks / impressions / CTR / position timeline, and the top pages (product URLs) behind it. Answers "how visible are my product results in Search, and which products carry it". Search Console merchant listings counts enriched product results in web Search only, while Google Merchant Center free-listing numbers (get_organic_shopping_performance) cover the Shopping tab, Images, Lens, YouTube and Maps too, so the two do not reconcile to one figure. Always served from the live Search Console API: search appearance is never stored in the GSC Wizard warehouse, and it can be filtered on but never grouped with another dimension. hasAppearance is false when the property has no rows for the requested appearance, which is normal for non-ecommerce sites. The window may span at most 16 months (Search Console retention); a longer one is rejected with bad_request. Date range is optional: omit startDate/endDate to analyze the last 28 settled days (data lags ~2-3 days).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Top pages to return, ordered by clicks (default 25, max 1000). | |
| endDate | No | Optional. Window end as YYYY-MM-DD (e.g. 2026-05-31). You do NOT need to know today's date or the latest available date: omit this and the server uses the latest settled Search Console date (data lags ~2-3 days behind today). Never pass null or the string "null". | |
| siteUrl | Yes | The property URL as returned by list_sites (e.g. "sc-domain:example.com"). | |
| startDate | No | Optional. Window start as YYYY-MM-DD (e.g. 2026-05-03). You do NOT need to know today's date. Omit BOTH startDate and endDate to analyze the last 28 settled days automatically (Search Console data lags ~2-3 days). Never pass null or the string "null". | |
| appearance | No | Search appearance code to report on. Defaults to MERCHANT_LISTINGS; other common values are PRODUCT_SNIPPETS and ORGANIC_SHOPPING. Read `appearances` in the response to see which codes this property actually has. | MERCHANT_LISTINGS |
| includeAppearances | No | Include the unfiltered per-appearance breakdown, which is the only way to learn which appearance codes the property has and how big each one is. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| pages | No | ||
| totals | No | ||
| endDate | No | ||
| hasMore | No | ||
| siteUrl | No | ||
| rowCount | No | ||
| timeline | No | ||
| emptyNote | No | ||
| startDate | No | ||
| appearance | No | ||
| dataSource | No | ||
| searchType | No | ||
| appearances | No | ||
| dataMaturity | No | ||
| hasAppearance | No | ||
| settledThrough | No | ||
| warehouseLatestDate | No |