Free listings

You can use freelistingprogram.get to get the current status of free listings for a specific region.

Selected merchants can use freelistingprogram.requestreview to request a review of their free listings after making changes. Submit this form to request early access to freelistingprogram.requestreview.

See the Shopping ads guide for problems with your Shopping ads, and the Account Statuses guide for account information and issues.

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"
      }
    }
  ]
}

requestreview

This method is only available to selected merchants. Submit this form to request early access to freelistingprogram.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:

• Have an address.
• Verify a phone number.
• Claim a website.
• Upload products.

Note: The review is of your entire free listings program for a specific region, so please fix all issues for that region then raise a single review request.

POST https://shoppingcontent.googleapis.com/content/v2.1/merchantId/freelistingsprogram/requestreview

After a successful request, the eligibilityStatusof your account changes to PENDING_REVIEW.