Merchants are responsible for complying with the free
listings policies. Google
Shopping reserves the right to enforce these policies and respond appropriately
if we find content or behavior that violates these policies.
get
You can use the
freelistingprogram.get method to get
the current status of your free listings. This method requires your merchantID
and returns an instance of
freelistingprogramstatus with the current
approval status and review eligibility. If your free listings are enrolled in
multiple regions, get returns a freelistingprogramstatus resource for each
region.
GET https://shoppingcontent.googleapis.com/content/v2.1/merchantId/freelistingprogram
Here's a sample response:
{"globalState":"NOT_ENABLED","regionStatuses":[{"regionCodes":["US"],"eligibilityStatus":"DISAPPROVED","reviewIssues":["editorial_and_professional_standards_destination_url_down_policy"],"onboardingIssues":["home_page_issue"],"disapprovalDate":"2013-02-25","reviewEligibilityStatus":"INELIGIBLE","reviewIneligibilityReason":"IN_COOLDOWN_PERIOD","reviewIneligibilityReasonDescription":"Cool down applies: Wait for one-week cool-down period to end before you can request a review from Google. End of cool down is 2013-02-30","reviewIneligibilityReasonDetails":{"cooldownTime":"2013-02-30"}}]}
There are three cases where an issue has the severity WARNING:
Warnings that turn into disapprovals if you don't resolve them by the
deadline.
Warnings that don't have a deadline or turn into disapprovals, but limit the
impressions for your products.
Warnings that don't have a deadline and don't impact the impressions for
your products.
This method returns errors and warnings if they require action to resolve, will
become disapprovals, or impact impressions. Use account
statuses to view all issues impacting
an account, regardless of severity.
requestreview
Some issues require a review of your free listings. You can use the
freelistingprogram.requestreview
method to request a review after making changes. This method requires your
merchantId and
regionCode, and returns an
empty response body if completed successfully.
You need to do the following before you can request a review:
[[["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-13 UTC."],[[["\u003cp\u003eThe Merchant API is the new version of the Content API for Shopping and represents the future of the platform.\u003c/p\u003e\n"],["\u003cp\u003eYou can use the \u003ccode\u003efreelistingprogram.get\u003c/code\u003e method to check the status of your free listings, including approval status and review eligibility.\u003c/p\u003e\n"],["\u003cp\u003eSome issues with free listings may require a review, which can be requested using the \u003ccode\u003efreelistingprogram.requestreview\u003c/code\u003e method after addressing any identified problems.\u003c/p\u003e\n"],["\u003cp\u003eMerchants are responsible for adhering to free listing policies, and Google Shopping reserves the right to enforce these policies.\u003c/p\u003e\n"],["\u003cp\u003eTo view comprehensive account information and issues, including those beyond free listings, refer to the Account Statuses guide.\u003c/p\u003e\n"]]],["The Merchant API's beta version is introduced as the future of the Content API for Shopping. Merchants can check the status of free listings per region using `freelistingprogram.get`, which returns approval status and eligibility. The `freelistingprogram.requestreview` method allows merchants to request a review of their free listings program for a specific region after resolving issues and meeting specific requirements like providing address, phone, website and uploading products. Warnings of various severity may impact product impressions. A general review of account statuses is available.\n"],null,["# Free listings\n\nYou can use [`freelistingprogram.get`](/shopping-content/reference/rest/v2.1/freelistingsprogram/get) to\nget the current status of [free\nlistings](//support.google.com/merchants/answer/9199328) for a specific region.\n\nSee the [Shopping ads guide](/shopping-content/guides/review-shopping-ads) for\nproblems with your [Shopping ads](/google-ads/api/docs/shopping-ads/overview),\nand the [Account Statuses guide](/shopping-content/guides/accountstatuses) for\naccount information and issues.\n\nMerchants are responsible for complying with the [free\nlistings](//support.google.com/merchants/answer/9261529) policies. Google\nShopping reserves the right to enforce these policies and respond appropriately\nif we find content or behavior that violates these policies.\n\nget\n---\n\nYou can use the\n[`freelistingprogram.get`](/shopping-content/reference/rest/v2.1/freelistingsprogram/get) method to get\nthe current status of your free listings. This method requires your `merchantID`\nand returns an instance of\n[`freelistingprogramstatus`](/shopping-content/reference/rest/v2.1/freelistingsprogram) with the current\napproval status and review eligibility. If your free listings are enrolled in\nmultiple regions, `get` returns a `freelistingprogramstatus` resource for each\nregion. \n\n GET https://shoppingcontent.googleapis.com/content/v2.1/\u003cvar translate=\"no\"\u003emerchantId\u003c/var\u003e/freelistingprogram\n\nHere's a sample response: \n\n {\n \"globalState\": \"NOT_ENABLED\",\n \"regionStatuses\": [\n {\n \"regionCodes\": [\n \"US\"\n ],\n \"eligibilityStatus\": \"DISAPPROVED\",\n \"reviewIssues\": [\n \"editorial_and_professional_standards_destination_url_down_policy\"\n ],\n \"onboardingIssues\": [\n \"home_page_issue\"\n ],\n \"disapprovalDate\": \"2013-02-25\",\n \"reviewEligibilityStatus\": \"INELIGIBLE\",\n \"reviewIneligibilityReason\": \"IN_COOLDOWN_PERIOD\",\n \"reviewIneligibilityReasonDescription\": \"Cool down applies: Wait for one-week cool-down period to end before you can request a review from Google. End of cool down is 2013-02-30\",\n \"reviewIneligibilityReasonDetails\": {\n \"cooldownTime\": \"2013-02-30\"\n }\n }\n ]\n }\n\nThere are three cases where an issue has the severity `WARNING`:\n\n- Warnings that turn into disapprovals if you don't resolve them by the deadline.\n- Warnings that don't have a deadline or turn into disapprovals, but limit the impressions for your products.\n- Warnings that don't have a deadline and don't impact the impressions for your products.\n\nThis method returns errors and warnings if they require action to resolve, will\nbecome disapprovals, or impact impressions. Use [account\nstatuses](/shopping-content/guides/accountstatuses) to view all issues impacting\nan account, regardless of severity.\n\nrequestreview\n-------------\n\n| **Deprecated:** We recommend using the [Merchant Support\n| service](/shopping-content/guides/merchant-support) to view the status and request reviews of your products and account.\n\nSome issues require a review of your free listings. You can use the\n[`freelistingprogram.requestreview`](/shopping-content/reference/rest/v2.1/freelistingsprogram/requestreview)\nmethod to request a review after making changes. This method requires your\n`merchantId` and\n[`regionCode`](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2), and returns an\nempty response body if completed successfully.\n\nYou need to do the following before you can request a review:\n\n- Have an [address](/shopping-content/reference/rest/v2.1/accounts#AccountAddress).\n- [Verify a phone number](/shopping-content/guides/phoneverification).\n- [Claim a website](//support.google.com/merchants/answer/176793).\n- [Upload products](/shopping-content/guides/products/overview).\n\n**Note:** The review is of your entire free listings program for a specific region. Fix all issues for that region then raise a single review request. \n\n POST https://shoppingcontent.googleapis.com/content/v2.1/\u003cvar translate=\"no\"\u003emerchantId\u003c/var\u003e/freelistingsprogram/requestreview\n\nAfter a successful request, the `eligibilityStatus`of your account changes to\n`PENDING_REVIEW`."]]