Step 1: Retrieve a List of Available Publishers

Before we find out the specifics about your listings, it may be helpful to see which publishers you have access to. You can find the entity types and countries supported by each Publisher in your account by using the Publishers: List endpoint.

Endpoint Information:

URL https://api.yext.com/v2/accounts/{accountId}/listings/publishers
Permissions Listings: READ
Description Retrieves a list of Publishers available to an account

Example Request:

Example Publisher object:

{
    "id": "GOOGLEMYBUSINESS",
    "name": "Google My Business",
    "url": "google.com",
    "alternateBrands": [
        {
            "name": "Waze",
            "url": ""
        }
    ],
    "supportedCountries": [
        "AD","AE","AG","AI","AL","AM","AO","AR","AS","AT","AU","AW","AX","AZ","BA",
        "BB","BD","BE","BF","BG","BH","BI","BJ","BL","BM","BN","BO","BQ","BR","BS",
        "BT","BW","BY","BZ","CA","CF","CG","CH","CI","CL","CM","CO","CR","CV","CW",
        "CY","CZ","DE","DJ","DK","DM","DO","DZ","EC","EE","EG","ES","ET","FI","FJ",
        "FK","FM","FO","FR","GA","GB","GD","GE","GF","GG","GH","GI","GN","GP","GQ",
        "GR","GT","GU","GY","HK","HN","HR","HT","HU","ID","IE","IL","IM","IN","IQ",
        "IS","IT","JE","JM","JO","JP","KE","KH","KN","KR","KW","KY","KZ","LA","LB",
        "LC","LI","LK","LT","LU","LV","LY","MA","MC","MD","ME","MF","MG","MH","MK",
        "ML","MM","MN","MO","MP","MQ","MR","MS","MT","MU","MV","MW","MX","MY","MZ",
        "NA","NC","NE","NG","NI","NL","NO","NP","NZ","OM","PA","PE","PH","PK","PL",
        "PM","PR","PS","PT","PW","PY","QA","RE","RO","RS","RU","RW","SA","SC","SE",
        "SG","SH","SI","SK","SL","SM","SN","SR","SV","SX","TC","TD","TG","TH","TJ",
        "TL","TN","TR","TT","TW","TZ","UA","UG","US","UY","UZ","VC","VE","VG","VI",
        "VN","WF","WS","XK","YT","ZA","ZM","ZW"
    ],
    "supportedEntityTypes": [
        "LOCATION",
        "HEALTHCARE_PROFESSIONAL",
        "HEALTHCARE_FACILITY",
        "ATM",
        "RESTAURANT"
    ],
    "features": [
        "DUAL_SYNC",
        "REVIEW_MONITORING",
        "PUBLISHER_SUGGESTIONS",
        "ANALYTICS",
        "SOCIAL"
    ]
}

Things to note:

  • alternateBrands - Sites that the Publisher also publishes entity data to, but Yext doesn’t have a direct connection with. For example, data sent to Google will also be made available on Waze Maps.
  • typicalUpdateSpeed - The expected time, in seconds, that changes to your entities will be reflected on the Publisher listing. For publishers that accept real-time updates, this will default to 120.