Manage Listings
You’ve successfully created and updated locations on the Yext platform. Now, you probably want to see where your locations appear on the Yext PowerListings® Network. The PowerListings® Network consists of over 60 publishers who display your business data. Publishers includes sites such as Google, Facebook, Yelp, and Yahoo, as well as mobile apps like Navmii. These sites not only display your business data but also provide you with feedback about your data, analytics, and reviews. So, let’s see what we can do!

NOTE: To follow the steps in this guide, you must use a production account with an active Listings subscription. Otherwise, many of the requests below will return empty responses.

Retrieve a list of publishers

Before we find out the specifics about your listings, it may be helpful to see which publishers you have access to. You can see these publishers by making this API request:

GET https://api.yext.com/v2/accounts/me/powerlistings/publishers?api_key=API_KEY&v=YYYYMMDD

The returned response will look similar to the following:
{
  "meta": {
    "uuid": "5cfdb129-c10c-43e5-89d4-2957693de4eb",
    "errors": [
      
    ]
  },
  "response": [
    {
      "id": "427",
      "name": "Yellow Cauldron",
      "alternateBrands": [
        {
          "name": "Yellow Cauldron",
          "url": ""
        }
      ],
      "supportedCountries": ["DE","PR","HK","TW","PT","DK","LU","DO","UA","HU","QA",
"MA","ID","IE","US","MN","EG","MO","IL","AE","UY","IN","ZA","IT","MX","MY","ES","VE",
"AR","VG","AT","VI","AU","AW","VN","NG","RO","NL","BB","NO","BD","BE","FI","JM","RU",
"JO","BH","JP","BM","BN","FR","NZ","SA","BR","BS","SE","SG","GB","CA","SV","CH","KR",
"CL","CN","GR","CO","KW","GU","CR","KZ","TC","PA","TH","PE","CY","LB","CZ","PH","PL",
"TR","LK"]}
]
}
The response field will likely have many more entries than the example above. Each entry in the array represents a publisher. In this example, you can see the publisher’s ID, name, supported countries, and any alternate brands the publisher may have. Alternate brands are other sites a publisher powers or syndicates their data to.

Check the status of your listings

Once you confirm the publishers that your account contains, let’s see the status of your listings on these publishers’ sites. You can see the listings status using the following GET request:

GET https://api.yext.com/v2/accounts/me/powerlistings/listings?api_key=API_KEY&v=YYYYMMDD

Response:
{
  "meta": {
    "uuid": "4914e83d-b6a4-4f8b-a9fa-93d72ce0fdd3",
    "errors": [
      
    ]
  },
  "response": {
    "count": 2,
    "listings": [
      {
        "id": "52201603",
        "locationId": "1231611",
        "publisherId": "YELLOWCAULDRON",
        "status": "LIVE",
        "listingUrl": "http:\/\/www.local.example.com\/3279",
        "screenShotUrl": "NO SCREENSHOT FOR PARTNER"
      },
      {
        "id": "52201603",
        "locationId": "1231611",
        "publisherId": "YELLOWCAULDRON",
        "status": "LIVE",
        "listingUrl": "http:\/\/www.local.example.com\/3279",
        "screenShotUrl": "NO SCREENSHOT FOR PARTNER"
      }
    ]
  }
}
By default, the response will return results for 20 listings and will query for all Locations with a Listings subscription and all publishers on a Listings subscription. This endpoint allows you to filter your results for a specific set of Locations or publishers by providing the locationIds and publisherIds parameters in the request URL.

Opt listings in or out

NOTE: The steps in this section are not recommended for Enterprise clients.

You’ve now managed to see the current status of your listings. At some point, you may notice that some of your listings’ statuses are OPTED_OUT, which means Yext is currently not sending data to the publisher. In case, if you want to start sending data, you will need to “opt in” your listing to the publisher. You can opt your listing in with the following API call:

PUT https://api.yext.com/v2/accounts/me/powerlistings/listings/optin?api_key=API_KEY&v=YYYYMMDD&locationIds=[location123,location456]&publisherIds=[YELLOWCAULDRON]

As before, the number of listings you can opt out at a given time is 100. If the request you make is successful, you will receive an empty 200 response.

Retrieve Publisher Suggestions

While the data you send to Yext is likely the most accurate, sometimes our publishers may suggest edits based on their other data sources or consumer feedback. If they do so, Yext will continue to push your data to these publishers, but Yext will also allow you to see these publisher suggestions and actively choose to accept or reject these suggested edits. You can see what suggestions a publisher has provided with this request:

GET https://api.yext.com/v2/accounts/me/powerlistings/publishersuggestions?api_key=API_KEY&v=YYYYMMDD

Like many of the other PowerListings® API endpoints, this endpoint allows you to filter to a specific set of locations and publishers. At the time of writing, Publisher Suggestions are only returned for Google My Business (publisherId: GOOGLEMYBUSINESS). If the call is successful, the response field will have the count of Publisher Suggestions your account has and an array of Publisher Suggestion objects.

Accept or Reject a Publisher Suggestion

After you’ve had a chance to review your Publisher Suggestions, you can choose to either accept or reject a specific Publisher Suggestion. To accept a Publisher Suggestion, send this API request:

PUT https://api.yext.com/v2/accounts/me/powerlistings/publishersuggestions/SUGGESTION_ID?api_key=API_KEY&status=ACCEPTED&v=YYYYMMDD

If successful, you will receive a 200 response. When a Publisher Suggestion is accepted, your Location’s data will be updated to reflect the publisher’s data. You can reject a Publisher Suggestion using the same API request, but the status parameter should be set to REJECTED. When a Publisher Suggestion is rejected, no change is made to your Location’s data.