Entities | Hitchhikers

Entities: List

Retrieve a list of Entities within an account

NOTE

If the v parameter is 20240221 or later: returned entities replace the categoryIds field with the categories field.

path Parameters

accountId

required

string >= 0 characters

query Parameters

required

string >= 0 characters

A date in YYYYMMDD format.

convertMarkdownToHTML

string >= 0 characters

Optional parameter to return fields of type Markdown as HTML.

false: Markdown fields will be returned as JSON
true: Markdown fields will be returned as HTML

convertRichTextToHTML

string >= 0 characters

Optional parameter to return fields of type Rich Text as HTML.

false: Rich Text fields will be returned as JSON
true: Rich Text fields will be returned as HTML

entityTypes

string >= 0 characters

Comma-separated list of Entity types to filter on. Example: "location,event"

Should be from the following types:

atm
event
faq
financialProfessional
healthcareFacility
healthcareProfessional
hotel
hotelRoomType
job
location
organization
product
restaurant

OR the API name of a custom entity type.

fields

string >= 0 characters

Comma-separated list of field names. When present, only the fields listed will be returned. You can use dot notation to specify substructures (e.g., "address.line1"). Custom fields are specified in the same way, albeit with their c_* name.

filter

string >= 0 characters

This parameter represents one or more filtering conditions that are applied to the set of entities that would otherwise be returned. This parameter should be provided as a URL-encoded string containing a JSON object.

For example, if the filter JSON is {"name":{"$eq":"John"}}, then the filter param after URL-encoding will be: filter=%7B%22name%22%3A%7B%22%24eq%22%3A%22John%22%7D%7D

Basic Filter Structure

The filter object at its core consists of a matcher, a field, and an argument.

For example, in the following filter JSON:

{
"name":{
"$eq":"John"
}
}

$eq is the matcher, or filtering operation (equals, in this example),

name is the field being filtered by, and

John is value to be matched against.

Combining Multiple Filters

Multiple filters can be combined into one object using combinators. For example, the following filter JSON combines multiple filters using the combinator $and. $or is also supported.

{
"$and":[
{
"firstName":{
"$eq":"John"
}
},
{
"countryCode":{
"$in":[
"US",
"GB"
]
}
}
]
}

Filter Negation

Certain filter types may be negated. For example:

{
"$not": {
"name": {
"$eq": "John"
}
}
}

This can also be written more simply with a ! in the $eq parameter. The following filter would have the same effect:

{
"name":{
"!$eq":"John"
}
}

Filter Complement

You can also search for the complement of a filter. This filter would match entities that do not contain "hello" in their descriptions, or do not have a description set. This is different from negation which can only match entities who have the negated field set to something.

{
"$complement":{
"description":{
"$contains":"hello"
}
}
}

Addressing Subfields

Subfields of fields can be addressed using the "dot" notation while filtering. For example, if you have a custom field called c_myCustomField:

{
"c_myCustomField":{
"age": 30,
"name": "Jim",
}
}

While filtering, subfields may be addressed using the "dot" notation.

{
"c_myCustomField.name":{
"!$eq":"John"
}
}

Fields that are nested deeper may be addressed using dot notation, as well. For example, if name in the above example was a compound field with two subfields first and last, first may be addressed as c_myCustomField.name.first.

Field Support

Entity fields correspond to certain filter types, which support matchers. Going by the example above, the field name supports the TEXT filter type, which supports $eq (equals) and $startsWith (starts with).

TEXT

The TEXT filter type is supported for text fields. (e.g., name, countryCode)

Matcher	Details
$eq (equals)	`{ "countryCode":{ "$eq":"US" } }, { "countryCode":{ "!$eq":"US" } }` Supports negation. Case insensitive.
$startsWith	Matches if the field starts with the argument value. e.g., "Amazing" starts with "amaz" `{ "address.line1":{ "$startsWith": "Jo" } }` Supports negation. Case insensitive.
$in	Matches if field value is a member of the argument list. `{ "firstName":{ "$in": ["John", "Jimmy"] } }` Does not support negation. Negation can be mimicked by using an "OR" matcher, for example: `{ "$and":[ { "firstName":{ "!$eq": "John" } }, { "firstName":{ "!$eq": "Jimmy" } } ] }`
$contains	`{ "c_myString":{ "$contains":"sample" } }` This filter will match if "sample" is contained in any string within `c_myString`. Note that this matching is "left-edge n-gram", meaning the argument string must be the beginning of a token. The string "sample" will match strings like "This a sample", "Sample one", and "Sample 2", but not strings like "thisisasamplewithoutspaces". Supports negation.
$containsAny	`{ "c_myString":{ "$containsAny":[ "sample1", "sample2" ] } }` This filter will match if either "sample1" or "sample2" is contained in any string within `c_myString`. The argument list can contain more than two strings. Note that this matching is "left-edge n-gram", meaning the argument string must be the beginning of a token. The string "sample" will match strings like "This a sample", "Sample one", and "Sample 2", but not strings like "thisisasamplewithoutspaces". Supports negation.
$containsAll	`{ "c_myString":{ "$containsAll":[ "sample1", "sample2" ] } }` This filter will match if both "sample1" and "sample2" are contained in any string within `c_myString`. The argument list can contain more than two strings. Note that this matching is "left-edge n-gram", meaning the argument string must be the beginning of a token. The string "sample" will match strings like "This a sample", "Sample one", and "Sample 2", but not strings like "thisisasamplewithoutspaces". Supports negation.

BOOLEAN

The BOOLEAN filter type is supported for boolean fields and Yes / No custom fields.

Matcher	Details
$eq	`{ "isFreeEvent": { "$eq": true } }` For booleans, the filter takes a boolean value, not a string. Supports negation.

STRUCT

The STRUCT filter type is supported for compound fields with subfields.

*e.g., address, featuredMessage, fields of custom types*

Matcher Details

$hasProperty

Matches if argument is a key (subfield) of field being filtered by. This filter type is useful for filtering by compound fields or to check if certain fields have a value set.

{
"address": {
"$hasProperty": "line1"
}
}

Note that if a given property of a compound field is not set, the filter will not match. For example, if line1 of address is not set for an entity, then the above matcher will not match the entity.

Supports negation.

OPTION

The OPTION filter type is supported for options custom fields and fields that have a predetermined list of valid values.

*e.g., eventStatus, gender, SINGLE_OPTION and MULTI_OPTION types of custom fields.*

Matcher Details

$eq

Matching is case insensitive and insensitive to consecutive whitespace.

e.g., "XYZ 123" matches "xyz 123"

{
"eventStatus": {
"$eq": "SCHEDULED"
}
}

Supports negation. Negating $eq on the list will match any field that does not hold any of the provided values.

$in

{
"eventStatus": {
"$in": [
"SCHEDULED",
"POSTPONED"
]
}
}

Does not support negation. However, negation can be mimicked by using an $and matcher to negate individually over the desired values. For example:

{
"$and": [
{
"eventStatus":{
"!$eq": "SCHEDULED"
}
},
{
"firstName":{
"!$eq": "POSTPONED"
}
}
]
}

PHONE

The PHONE filter type is supported for phone number fields only. PHONE will support the same matchers as TEXT, except that for $eq, the same phone number with or without calling code will match.

Matcher Details

$eq

{
"mainPhone":{
"$eq":"+18187076189"
}
},
{
"mainPhone":{
"$eq":"8187076189"
}
},
{
"mainPhone":{
"!$eq":"9177076189"
}
}

Supports negation. Case insensitive.

$startsWith

Matches if the field starts with the argument value.

e.g., "8187076189" starts with "818"

{
"mainPhone":{
"$startsWith": "818"
}
}

Supports negation. Case insensitive.

$in

Matches if field value is a member of the argument list.

{
"mainPhone":{
"$in": [
"8185551616",
"9171112211"
]
}
}

Does not support negation. However, negation can be mimicked by using an $and matcher to negate individually over the desired values.

INTEGER, FLOAT, DATE, DATETIME, and TIME

These filter types are strictly ordered -- therefore, they support the following matchers:

Equals
Less Than / Less Than or Equal To
Greater Than / Greater Than or Equal To

Matcher	Details
$eq	Equals `{ "ageRange.maxValue": { "$eq": "80" } }` Supports negation.
$lt	Less than `{ "time.start": { "$lt": "2018-08-28T05:56" } }`
$gt	Greater than `{ "ageRange.maxValue": { "$gt": "50" } }`
$le	Less than or equal to `{ "ageRange.maxValue": { "$le": "40" } }`
$ge	Greater than or equal to `{ "time.end": { "$ge": "2018-08-28T05:56" } }`
Combinations	While we do not support "between" in our filtering syntax, it is possible to combine multiple matchers for a result similar to an "and" operation: `{ "ageRange.maxValue : { "$gt" : 10, "$lt": 20 } }`

LIST OF TEXT

Any field that has a list of valid values and supports any of the previously mentioned filter types will also support the $contains matcher.

Matcher	Details
$eq	`{ "c_myStringList": { "$eq": "sample" } }` This filter will match if "sample" EXACTLY matches any string within `c_myStringList`. Supports negation.
$eqAny	`{ "c_myStringList": { "$eqAny": [ "sample1", "sample2" ] } }` This filter will match if any one of "sample1" or "sample2" EXACTLY match a string within `c_myStringList` . The argument can have more than two strings. Supports negation.
$eqAll	`{ "c_myStringList": { "$eqAll": [ "sample1", "sample2" ] } }` This filter will match if both "sample1" AND "sample2" EXACTLY match a string within `c_myStringList`. The argument can have more than two strings. Supports negation.
$contains	`{ "c_myStringList":{ "$contains":"sample" } }` This filter will match if "sample" is contained in any string within `c_myStringList`. Note that this matching is "left edge n-gram", meaning the argument string must be the beginning of a token. The string "sample" will match strings like "This is a sample", "Sample one", "Sample 2" but not strings like "thisisasamplewithoutspaces". Supports negation.
$containsAny	`{ "c_myStringList": { "$containsAny": [ "sample1", "sample2" ] } }` This filter will match if either "sample1" or "sample2" is contained in any string within `c_myStringList`. The argument list can have more than two strings. Note that similar to `$contains`, the matching for `$containsAny` is "left edge n-gram", meaning the argument string must be the beginning of a token. The string "sample" will match strings like "This is a sample", "Sample one", "Sample 2" but not strings like "thisisasamplewithoutspaces". Supports negation.
$containsAll	`{ "c_myStringList": { "$containsAll": [ "sample1", "sample2" ] } }` This filter will match if BOTH "sample1" and "sample2" are contained in strings within `c_myStringList`. The argument list can have more than two strings. Note that similar to `$contains`, the matching for `$containsAll` is "left-edge n-gram", meaning the argument string must be the beginning of a token. The string "sample" will match strings like "This a sample", "Sample one", and "Sample 2", but not strings like "thisisasamplewithoutspaces". Supports negation.
$startsWith	`{ "c_myStringList": { "$startsWith":"sample" } }` This filter will match if any string within `c_myStringList` starts with "sample". Does not supports negation. Case Insensitive.

LIST OF BOOLEAN, OPTION, PHONE, INTEGER, FLOAT, DATE, DATETIME, OR TIME

Matcher Details

$eq

{
"c_myDateList": {
"$eq": "2019-01-01"
}
}

This filter will match if "2019-01-01" EXACTLY matches any date within c_myDateList.

Supports negation.

$eqAny

{
"c_myIntegerList": {
"$eqAny": [1, 2]
}
}

This filter will match if 1 or 2 EXACTLY match any integer within c_myIntegerList. The argument list can have more than two elements.

Supports negation.

$eqAll

{
"c_myStringList": {
"$eqAll": [
"sample1",
"sample2"
]
}
}

This filter will match if both "2019-01-01" AND "2019-01-02" EXACTLY match a date within c_myDateList. The argument list can have more than two elements.

Supports negation.

LIST OF STRUCT

Filtering on lists of struct types is a bit nuanced. Filtering can only be done on lists of structs of the SAME type. For example, if c_myStructList is a list of compound fields with the subfields age and name, then one can address the age properties of each field in c_myStructList as a flattened list of integers and filtering upon them. For example, the following filter:

{
"c_myStructList.age":{
"$eq": 20
}
}

will match if any field in the list has an age property equal to 20. Similarly, any filter that can be applied to lists of integers could be applied to age in this case ($eq, $eqAll, $eqAny).

HOURS

By filtering on an hours field, you can find which entities are open or closed at a specified time or during a certain time range. All of these filters also take an entity’s holiday hours and reopen date into account.

Matcher	Details
$openAt	`{ "hours": { "$openAt": "2019-01-06T13:45" } }` This filter would match entities open at the specified time.
$closedAt	`{ "hours": { "$closedAt: "2019-01-06T13:45" } }`
$openForAllOf	`{ "hours": { "$openForAllOf": { "start": "2019-01-06T13:45", "end": "2019-01-06T15:00" } } }` This filter would match only those entities that are open for the entire range between 2019-01-06T13:45 and 2019-01-06T15:00. `{ "hours": { "$openForAllOf": "2019-05-10" } }` This filter would match entities open for the entire 24 hour period on 2019-05-10. You can also supply a year, a month, or an hour to filter for entities open for the entire year, month, or hour, respectively.
$openForAnyOf	`{ "hours": { "$openForAnyOf": { "start": "now", "end": "now+2h" } } }` This filter will match any entities that are open for at least a portion of the time range between now and two hours from now.
$closedForAllOf	`{ "hours": { "$closedForAllOf": { "start": "2019-01-06T13:45", "end": "2019-01-06T15:00" } } }` This filter will match only those entities that are closed for the entire given time range.
$closedForAnyOf	`{ "hours": { "$closedForAnyOf": { "start": "2019-01-06T13:45", "end": "2019-01-06T15:00" } } }` This filter will match any entities that are closed for at least a portion of the given time range.

Filtering by Dates and Times

Time zones

The filtering language supports searching both in local time and within a certain time zone. Searching in local time will simply ignore the time zone on the target entities, while providing one will convert the zone of your queried time to the zone of the target entities.

To search in local time, simply provide the date or time without any zone: 2019-06-07T15:30 or 2019-06-07.

To conduct a zoned search, provide the name of the time zone in brackets after the time, as it is shown in the tz database: 2019-06-07T15:30[America/New_York] or 2019-06-06[America/Phoenix].

Date and time types

In addition to searching with dates and datetimes, you can also query with years, months, and hours. For example, the filter:

{
"time.start": {
"$eq": "2018"
}
}

would match all start times in the year 2018. The same logic would apply for a month (2019-05), a date (2019-05-01), or an hour (2019-05-01T06).

These types also work with ordered searches. For example:

{
"time.start": {
"$lt": "2018"
}
}

would match start times before 2018 (i.e., anything in 2017 or before). On the other hand, the same query with a $le matcher would include anything in or before 2018.

"Now" and Date Math

Instead of providing a static date or time, you can also use now in place of any date time. When you do so, the system will calculate the time when the query is made and conduct a zoned search.

In order to search for a future or past time relative to now, you can use date math. For example, you can enter now+3h or now-1d, which would mean 3 hours from now and 1 day ago, respectively. You can also add and subtract minutes (m), months (M), and years (y).

It is also possible to add or subtract time from a static date or datetime. Simply add || between the static value and any addition or subtraction. For example, 2019-02-03||+1d would be the same as 2019-02-04.

You can also convert date and time types to other types. For example, to convert the datetime 2019-05-06T22:15 to a date, use 2019-05-06T22:15||/d. Doing so would yield the same result as using 2019-05-06. This method also works with now: now/d will give you today’s date without the time.

Filtering Across an Entity

It is possible to search for a specific text string across all fields of an entity by using the $anywhere matcher.

Matcher Details

$anywhere

Matches if the argument text appears anywhere in the entity (including subfields, structs, and lists)

{
"$anywhere": "hello"
}

This filter will match all entities that contain the string "hello" or strings that begin with "hello".

Examples

The following filter will match against entities that:

Are of type event (note that entity types can also be filtered by the entityTypes query parameter)
Have a name that starts with the text "Century"
Have a maximum age between 10 and 20
Have a minimum age between 5 and 7
Start after 7 PM (19:00) on August 28, 2018

{
"$and":[
{
"entityType":{
"$eq":"event"
}
},
{
"name":{
"$startsWith":"Century"
}
},
{
"ageRange.maxValue":{
"$gt":10,
"$lt":20
}
},
{
"ageRange.minValue":{
"$gt":5,
"$lt":7
}
},
{
"time.start":{
"$ge":"2018-08-28T19:00"
}
}
]
}

format

string >= 0 characters

Default: "markdown"

Present if and only if at least one field is of type "Legacy Rich Text."

Valid values:

markdown
html
none

languages

string >= 0 characters

Comma-separated list of language codes.

When present, the system will return Entities that have profiles in one or more of the provided languages. For each Location, only the first available profile from the provided list of languages will be returned. The keyword "primary" can be used to refer to a Location’s primary profile without providing a specific language code. If an Entity does not have profiles in any of the languages provided, that Entity's primary profile will be returned.

limit

number multiple of 1 <= 50

Default: "10"

Number of results to return.

offset

number multiple of 1

Default: "0"

Number of results to skip. Used to page through results. Cannot be used together with pageToken.

For Live API requests, the offset cannot be higher than 9,950. For Knowledge API the maximum limit is only enforced if a filter and/or sortBy parameter are given.

pageToken

string >= 0 characters

If a response to a previous request contained the pageToken field, pass that field's value as the pageToken parameter to retrieve the next page of data.

resolvePlaceholders

boolean

Default: "false"

Optional parameter to resolve all embedded fields in a Location object response.

false: Location object returns placeholder labels, e.g., "Your [[CITY]] store"
true: Location object returns placeholder values, e.g., "Your Fairfax store"

sortBy

string >= 0 characters

A list of fields and sort directions to order results by. Each ordering in the list should be in the format {"field_name", "sort_direction"}, where sort_direction is either ASCENDING or DESCENDING.

For example, to order by name the sort order would be [{"name":"ASCENDING"}]. To order by name and then description, the sort order would be [{"name":"ASCENDING"},{"description":"ASCENDING"}].

Responses

Response samples

Content type

application/json

{"meta": {"uuid": "string"
},
"response": {"count": 0,
"entities": [{"meta": {"accountId": "string",
"countryCode": "string",
"createdTimestamp": "string",
"entityType": "string",
"folderId": "string",
"id": "string",
"labels": ["string"
],
"language": "string",
"timestamp": "string",
"uid": "string"
},
"name": "string",
"address": {"city": "string",
"countryCode": "string",
"extraDescription": "string",
"line1": "string",
"line2": "string",
"postalCode": "string",
"region": "string",
"sublocality": "string"
},
"acceptingNewPatients": true,
"acceptsReservations": true,
"accessHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"additionalHoursText": "string",
"additionalPromotingLocations": ["string"
],
"addressHidden": true,
"admittingHospitals": ["string"
],
"adultPool": "YES",
"ageRange": {"maxValue": 0,
"minValue": 0
},
"airportShuttle": "AIRPORT_SHUTTLE_AVAILABLE",
"airportTransfer": "YES",
"allInclusive": "ALL_INCLUSIVE_RATES_AVAILABLE",
"alternateNames": ["string"
],
"alternatePhone": "string",
"alternateWebsites": ["http://example.com"
],
"androidAppUrl": "string",
"answer": "string",
"appleActionLinks": [{"appName": "string",
"appStoreUrl": "http://example.com",
"category": "BOOK_TRAVEL",
"quickLinkUrl": "http://example.com"
}
],
"appleBusinessDescription": "string",
"appleBusinessId": "string",
"appleCompanyId": "string",
"appleCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"applicationUrl": "http://example.com",
"associations": ["string"
],
"attendance": {"attendanceMode": "OFFLINE",
"virtualLocationUrl": "http://example.com"
},
"attire": "UNSPECIFIED",
"babysittingOffered": "YES",
"baggageStorage": "YES",
"bar": "YES",
"beachAccess": "YES",
"beachFrontProperty": "YES",
"bicycles": "BICYCLE_RENTALS",
"bios": {"ids": ["string"
],
"label": "string"
},
"boutiqueStores": "YES",
"brands": ["string"
],
"breakfast": "BREAKFAST_AVAILABLE",
"brunchHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"businessCenter": "YES",
"calendars": {"ids": ["string"
],
"label": "string"
},
"carRental": "YES",
"casino": "YES",
"categories": { },
"categoryIds": ["string"
],
"catsAllowed": "YES",
"certifications": ["string"
],
"checkInTime": "14:15:22Z",
"checkOutTime": "14:15:22Z",
"classificationRating": "string",
"closed": true,
"concierge": "YES",
"conditionsTreated": ["string"
],
"convenienceStore": "YES",
"covidMessaging": "string",
"covidTestAppointmentUrl": "http://example.com",
"covidTestingAppointmentRequired": true,
"covidTestingDriveThroughSite": true,
"covidTestingIsFree": true,
"covidTestingPatientRestrictions": true,
"covidTestingReferralRequired": true,
"covidTestingSiteInstructions": "string",
"covidVaccineAppointmentRequired": true,
"covidVaccineDriveThroughSite": true,
"covidVaccineInformationUrl": "http://example.com",
"covidVaccinePatientRestrictions": true,
"covidVaccineReferralRequired": true,
"covidVaccineSiteInstructions": "string",
"covidVaccinesOffered": ["PFIZER"
],
"currencyExchange": "YES",
"customKeywords": ["string"
],
"datePosted": "2019-08-24",
"degrees": ["ANP"
],
"deliveryHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"description": "stringstri",
"displayCoordinate": {"latitude": -90,
"longitude": -180
},
"doctorOnCall": "YES",
"dogsAllowed": "YES",
"driveThroughHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"dropoffCoordinate": {"latitude": -90,
"longitude": -180
},
"educationList": [{"institutionName": "string",
"type": "FELLOWSHIP",
"yearCompleted": 1900
}
],
"electricChargingStation": "YES",
"elevator": "YES",
"ellipticalMachine": "YES",
"emails": ["user@example.com"
],
"employmentType": "FULL_TIME",
"eventStatus": "SCHEDULED",
"facebookAbout": "string",
"facebookCallToAction": {"type": "NONE",
"value": "string"
},
"facebookCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"facebookDescriptor": "string",
"facebookName": "string",
"facebookOverrideCity": "string",
"facebookPageUrl": "string",
"facebookParentPageId": "string",
"facebookProfilePhoto": {"alternateText": "string",
"url": "http://example.com"
},
"facebookStoreId": "string",
"facebookVanityUrl": "string",
"facebookWebsiteOverride": "http://example.com",
"fax": "string",
"featuredMessage": {"description": "string",
"url": "http://example.com"
},
"firstName": "string",
"firstPartyReviewPage": "string",
"fitnessCenter": "FITNESS_CENTER_AVAILABLE",
"floorCount": 0,
"freeWeights": "YES",
"frequentlyAskedQuestions": [{"answer": "string",
"question": "string"
}
],
"frontDesk": "FRONT_DESK_AVAILABLE",
"fullyVaccinatedStaff": true,
"gameRoom": "YES",
"gender": "UNSPECIFIED",
"geomodifier": "string",
"giftShop": "YES",
"golf": "YES",
"googleAttributes": { },
"googleCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"googleMyBusinessLabels": ["string"
],
"googlePlaceId": "string",
"googleProfilePhoto": {"alternateText": "string",
"url": "http://example.com"
},
"googleWebsiteOverride": "http://example.com",
"happyHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"headshot": {"alternateText": "string",
"url": "http://example.com"
},
"hiringOrganization": "string",
"holidayHoursConversationEnabled": true,
"horsebackRiding": "YES",
"hotTub": "YES",
"hours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"housekeeping": "HOUSEKEEPING_AVAILABLE",
"impressum": "string",
"indoorPoolCount": 0,
"instagramHandle": "string",
"insuranceAccepted": ["string"
],
"iosAppUrl": "string",
"isClusterPrimary": true,
"isFreeEvent": true,
"isoRegionCode": "string",
"keywords": ["string"
],
"kidFriendly": "YES",
"kidsClub": "YES",
"kidsStayFree": "YES",
"kitchenHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"labels": ["string"
],
"landingPageUrl": "http://example.com",
"languages": ["string"
],
"lastName": "string",
"laundry": "FULL_SERVICE",
"lazyRiver": "YES",
"lifeguard": "YES",
"linkedInUrl": "http://example.com",
"linkedLocation": "string",
"localPhone": "string",
"localShuttle": "YES",
"locatedIn": "string",
"location": {"existingLocation": "string",
"externalLocation": "string"
},
"locationType": "LOCATION",
"logo": {"clickthroughUrl": "http://example.com",
"description": "string",
"details": "string",
"image": {"alternateText": "string",
"url": "http://example.com"
}
},
"mainPhone": "string",
"massage": "YES",
"maxAgeOfKidsStayFree": 0,
"maxNumberOfKidsStayFree": 0,
"mealsServed": ["BREAKFAST"
],
"meetingRoomCount": 0,
"menuUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"menus": {"ids": ["string"
],
"label": "string"
},
"middleName": "string",
"mobilePhone": "string",
"mobilityAccessible": "YES",
"nightclub": "YES",
"npi": "string",
"nudgeEnabled": true,
"officeName": "string",
"onlineServiceHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"operatingCountries": ["AD"
],
"orderUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"organizerEmail": "user@example.com",
"organizerName": "string",
"organizerPhone": "string",
"outdoorPoolCount": 0,
"parking": "PARKING_AVAILABLE",
"paymentOptions": ["AFTERPAY"
],
"performers": ["string"
],
"petsAllowed": "PETS_WELCOME",
"photoGallery": [{"clickthroughUrl": "http://example.com",
"description": "string",
"details": "string",
"image": {"alternateText": "string",
"url": "http://example.com"
}
}
],
"pickupCoordinate": {"latitude": -90,
"longitude": -180
},
"pickupHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"pinterestUrl": "http://example.com",
"priceRange": "UNSPECIFIED",
"primaryConversationContact": "string",
"privateBeach": "YES",
"privateCarService": "PRIVATE_CAR_SERVICE",
"productLists": {"ids": ["string"
],
"label": "string"
},
"products": ["string"
],
"questionsAndAnswers": true,
"rankTrackingCompetitors": [{"name": "string",
"website": "http://example.com"
}
],
"rankTrackingEnabled": true,
"rankTrackingFrequency": "WEEKLY",
"rankTrackingQueryTemplates": ["KEYWORD"
],
"rankTrackingSites": ["GOOGLE_DESKTOP"
],
"reservationUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"restaurantCount": 0,
"reviewGenerationUrl": "string",
"reviewResponseConversationEnabled": true,
"roomCount": 0,
"roomService": "ROOM_SERVICE_AVAILABLE",
"routableCoordinate": {"latitude": -90,
"longitude": -180
},
"salon": "YES",
"sauna": "YES",
"scuba": "YES",
"selfParking": "SELF_PARKING_AVAILABLE",
"seniorHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"serviceArea": {"places": ["string"
]
},
"serviceAreaPlaces": [{"name": "string",
"googlePlaceId": "string",
"type": "POSTAL_CODE"
}
],
"services": ["string"
],
"smokeFreeProperty": "YES",
"snorkeling": "YES",
"socialHour": "YES",
"spa": "YES",
"specialities": ["string"
],
"tableService": "YES",
"takeoutHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"tennis": "YES",
"thermalPool": "YES",
"ticketAvailability": "IN_STOCK",
"ticketPriceRange": {"currencyCode": "string",
"maxValue": "string",
"minValue": "string"
},
"ticketSaleDateTime": "2019-08-24T14:15:22Z",
"ticketUrl": "http://example.com",
"tikTokUrl": "http://example.com",
"time": {"end": "2019-08-24T14:15:22Z",
"start": "2019-08-24T14:15:22Z"
},
"timeZoneUtcOffset": "string",
"timezone": "string",
"tollFreePhone": "string",
"treadmill": "YES",
"ttyPhone": "string",
"turndownService": "YES",
"twitterHandle": "string",
"uberLink": {"presentation": "BUTTON",
"text": "string"
},
"uberTripBranding": {"description": "string",
"text": "string",
"url": "http://example.com"
},
"valetParking": "VALET_PARKING_AVAILABLE",
"validThrough": "2019-08-24T14:15:22Z",
"vendingMachine": "YES",
"venueName": "string",
"videos": [{"description": "string",
"video": {"url": "http://example.com"
}
}
],
"wadingPool": "YES",
"wakeUpCalls": "YES",
"walkableCoordinate": {"latitude": -90,
"longitude": -180
},
"waterPark": "YES",
"waterSkiing": "YES",
"watercraft": "WATERCRAFT_RENTALS",
"waterslide": "YES",
"wavePool": "YES",
"websiteUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"weightMachine": "YES",
"wheelchairAccessible": "YES",
"wifiAvailable": "WIFI_AVAILABLE",
"workRemote": true,
"yearEstablished": 1000,
"yearLastRenovated": 1000,
"yextDisplayCoordinate": {"latitude": -90,
"longitude": -180
},
"yextDropoffCoordinate": {"latitude": -90,
"longitude": -180
},
"yextPickupCoordinate": {"latitude": -90,
"longitude": -180
},
"yextRoutableCoordinate": {"latitude": -90,
"longitude": -180
},
"yextWalkableCoordinate": {"latitude": -90,
"longitude": -180
},
"youTubeChannelUrl": "http://example.com"
}
],
"pageToken": "string"
}
}

Entities: Create

Create a new Entity

NOTE:

If the v parameter is before 20181129: the 201 response contains the created Entity's id
If the v parameter is on or after 20181129: the 201 response contains the created Entity in its entirety
If the v parameter is 20240221 or later: returned Entity replaces the categoryIds field with the categories field.

path Parameters

accountId

required

string >= 0 characters

query Parameters

entityType required	string >= 0 characters The type of entity to be created. Should be one of the following: `atm` `event` `faq` `financialProfessional` `healthcareFacility` `healthcareProfessional` `hotel` `hotelRoomType` `job` `location` `organization` `product` `restaurant` OR the API name of a custom entity type.
v required	string >= 0 characters A date in `YYYYMMDD` format.
format	string >= 0 characters Default: "markdown" The formatting language used to parse rich text field values. Present and required if an only if the request contains a field with type "Rich Text." Valid values: `markdown` `html`
stripUnsupportedFormats	boolean Optional parameter to strip unsupported formats in rich text fields. When this parameter is included, the unsupported formats in rich text fields will be stripped and saved as plain text; otherwise if this parameter is not included, unsupported formats will return an error.
templateFields	string >= 0 characters Comma-separated list of top-level fields to apply from the template. If provided, only the fields specified will be applied to the entity. Ignored if `templateId` is not provided.
templateId	string >= 0 characters The external ID of the template to apply to the entity NOTE: Some fields that are part of the provided template but not present in the API will be applied - e.g. Linked Accounts

header Parameters

Update-Operation-Id

string >= 0 characters

The ID of the operation. Leave this blank to create a new operation or supply an ID to continue an existing operation

Request Body schema: application/json

The entity to be created

EntityType	string This is used only to filter the fields below and should NOT be included in any API calls. If create, specify the entity type in the query parameter. If update, specify the entity type in the request body in the `meta` object. atm
	object Contains the metadata about the entity.
name	string [ 0 .. 5000 ] characters Cannot Include: HTML markup
	object Contains the address of the entity (or where the entity is located) Must be a valid address Cannot be a P.O. Box If the entity is an `event`, either an `address` value or a `linkedLocation` value can be provided.
	object Contains the daily access hours, holiday access hours, and reopen date for the Entity. Each day is represented by a sub-field of `accessHours`. (e.g. `monday`, `tuesday`, etc.) Open times can be specified per day through the `openIntervals` field and the `isClosed` flag. Similarly, holiday access hours are represented by the `holidayHours` sub-field. Setting the `reopenDate` sub-field indicates that the business is temporarily closed and will reopen on the specified date. SPECIAL CASES: To indicate that an Entity is open 24 hours on a specific day, set start to 00:00 and end to 23:59 in `openIntervals` for that day. To indicate that an Entity has split hours on a specific day (e.g., open from 9:00 AM to 12:00 PM and again from 1:00 PM to 5:00 PM), supply two or more `openIntervals` values with non-overlapping sets of hours. If you are providing `openIntervals`, you may not set `isClosed` to true for that day.
additionalHoursText	string [ 0 .. 255 ] characters Additional information about hours that does not fit in `hours` (e.g., `"Closed during the winter"`)
alternateNames	Array of strings unique [ items [ 0 .. 100 ] characters ] Other names for your business that you would like us to use when tracking your search performance Array must be ordered. Array may have a maximum of 3 elements. Array item description: Cannot Include: HTML markup
alternatePhone	string >= 0 characters Must be a valid phone number. If the phone number's calling code is for a country other than the one given in the entity's `countryCode`, the phone number provided must contain the calling code (e.g., `+44` in `+442038083831`). Otherwise, the calling code is optional.
alternateWebsites	Array of strings <uri> unique [ items <uri > [ 0 .. 255 ] characters ] Other websites for your business that we should search for when tracking your search performance Array must be ordered. Array may have a maximum of 3 elements. Array item description: Cannot Include: common domain names, e.g., google.com, youtube.com, etc.
	Array of objects unique Use this field to add action links to your Apple Listings. The call to action category will be displayed on the action link button. The App Store URL should contain a valid link to the landing page of an App in the Apple App Store. The Quick Link URL is where a user is taken when an action link is clicked by a user. The App Name sub-field is not displayed on Apple Listings and is only used to distinguish the call-to-action type when utilizing action links in Apple posts. Array must be ordered.
appleBusinessDescription	string [ 0 .. 500 ] characters The business description to be sent to Apple
appleBusinessId	string >= 0 characters ^\d\.?\d$ The ID associated with an individual Business Folder in your Apple account
appleCompanyId	string >= 0 characters ^\d\.?\d$ The ID associated with your Apple account. Numerical values only
	object The cover photo for the entity''s Apple profile Image must be at least 1600 x 1040 pixels Image may be no more than 4864 x 3163 pixels Supported Aspect Ratios: 154 x 100 NOTE: Maximum image size is 5mb after normalization and padding (if applicable). As well, there is a 6 second download limit from the image host.
categories	object Yext Categories. (Supported for versions > 20240220) A map of category list external IDs (i.e. "yext") to a list of category IDs. IDs must be valid and selectable (i.e., cannot be parent categories). Partial updates are accepted, meaning sending only the "yext" property will have no effect on any category list except the "yext" category.
categoryIds	Array of strings[ items >= 0 characters ] Yext Category IDs. (Deprecated: For versions > 20240220) IDs must be valid and selectable (i.e., cannot be parent categories). NOTE: The list of category IDs that you send us must be comprehensive. For example, if you send us a list of IDs that does not include IDs that you sent in your last update, Yext considers the missing categories to be deleted, and we remove them from your listings.
closed	boolean Indicates whether the entity is closed
customKeywords	Array of strings unique [ items [ 0 .. 100 ] characters ] Additional keywords you would like us to use when tracking your search performance Array must be ordered. Array may have a maximum of 5 elements.
description	string [ 10 .. 15000 ] characters A description of the entity Cannot Include: HTML markup
	object Coordinates where the map pin for the entity should be displayed, as provided by you
	object Contains the daily drive-through hours, holiday drive-through hours, and reopen date for the Entity. Each day is represented by a sub-field of `driveThroughHours`. (e.g. `monday`, `tuesday`, etc.) Open times can be specified per day through the `openIntervals` field and the `isClosed` flag. Similarly, holiday drive-through hours are represented by the `holidayHours` sub-field. Setting the `reopenDate` sub-field indicates that the business is temporarily closed and will reopen on the specified date. SPECIAL CASES: To indicate that an Entity is open 24 hours on a specific day, set start to 00:00 and end to 23:59 in `openIntervals` for that day. To indicate that an Entity has split hours on a specific day (e.g., open from 9:00 AM to 12:00 PM and again from 1:00 PM to 5:00 PM), supply two or more `openIntervals` values with non-overlapping sets of hours. If you are providing `openIntervals`, you may not set `isClosed` to true for that day.
	object Coordinates of the drop-off area for the entity, as provided by you
facebookAbout	string [ 0 .. 255 ] characters A description of the entity to be used in the "About You" section on Facebook
	object Designates the Facebook Call-to-Action button text and value Valid contents of `value` depends on the Call-to-Action's `type`: `NONE`: (optional) `BOOK_NOW`: URL `CALL_NOW`: Phone number `CONTACT_US`: URL `SEND_MESSAGE`: Any string `USE_APP`: URL `PLAY_GAME`: URL `SHOP_NOW`: URL `SIGN_UP`: URL `WATCH_VIDEO`: URL `SEND_EMAIL`: Email address `LEARN_MORE`: URL `PURCHASE_GIFT_CARDS`: URL `ORDER_NOW`: URL `FOLLOW_PAGE`: Any string
	object The cover photo for the entity's Facebook profile Displayed as a 851 x 315 pixel image You may need a cover photo in order for your listing to appear on Facebook. Please check your listings tab to learn more. Image must be at least 400 x 150 pixels Image area (width x height) may be no more than 41000000 pixels Image may be no more than 30000 x 30000 pixels Supported Aspect Ratios: 1 x 1 4 x 3 3 x 2 5 x 3 16 x 9 3 x 1 2 x 3 5 x 7 4 x 5 4 x 1 NOTE: Maximum image size is 5mb after normalization and padding (if applicable). As well, there is a 6 second download limit from the image host.
facebookDescriptor	string [ 3 .. 75 ] characters Location Descriptors are used for Enterprise businesses that sync Facebook listings using brand page location structure. The Location Descriptor is typically an additional geographic description (e.g. geomodifier) that will appear in parentheses after the name on the Facebook listing. Cannot Include: HTML markup
facebookName	string >= 0 characters The name for this entity's Facebook profile. A separate name may be specified to send only to Facebook in order to comply with any specific Facebook rules or naming conventions.
facebookOverrideCity	string >= 0 characters The city to be displayed on this entity's Facebook profile
facebookPageUrl	string >= 0 characters URL for the entity's Facebook Page. Valid formats: facebook.com/profile.php?id=[numId] facebook.com/group.php?gid=[numId] facebook.com/groups/[numId] facebook.com/[Name] facebook.com/pages/[Name]/[numId] facebook.com/people/[Name]/[numId] where [Name] is a String and [numId] is an Integer The success response will contain a warning message explaining why the URL wasn't stored in the system.
facebookParentPageId	string [ 0 .. 65 ] characters The Facebook Page ID of this entity's brand page if in a brand page location structure
	object The profile picture for the entity's Facebook profile You must have a profile picture in order for your listing to appear on Facebook. Image must be at least 180 x 180 pixels Image area (width x height) may be no more than 41000000 pixels Image may be no more than 30000 x 30000 pixels Supported Aspect Ratios: 1 x 1 4 x 3 3 x 2 5 x 3 16 x 9 3 x 1 2 x 3 5 x 7 4 x 5 4 x 1 NOTE: Maximum image size is 5mb after normalization and padding (if applicable). As well, there is a 6 second download limit from the image host.
facebookStoreId	string >= 0 characters The Store ID used for this entity in a brand page location structure
facebookVanityUrl	string [ 0 .. 50 ] characters The username that appear's in the Facebook listing URL to help customers find and remember a brand’s Facebook page. The username is also be used for tagging the Facebook page in other users’ posts, and searching for the Facebook page.
facebookWebsiteOverride	string <uri> >= 0 characters The URL you would like to submit to Facebook in place of the one given in `websiteUrl` (if applicable).
fax	string >= 0 characters Must be a valid fax number. If the fax number's calling code is for a country other than the one given in the entity's `countryCode`, the fax number provided must contain the calling code (e.g., `+44` in `+442038083831`). Otherwise, the calling code is optional.
	object Information about the entity's Featured Message
	Array of objects unique A list of questions that are frequently asked about this entity Array must be ordered. Array may have a maximum of 100 elements.
geomodifier	string >= 0 characters Provides additional information on where the entity can be found (e.g., `Times Square`, `Global Center Mall`)
googleAttributes	object The unique IDs of the entity's Google Business Profile keywords, as well as the unique IDs of any values selected for each keyword. Valid keywords (e.g., `has_drive_through`, `has_fitting_room`, `kitchen_in_room`) are determined by the entity's primary category. A full list of keywords can be retrieved with the Google Fields: List endpoint. Keyword values provide more details on how the keyword applies to the entity (e.g., if the keyword is `has_drive_through`, its values may be `true` or `false`). If the `v` parameter is before `20181204`: `googleAttributes` is formatted as a map of key-value pairs (e.g., `[{ "id": "has_wheelchair_accessible_entrance", "values": [ "true" ] }]`) If the `v` parameter is on or after `20181204`: the contents are formatted as a list of objects (e.g., `{ "has_wheelchair_accessible_entrance": [ "true" ]}`) NOTE: The latest Google Attributes are available via the Google Fields: List endpoint. Google Attributes are managed by Google and are subject to change without notice. To prevent errors, make sure your API implementation is not dependent on the presence of specific attributes.
	object The cover photo for the entity's Google profile Image must be at least 250 x 250 pixels
googleMyBusinessLabels	Array of strings unique [ items [ 0 .. 50 ] characters ] Google Business Profile Labels help users organize their locations into groups within GBP. Array must be ordered. Array may have a maximum of 10 elements. Array item description: Cannot Include: HTML markup
googlePlaceId	string >= 0 characters The unique identifier of this entity on Google Maps.
	object The profile photo for the entity's Google profile Image must be at least 250 x 250 pixels Image may be no more than 5000 x 5000 pixels Supported Aspect Ratios: 1 x 1 NOTE: Maximum image size is 5mb after normalization and padding (if applicable). As well, there is a 6 second download limit from the image host.
googleWebsiteOverride	string <uri> >= 0 characters The URL you would like to submit to Google Business Profile in place of the one given in `websiteUrl` (if applicable). For example, if you want to analyze the traffic driven by your Google listings separately from other traffic, enter the alternate URL that you will use for tracking in this field.
holidayHoursConversationEnabled	boolean Indicates whether holiday-hour confirmation alerts are enabled for the Yext Knowledge Assistant for this entity
	object Contains the daily hours, holiday hours, and reopen date for the Entity. Each day is represented by a sub-field of `hours`. (e.g. `monday`, `tuesday`, etc.) Open times can be specified per day through the `openIntervals` field and the `isClosed` flag. Similarly, holiday hours are represented by the `holidayHours` sub-field. Setting the `reopenDate` sub-field indicates that the business is temporarily closed and will reopen on the specified date. SPECIAL CASES: To indicate that an Entity is open 24 hours on a specific day, set start to 00:00 and end to 23:59 in `openIntervals` for that day. To indicate that an Entity has split hours on a specific day (e.g., open from 9:00 AM to 12:00 PM and again from 1:00 PM to 5:00 PM), supply two or more `openIntervals` values with non-overlapping sets of hours. If you are providing `openIntervals`, you may not set `isClosed` to true for that day.
impressum	string [ 0 .. 2000 ] characters A statement of the ownership and authorship of a document. Individuals or organizations based in many German-speaking countries are required by law to include an Impressum in published media.
isoRegionCode	string >= 0 characters The ISO 3166-2 region code for the entity Yext will determine the entity's code and update `isoRegionCode` with that value. If Yext is unable to determine the code for the entity, the entity'ss ISO 3166-1 alpha-2 country code will be used.
keywords	Array of strings unique [ items [ 0 .. 100 ] characters ] Keywords that describe the entity. All strings must be non-empty when trimmed of whitespace. Array must be ordered. Array may have a maximum of 100 elements. Array item description: Cannot Include: HTML markup
labels	Array of strings[ items >= 0 characters ] The IDs of the entity labels that have been added to this entity. Entity labels help you identify entities that share a certain characteristic; they do not appear on your entity's listings. NOTE: You can only add labels that have already been created via our web interface. Currently, it is not possible to create new labels via the API.
landingPageUrl	string <uri> >= 0 characters The URL of this entity's Landing Page that was created with Yext Pages
localPhone	string >= 0 characters Must be a valid, non-toll-free phone number, based on the country specified in `address.region`. Phone numbers for US entities must contain 10 digits.
locatedIn	string For atms, the external ID of the entity that the atm is installed in. The entity must be in the same business account as the atm.
locationType	string Enum: "LOCATION" "HEALTHCARE_FACILITY" "HEALTHCARE_PROFESSIONAL" "ATM" "RESTAURANT" "HOTEL" Indicates the entity's type, if it is not an event
	object An image of the entity's logo Supported Aspect Ratios: 1 x 1 NOTE: Maximum image size is 5mb after normalization and padding (if applicable). As well, there is a 6 second download limit from the image host.
mainPhone	string >= 0 characters The main phone number of the entity's point of contact Must be a valid phone number. If the phone number's calling code is for a country other than the one given in the entity's `countryCode`, the phone number provided must contain the calling code (e.g., `+44` in `+442038083831`). Otherwise, the calling code is optional.
mobilePhone	string >= 0 characters Must be a valid phone number. If the phone number's calling code is for a country other than the one given in the entity's `countryCode`, the phone number provided must contain the calling code (e.g., `+44` in `+442038083831`). Otherwise, the calling code is optional.
nudgeEnabled	boolean Indicates whether Knowledge Nudge is enabled for the Yext Knowledge Assistant for this entity
	Array of objects NOTE: The list of photos that you send us must be comprehensive. For example, if you send us a list of photos that does not include photos that you sent in your last update, Yext considers the missing photos to be deleted, and we remove them from your listings. Array must be ordered. Array may have a maximum of 500 elements. Array item description: Supported Aspect Ratios: 1 x 1 4 x 3 3 x 2 5 x 3 16 x 9 3 x 1 2 x 3 5 x 7 4 x 5 4 x 1 NOTE: Maximum image size is 5mb after normalization and padding (if applicable). As well, there is a 6 second download limit from the image host.
	object Coordinates of where consumers can be picked up at the entity, as provided by you
priceRange	string Enum: "UNSPECIFIED" "ONE" "TWO" "THREE" "FOUR" he typical price of products sold by this location, on a scale of 1 (low) to 4 (high)
primaryConversationContact	string >= 0 characters ID of the user who is the primary Knowledge Assistant contact for the entity
questionsAndAnswers	boolean Indicates whether Yext Knowledge Assistant question-and-answer conversations are enabled for this entity
	Array of objects unique Information about the competitors whose search performance you would like to compare to your own Array must be ordered. Array may have a maximum of 5 elements.
rankTrackingEnabled	boolean Indicates whether Rank Tracking is enabled
rankTrackingFrequency	string Enum: "WEEKLY" "MONTHLY" "QUARTERLY" How often we send search queries to track your search performance
rankTrackingQueryTemplates	Array of strings unique Items Enum: "KEYWORD" "KEYWORD_ZIP" "KEYWORD_CITY" "KEYWORD_IN_CITY" "KEYWORD_NEAR_ME" "KEYWORD_CITY_STATE" The ways in which your keywords will be arranged in the search queries we use to track your performance Array must have a minimum of 2 elements. Array may have a maximum of 4 elements.
rankTrackingSites	Array of strings unique Items Enum: "GOOGLE_DESKTOP" "GOOGLE_MOBILE" "BING_DESKTOP" "BING_MOBILE" "YAHOO_DESKTOP" "YAHOO_MOBILE" The search engines that we will use to track your performance
reviewResponseConversationEnabled	boolean Indicates whether Yext Knowledge Assistant review-response conversations are enabled for this entity
	object Destination coordinates to use for driving directions to the entity, as provided by you
timezone	string >= 0 characters The timezone of the entity, in the standard `IANA time zone database` format (tz database). e.g. `"America/New_York"`
tollFreePhone	string >= 0 characters Must be a valid phone number. If the phone number's calling code is for a country other than the one given in the entity's `countryCode`, the phone number provided must contain the calling code (e.g., `+44` in `+442038083831`). Otherwise, the calling code is optional.
ttyPhone	string >= 0 characters Must be a valid phone number. If the phone number's calling code is for a country other than the one given in the entity's `countryCode`, the phone number provided must contain the calling code (e.g., `+44` in `+442038083831`). Otherwise, the calling code is optional.
	object Destination coordinates to use for walking directions to the entity, as provided by you
	object Information about the website for this entity

Responses

Request samples

Payload

Content type

application/json

Example

atm

{"EntityType": "atm",
"meta": {"countryCode": "string",
"folderId": "string",
"id": "string",
"labels": ["string"
],
"language": "string"
},
"name": "string",
"address": {"city": "string",
"countryCode": "string",
"extraDescription": "string",
"line1": "string",
"line2": "string",
"postalCode": "string",
"region": "string",
"sublocality": "string"
},
"accessHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"additionalHoursText": "string",
"alternateNames": ["string"
],
"alternatePhone": "string",
"alternateWebsites": ["http://example.com"
],
"appleActionLinks": [{"appName": "string",
"appStoreUrl": "http://example.com",
"category": "BOOK_TRAVEL",
"quickLinkUrl": "http://example.com"
}
],
"appleBusinessDescription": "string",
"appleBusinessId": "string",
"appleCompanyId": "string",
"appleCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"categories": { },
"categoryIds": ["string"
],
"closed": true,
"customKeywords": ["string"
],
"description": "stringstri",
"displayCoordinate": {"latitude": -90,
"longitude": -180
},
"driveThroughHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"dropoffCoordinate": {"latitude": -90,
"longitude": -180
},
"facebookAbout": "string",
"facebookCallToAction": {"type": "NONE",
"value": "string"
},
"facebookCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"facebookDescriptor": "string",
"facebookName": "string",
"facebookOverrideCity": "string",
"facebookPageUrl": "string",
"facebookParentPageId": "string",
"facebookProfilePhoto": {"alternateText": "string",
"url": "http://example.com"
},
"facebookStoreId": "string",
"facebookVanityUrl": "string",
"facebookWebsiteOverride": "http://example.com",
"fax": "string",
"featuredMessage": {"description": "string",
"url": "http://example.com"
},
"frequentlyAskedQuestions": [{"answer": "string",
"question": "string"
}
],
"geomodifier": "string",
"googleAttributes": { },
"googleCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"googleMyBusinessLabels": ["string"
],
"googlePlaceId": "string",
"googleProfilePhoto": {"alternateText": "string",
"url": "http://example.com"
},
"googleWebsiteOverride": "http://example.com",
"holidayHoursConversationEnabled": true,
"hours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"impressum": "string",
"isoRegionCode": "string",
"keywords": ["string"
],
"labels": ["string"
],
"landingPageUrl": "http://example.com",
"localPhone": "string",
"locatedIn": "string",
"locationType": "LOCATION",
"logo": {"clickthroughUrl": "http://example.com",
"description": "string",
"details": "string",
"image": {"alternateText": "string",
"url": "http://example.com"
}
},
"mainPhone": "string",
"mobilePhone": "string",
"nudgeEnabled": true,
"photoGallery": [{"clickthroughUrl": "http://example.com",
"description": "string",
"details": "string",
"image": {"alternateText": "string",
"url": "http://example.com"
}
}
],
"pickupCoordinate": {"latitude": -90,
"longitude": -180
},
"priceRange": "UNSPECIFIED",
"primaryConversationContact": "string",
"questionsAndAnswers": true,
"rankTrackingCompetitors": [{"name": "string",
"website": "http://example.com"
}
],
"rankTrackingEnabled": true,
"rankTrackingFrequency": "WEEKLY",
"rankTrackingQueryTemplates": ["KEYWORD"
],
"rankTrackingSites": ["GOOGLE_DESKTOP"
],
"reviewResponseConversationEnabled": true,
"routableCoordinate": {"latitude": -90,
"longitude": -180
},
"timezone": "string",
"tollFreePhone": "string",
"ttyPhone": "string",
"walkableCoordinate": {"latitude": -90,
"longitude": -180
},
"websiteUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
}
}

Response samples

Content type

application/json

{"meta": {"uuid": "string"
},
"response": {"meta": {"accountId": "string",
"countryCode": "string",
"createdTimestamp": "string",
"entityType": "string",
"folderId": "string",
"id": "string",
"labels": ["string"
],
"language": "string",
"timestamp": "string",
"uid": "string"
},
"name": "string",
"address": {"city": "string",
"countryCode": "string",
"extraDescription": "string",
"line1": "string",
"line2": "string",
"postalCode": "string",
"region": "string",
"sublocality": "string"
},
"acceptingNewPatients": true,
"acceptsReservations": true,
"accessHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"additionalHoursText": "string",
"additionalPromotingLocations": ["string"
],
"addressHidden": true,
"admittingHospitals": ["string"
],
"adultPool": "YES",
"ageRange": {"maxValue": 0,
"minValue": 0
},
"airportShuttle": "AIRPORT_SHUTTLE_AVAILABLE",
"airportTransfer": "YES",
"allInclusive": "ALL_INCLUSIVE_RATES_AVAILABLE",
"alternateNames": ["string"
],
"alternatePhone": "string",
"alternateWebsites": ["http://example.com"
],
"androidAppUrl": "string",
"answer": "string",
"appleActionLinks": [{"appName": "string",
"appStoreUrl": "http://example.com",
"category": "BOOK_TRAVEL",
"quickLinkUrl": "http://example.com"
}
],
"appleBusinessDescription": "string",
"appleBusinessId": "string",
"appleCompanyId": "string",
"appleCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"applicationUrl": "http://example.com",
"associations": ["string"
],
"attendance": {"attendanceMode": "OFFLINE",
"virtualLocationUrl": "http://example.com"
},
"attire": "UNSPECIFIED",
"babysittingOffered": "YES",
"baggageStorage": "YES",
"bar": "YES",
"beachAccess": "YES",
"beachFrontProperty": "YES",
"bicycles": "BICYCLE_RENTALS",
"bios": {"ids": ["string"
],
"label": "string"
},
"boutiqueStores": "YES",
"brands": ["string"
],
"breakfast": "BREAKFAST_AVAILABLE",
"brunchHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"businessCenter": "YES",
"calendars": {"ids": ["string"
],
"label": "string"
},
"carRental": "YES",
"casino": "YES",
"categories": { },
"categoryIds": ["string"
],
"catsAllowed": "YES",
"certifications": ["string"
],
"checkInTime": "14:15:22Z",
"checkOutTime": "14:15:22Z",
"classificationRating": "string",
"closed": true,
"concierge": "YES",
"conditionsTreated": ["string"
],
"convenienceStore": "YES",
"covidMessaging": "string",
"covidTestAppointmentUrl": "http://example.com",
"covidTestingAppointmentRequired": true,
"covidTestingDriveThroughSite": true,
"covidTestingIsFree": true,
"covidTestingPatientRestrictions": true,
"covidTestingReferralRequired": true,
"covidTestingSiteInstructions": "string",
"covidVaccineAppointmentRequired": true,
"covidVaccineDriveThroughSite": true,
"covidVaccineInformationUrl": "http://example.com",
"covidVaccinePatientRestrictions": true,
"covidVaccineReferralRequired": true,
"covidVaccineSiteInstructions": "string",
"covidVaccinesOffered": ["PFIZER"
],
"currencyExchange": "YES",
"customKeywords": ["string"
],
"datePosted": "2019-08-24",
"degrees": ["ANP"
],
"deliveryHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"description": "stringstri",
"displayCoordinate": {"latitude": -90,
"longitude": -180
},
"doctorOnCall": "YES",
"dogsAllowed": "YES",
"driveThroughHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"dropoffCoordinate": {"latitude": -90,
"longitude": -180
},
"educationList": [{"institutionName": "string",
"type": "FELLOWSHIP",
"yearCompleted": 1900
}
],
"electricChargingStation": "YES",
"elevator": "YES",
"ellipticalMachine": "YES",
"emails": ["user@example.com"
],
"employmentType": "FULL_TIME",
"eventStatus": "SCHEDULED",
"facebookAbout": "string",
"facebookCallToAction": {"type": "NONE",
"value": "string"
},
"facebookCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"facebookDescriptor": "string",
"facebookName": "string",
"facebookOverrideCity": "string",
"facebookPageUrl": "string",
"facebookParentPageId": "string",
"facebookProfilePhoto": {"alternateText": "string",
"url": "http://example.com"
},
"facebookStoreId": "string",
"facebookVanityUrl": "string",
"facebookWebsiteOverride": "http://example.com",
"fax": "string",
"featuredMessage": {"description": "string",
"url": "http://example.com"
},
"firstName": "string",
"firstPartyReviewPage": "string",
"fitnessCenter": "FITNESS_CENTER_AVAILABLE",
"floorCount": 0,
"freeWeights": "YES",
"frequentlyAskedQuestions": [{"answer": "string",
"question": "string"
}
],
"frontDesk": "FRONT_DESK_AVAILABLE",
"fullyVaccinatedStaff": true,
"gameRoom": "YES",
"gender": "UNSPECIFIED",
"geomodifier": "string",
"giftShop": "YES",
"golf": "YES",
"googleAttributes": { },
"googleCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"googleMyBusinessLabels": ["string"
],
"googlePlaceId": "string",
"googleProfilePhoto": {"alternateText": "string",
"url": "http://example.com"
},
"googleWebsiteOverride": "http://example.com",
"happyHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"headshot": {"alternateText": "string",
"url": "http://example.com"
},
"hiringOrganization": "string",
"holidayHoursConversationEnabled": true,
"horsebackRiding": "YES",
"hotTub": "YES",
"hours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"housekeeping": "HOUSEKEEPING_AVAILABLE",
"impressum": "string",
"indoorPoolCount": 0,
"instagramHandle": "string",
"insuranceAccepted": ["string"
],
"iosAppUrl": "string",
"isClusterPrimary": true,
"isFreeEvent": true,
"isoRegionCode": "string",
"keywords": ["string"
],
"kidFriendly": "YES",
"kidsClub": "YES",
"kidsStayFree": "YES",
"kitchenHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"labels": ["string"
],
"landingPageUrl": "http://example.com",
"languages": ["string"
],
"lastName": "string",
"laundry": "FULL_SERVICE",
"lazyRiver": "YES",
"lifeguard": "YES",
"linkedInUrl": "http://example.com",
"linkedLocation": "string",
"localPhone": "string",
"localShuttle": "YES",
"locatedIn": "string",
"location": {"existingLocation": "string",
"externalLocation": "string"
},
"locationType": "LOCATION",
"logo": {"clickthroughUrl": "http://example.com",
"description": "string",
"details": "string",
"image": {"alternateText": "string",
"url": "http://example.com"
}
},
"mainPhone": "string",
"massage": "YES",
"maxAgeOfKidsStayFree": 0,
"maxNumberOfKidsStayFree": 0,
"mealsServed": ["BREAKFAST"
],
"meetingRoomCount": 0,
"menuUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"menus": {"ids": ["string"
],
"label": "string"
},
"middleName": "string",
"mobilePhone": "string",
"mobilityAccessible": "YES",
"nightclub": "YES",
"npi": "string",
"nudgeEnabled": true,
"officeName": "string",
"onlineServiceHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"operatingCountries": ["AD"
],
"orderUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"organizerEmail": "user@example.com",
"organizerName": "string",
"organizerPhone": "string",
"outdoorPoolCount": 0,
"parking": "PARKING_AVAILABLE",
"paymentOptions": ["AFTERPAY"
],
"performers": ["string"
],
"petsAllowed": "PETS_WELCOME",
"photoGallery": [{"clickthroughUrl": "http://example.com",
"description": "string",
"details": "string",
"image": {"alternateText": "string",
"url": "http://example.com"
}
}
],
"pickupCoordinate": {"latitude": -90,
"longitude": -180
},
"pickupHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"pinterestUrl": "http://example.com",
"priceRange": "UNSPECIFIED",
"primaryConversationContact": "string",
"privateBeach": "YES",
"privateCarService": "PRIVATE_CAR_SERVICE",
"productLists": {"ids": ["string"
],
"label": "string"
},
"products": ["string"
],
"questionsAndAnswers": true,
"rankTrackingCompetitors": [{"name": "string",
"website": "http://example.com"
}
],
"rankTrackingEnabled": true,
"rankTrackingFrequency": "WEEKLY",
"rankTrackingQueryTemplates": ["KEYWORD"
],
"rankTrackingSites": ["GOOGLE_DESKTOP"
],
"reservationUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"restaurantCount": 0,
"reviewGenerationUrl": "string",
"reviewResponseConversationEnabled": true,
"roomCount": 0,
"roomService": "ROOM_SERVICE_AVAILABLE",
"routableCoordinate": {"latitude": -90,
"longitude": -180
},
"salon": "YES",
"sauna": "YES",
"scuba": "YES",
"selfParking": "SELF_PARKING_AVAILABLE",
"seniorHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"serviceArea": {"places": ["string"
]
},
"serviceAreaPlaces": [{"name": "string",
"googlePlaceId": "string",
"type": "POSTAL_CODE"
}
],
"services": ["string"
],
"smokeFreeProperty": "YES",
"snorkeling": "YES",
"socialHour": "YES",
"spa": "YES",
"specialities": ["string"
],
"tableService": "YES",
"takeoutHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"tennis": "YES",
"thermalPool": "YES",
"ticketAvailability": "IN_STOCK",
"ticketPriceRange": {"currencyCode": "string",
"maxValue": "string",
"minValue": "string"
},
"ticketSaleDateTime": "2019-08-24T14:15:22Z",
"ticketUrl": "http://example.com",
"tikTokUrl": "http://example.com",
"time": {"end": "2019-08-24T14:15:22Z",
"start": "2019-08-24T14:15:22Z"
},
"timeZoneUtcOffset": "string",
"timezone": "string",
"tollFreePhone": "string",
"treadmill": "YES",
"ttyPhone": "string",
"turndownService": "YES",
"twitterHandle": "string",
"uberLink": {"presentation": "BUTTON",
"text": "string"
},
"uberTripBranding": {"description": "string",
"text": "string",
"url": "http://example.com"
},
"valetParking": "VALET_PARKING_AVAILABLE",
"validThrough": "2019-08-24T14:15:22Z",
"vendingMachine": "YES",
"venueName": "string",
"videos": [{"description": "string",
"video": {"url": "http://example.com"
}
}
],
"wadingPool": "YES",
"wakeUpCalls": "YES",
"walkableCoordinate": {"latitude": -90,
"longitude": -180
},
"waterPark": "YES",
"waterSkiing": "YES",
"watercraft": "WATERCRAFT_RENTALS",
"waterslide": "YES",
"wavePool": "YES",
"websiteUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"weightMachine": "YES",
"wheelchairAccessible": "YES",
"wifiAvailable": "WIFI_AVAILABLE",
"workRemote": true,
"yearEstablished": 1000,
"yearLastRenovated": 1000,
"yextDisplayCoordinate": {"latitude": -90,
"longitude": -180
},
"yextDropoffCoordinate": {"latitude": -90,
"longitude": -180
},
"yextPickupCoordinate": {"latitude": -90,
"longitude": -180
},
"yextRoutableCoordinate": {"latitude": -90,
"longitude": -180
},
"yextWalkableCoordinate": {"latitude": -90,
"longitude": -180
},
"youTubeChannelUrl": "http://example.com"
}
}

Entities: Get

Retrieve information for an Entity with a given ID

NOTE

If the v parameter is 20240221 or later: returned entities replace the categoryIds field with the categories field.

path Parameters

accountId required	string >= 0 characters
entityId required	string >= 0 characters The external ID of the requested Entity

query Parameters

v required	string >= 0 characters A date in `YYYYMMDD` format.
convertMarkdownToHTML	string >= 0 characters Optional parameter to return fields of type Markdown as HTML. `false`: Markdown fields will be returned as JSON `true`: Markdown fields will be returned as HTML
convertRichTextToHTML	string >= 0 characters Optional parameter to return fields of type Rich Text as HTML. `false`: Rich Text fields will be returned as JSON `true`: Rich Text fields will be returned as HTML
fields	string >= 0 characters Comma-separated list of field names. When present, only the fields listed will be returned. You can use dot notation to specify substructures (e.g., `"address.line1"`). Custom fields are specified in the same way, albeit with their `c_*` name.
format	string >= 0 characters Default: "markdown" Present if and only if at least one field is of type "Legacy Rich Text." Valid values: `markdown` `html` `none`
resolvePlaceholders	boolean Default: "false" Optional parameter to resolve all embedded fields in a Location object response. `false`: Location object returns placeholder labels, e.g., "Your [[CITY]] store" `true`: Location object returns placeholder values, e.g., "Your Fairfax store"

Responses

Response samples

Content type

application/json

{"meta": {"uuid": "string"
},
"response": {"meta": {"accountId": "string",
"countryCode": "string",
"createdTimestamp": "string",
"entityType": "string",
"folderId": "string",
"id": "string",
"labels": ["string"
],
"language": "string",
"timestamp": "string",
"uid": "string"
},
"name": "string",
"address": {"city": "string",
"countryCode": "string",
"extraDescription": "string",
"line1": "string",
"line2": "string",
"postalCode": "string",
"region": "string",
"sublocality": "string"
},
"acceptingNewPatients": true,
"acceptsReservations": true,
"accessHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"additionalHoursText": "string",
"additionalPromotingLocations": ["string"
],
"addressHidden": true,
"admittingHospitals": ["string"
],
"adultPool": "YES",
"ageRange": {"maxValue": 0,
"minValue": 0
},
"airportShuttle": "AIRPORT_SHUTTLE_AVAILABLE",
"airportTransfer": "YES",
"allInclusive": "ALL_INCLUSIVE_RATES_AVAILABLE",
"alternateNames": ["string"
],
"alternatePhone": "string",
"alternateWebsites": ["http://example.com"
],
"androidAppUrl": "string",
"answer": "string",
"appleActionLinks": [{"appName": "string",
"appStoreUrl": "http://example.com",
"category": "BOOK_TRAVEL",
"quickLinkUrl": "http://example.com"
}
],
"appleBusinessDescription": "string",
"appleBusinessId": "string",
"appleCompanyId": "string",
"appleCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"applicationUrl": "http://example.com",
"associations": ["string"
],
"attendance": {"attendanceMode": "OFFLINE",
"virtualLocationUrl": "http://example.com"
},
"attire": "UNSPECIFIED",
"babysittingOffered": "YES",
"baggageStorage": "YES",
"bar": "YES",
"beachAccess": "YES",
"beachFrontProperty": "YES",
"bicycles": "BICYCLE_RENTALS",
"bios": {"ids": ["string"
],
"label": "string"
},
"boutiqueStores": "YES",
"brands": ["string"
],
"breakfast": "BREAKFAST_AVAILABLE",
"brunchHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"businessCenter": "YES",
"calendars": {"ids": ["string"
],
"label": "string"
},
"carRental": "YES",
"casino": "YES",
"categories": { },
"categoryIds": ["string"
],
"catsAllowed": "YES",
"certifications": ["string"
],
"checkInTime": "14:15:22Z",
"checkOutTime": "14:15:22Z",
"classificationRating": "string",
"closed": true,
"concierge": "YES",
"conditionsTreated": ["string"
],
"convenienceStore": "YES",
"covidMessaging": "string",
"covidTestAppointmentUrl": "http://example.com",
"covidTestingAppointmentRequired": true,
"covidTestingDriveThroughSite": true,
"covidTestingIsFree": true,
"covidTestingPatientRestrictions": true,
"covidTestingReferralRequired": true,
"covidTestingSiteInstructions": "string",
"covidVaccineAppointmentRequired": true,
"covidVaccineDriveThroughSite": true,
"covidVaccineInformationUrl": "http://example.com",
"covidVaccinePatientRestrictions": true,
"covidVaccineReferralRequired": true,
"covidVaccineSiteInstructions": "string",
"covidVaccinesOffered": ["PFIZER"
],
"currencyExchange": "YES",
"customKeywords": ["string"
],
"datePosted": "2019-08-24",
"degrees": ["ANP"
],
"deliveryHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"description": "stringstri",
"displayCoordinate": {"latitude": -90,
"longitude": -180
},
"doctorOnCall": "YES",
"dogsAllowed": "YES",
"driveThroughHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"dropoffCoordinate": {"latitude": -90,
"longitude": -180
},
"educationList": [{"institutionName": "string",
"type": "FELLOWSHIP",
"yearCompleted": 1900
}
],
"electricChargingStation": "YES",
"elevator": "YES",
"ellipticalMachine": "YES",
"emails": ["user@example.com"
],
"employmentType": "FULL_TIME",
"eventStatus": "SCHEDULED",
"facebookAbout": "string",
"facebookCallToAction": {"type": "NONE",
"value": "string"
},
"facebookCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"facebookDescriptor": "string",
"facebookName": "string",
"facebookOverrideCity": "string",
"facebookPageUrl": "string",
"facebookParentPageId": "string",
"facebookProfilePhoto": {"alternateText": "string",
"url": "http://example.com"
},
"facebookStoreId": "string",
"facebookVanityUrl": "string",
"facebookWebsiteOverride": "http://example.com",
"fax": "string",
"featuredMessage": {"description": "string",
"url": "http://example.com"
},
"firstName": "string",
"firstPartyReviewPage": "string",
"fitnessCenter": "FITNESS_CENTER_AVAILABLE",
"floorCount": 0,
"freeWeights": "YES",
"frequentlyAskedQuestions": [{"answer": "string",
"question": "string"
}
],
"frontDesk": "FRONT_DESK_AVAILABLE",
"fullyVaccinatedStaff": true,
"gameRoom": "YES",
"gender": "UNSPECIFIED",
"geomodifier": "string",
"giftShop": "YES",
"golf": "YES",
"googleAttributes": { },
"googleCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"googleMyBusinessLabels": ["string"
],
"googlePlaceId": "string",
"googleProfilePhoto": {"alternateText": "string",
"url": "http://example.com"
},
"googleWebsiteOverride": "http://example.com",
"happyHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"headshot": {"alternateText": "string",
"url": "http://example.com"
},
"hiringOrganization": "string",
"holidayHoursConversationEnabled": true,
"horsebackRiding": "YES",
"hotTub": "YES",
"hours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"housekeeping": "HOUSEKEEPING_AVAILABLE",
"impressum": "string",
"indoorPoolCount": 0,
"instagramHandle": "string",
"insuranceAccepted": ["string"
],
"iosAppUrl": "string",
"isClusterPrimary": true,
"isFreeEvent": true,
"isoRegionCode": "string",
"keywords": ["string"
],
"kidFriendly": "YES",
"kidsClub": "YES",
"kidsStayFree": "YES",
"kitchenHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"labels": ["string"
],
"landingPageUrl": "http://example.com",
"languages": ["string"
],
"lastName": "string",
"laundry": "FULL_SERVICE",
"lazyRiver": "YES",
"lifeguard": "YES",
"linkedInUrl": "http://example.com",
"linkedLocation": "string",
"localPhone": "string",
"localShuttle": "YES",
"locatedIn": "string",
"location": {"existingLocation": "string",
"externalLocation": "string"
},
"locationType": "LOCATION",
"logo": {"clickthroughUrl": "http://example.com",
"description": "string",
"details": "string",
"image": {"alternateText": "string",
"url": "http://example.com"
}
},
"mainPhone": "string",
"massage": "YES",
"maxAgeOfKidsStayFree": 0,
"maxNumberOfKidsStayFree": 0,
"mealsServed": ["BREAKFAST"
],
"meetingRoomCount": 0,
"menuUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"menus": {"ids": ["string"
],
"label": "string"
},
"middleName": "string",
"mobilePhone": "string",
"mobilityAccessible": "YES",
"nightclub": "YES",
"npi": "string",
"nudgeEnabled": true,
"officeName": "string",
"onlineServiceHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"operatingCountries": ["AD"
],
"orderUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"organizerEmail": "user@example.com",
"organizerName": "string",
"organizerPhone": "string",
"outdoorPoolCount": 0,
"parking": "PARKING_AVAILABLE",
"paymentOptions": ["AFTERPAY"
],
"performers": ["string"
],
"petsAllowed": "PETS_WELCOME",
"photoGallery": [{"clickthroughUrl": "http://example.com",
"description": "string",
"details": "string",
"image": {"alternateText": "string",
"url": "http://example.com"
}
}
],
"pickupCoordinate": {"latitude": -90,
"longitude": -180
},
"pickupHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"pinterestUrl": "http://example.com",
"priceRange": "UNSPECIFIED",
"primaryConversationContact": "string",
"privateBeach": "YES",
"privateCarService": "PRIVATE_CAR_SERVICE",
"productLists": {"ids": ["string"
],
"label": "string"
},
"products": ["string"
],
"questionsAndAnswers": true,
"rankTrackingCompetitors": [{"name": "string",
"website": "http://example.com"
}
],
"rankTrackingEnabled": true,
"rankTrackingFrequency": "WEEKLY",
"rankTrackingQueryTemplates": ["KEYWORD"
],
"rankTrackingSites": ["GOOGLE_DESKTOP"
],
"reservationUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"restaurantCount": 0,
"reviewGenerationUrl": "string",
"reviewResponseConversationEnabled": true,
"roomCount": 0,
"roomService": "ROOM_SERVICE_AVAILABLE",
"routableCoordinate": {"latitude": -90,
"longitude": -180
},
"salon": "YES",
"sauna": "YES",
"scuba": "YES",
"selfParking": "SELF_PARKING_AVAILABLE",
"seniorHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"serviceArea": {"places": ["string"
]
},
"serviceAreaPlaces": [{"name": "string",
"googlePlaceId": "string",
"type": "POSTAL_CODE"
}
],
"services": ["string"
],
"smokeFreeProperty": "YES",
"snorkeling": "YES",
"socialHour": "YES",
"spa": "YES",
"specialities": ["string"
],
"tableService": "YES",
"takeoutHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"tennis": "YES",
"thermalPool": "YES",
"ticketAvailability": "IN_STOCK",
"ticketPriceRange": {"currencyCode": "string",
"maxValue": "string",
"minValue": "string"
},
"ticketSaleDateTime": "2019-08-24T14:15:22Z",
"ticketUrl": "http://example.com",
"tikTokUrl": "http://example.com",
"time": {"end": "2019-08-24T14:15:22Z",
"start": "2019-08-24T14:15:22Z"
},
"timeZoneUtcOffset": "string",
"timezone": "string",
"tollFreePhone": "string",
"treadmill": "YES",
"ttyPhone": "string",
"turndownService": "YES",
"twitterHandle": "string",
"uberLink": {"presentation": "BUTTON",
"text": "string"
},
"uberTripBranding": {"description": "string",
"text": "string",
"url": "http://example.com"
},
"valetParking": "VALET_PARKING_AVAILABLE",
"validThrough": "2019-08-24T14:15:22Z",
"vendingMachine": "YES",
"venueName": "string",
"videos": [{"description": "string",
"video": {"url": "http://example.com"
}
}
],
"wadingPool": "YES",
"wakeUpCalls": "YES",
"walkableCoordinate": {"latitude": -90,
"longitude": -180
},
"waterPark": "YES",
"waterSkiing": "YES",
"watercraft": "WATERCRAFT_RENTALS",
"waterslide": "YES",
"wavePool": "YES",
"websiteUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"weightMachine": "YES",
"wheelchairAccessible": "YES",
"wifiAvailable": "WIFI_AVAILABLE",
"workRemote": true,
"yearEstablished": 1000,
"yearLastRenovated": 1000,
"yextDisplayCoordinate": {"latitude": -90,
"longitude": -180
},
"yextDropoffCoordinate": {"latitude": -90,
"longitude": -180
},
"yextPickupCoordinate": {"latitude": -90,
"longitude": -180
},
"yextRoutableCoordinate": {"latitude": -90,
"longitude": -180
},
"yextWalkableCoordinate": {"latitude": -90,
"longitude": -180
},
"youTubeChannelUrl": "http://example.com"
}
}

Entities: Update

Update the Entity with the given ID

NOTE

If the v parameter is 20240221 or later: returned Entity replaces the categoryIds field with the categories field.

path Parameters

accountId required	string >= 0 characters
entityId required	string >= 0 characters The external ID of the requested Entity

query Parameters

v required	string >= 0 characters A date in `YYYYMMDD` format.
format	string >= 0 characters Default: "markdown" The formatting language used to parse rich text field values. Present and required if an only if the request contains a field with type "Rich Text." Valid values: `markdown` `html`
stripUnsupportedFormats	boolean Optional parameter to strip unsupported formats in rich text fields. When this parameter is included, the unsupported formats in rich text fields will be stripped and saved as plain text; otherwise if this parameter is not included, unsupported formats will return an error.
templateFields	string >= 0 characters Comma-separated list of top-level fields to apply from the template. If provided, only the fields specified will be applied to the entity. Ignored if `templateId` is not provided.
templateId	string >= 0 characters The external ID of the template to apply to the entity NOTE: Some fields that are part of the provided template but not present in the API will be applied - e.g. Linked Accounts

header Parameters

Update-Operation-Id

string >= 0 characters

The ID of the operation. Leave this blank to create a new operation or supply an ID to continue an existing operation

Request Body schema: application/json

Information to update on the entity

EntityType	string This is used only to filter the fields below and should NOT be included in any API calls. If create, specify the entity type in the query parameter. If update, specify the entity type in the request body in the `meta` object. atm
	object Contains the metadata about the entity.
name	string [ 0 .. 5000 ] characters Cannot Include: HTML markup
	object Contains the address of the entity (or where the entity is located) Must be a valid address Cannot be a P.O. Box If the entity is an `event`, either an `address` value or a `linkedLocation` value can be provided.
	object Contains the daily access hours, holiday access hours, and reopen date for the Entity. Each day is represented by a sub-field of `accessHours`. (e.g. `monday`, `tuesday`, etc.) Open times can be specified per day through the `openIntervals` field and the `isClosed` flag. Similarly, holiday access hours are represented by the `holidayHours` sub-field. Setting the `reopenDate` sub-field indicates that the business is temporarily closed and will reopen on the specified date. SPECIAL CASES: To indicate that an Entity is open 24 hours on a specific day, set start to 00:00 and end to 23:59 in `openIntervals` for that day. To indicate that an Entity has split hours on a specific day (e.g., open from 9:00 AM to 12:00 PM and again from 1:00 PM to 5:00 PM), supply two or more `openIntervals` values with non-overlapping sets of hours. If you are providing `openIntervals`, you may not set `isClosed` to true for that day.
additionalHoursText	string [ 0 .. 255 ] characters Additional information about hours that does not fit in `hours` (e.g., `"Closed during the winter"`)
alternateNames	Array of strings unique [ items [ 0 .. 100 ] characters ] Other names for your business that you would like us to use when tracking your search performance Array must be ordered. Array may have a maximum of 3 elements. Array item description: Cannot Include: HTML markup
alternatePhone	string >= 0 characters Must be a valid phone number. If the phone number's calling code is for a country other than the one given in the entity's `countryCode`, the phone number provided must contain the calling code (e.g., `+44` in `+442038083831`). Otherwise, the calling code is optional.
alternateWebsites	Array of strings <uri> unique [ items <uri > [ 0 .. 255 ] characters ] Other websites for your business that we should search for when tracking your search performance Array must be ordered. Array may have a maximum of 3 elements. Array item description: Cannot Include: common domain names, e.g., google.com, youtube.com, etc.
	Array of objects unique Use this field to add action links to your Apple Listings. The call to action category will be displayed on the action link button. The App Store URL should contain a valid link to the landing page of an App in the Apple App Store. The Quick Link URL is where a user is taken when an action link is clicked by a user. The App Name sub-field is not displayed on Apple Listings and is only used to distinguish the call-to-action type when utilizing action links in Apple posts. Array must be ordered.
appleBusinessDescription	string [ 0 .. 500 ] characters The business description to be sent to Apple
appleBusinessId	string >= 0 characters ^\d\.?\d$ The ID associated with an individual Business Folder in your Apple account
appleCompanyId	string >= 0 characters ^\d\.?\d$ The ID associated with your Apple account. Numerical values only
	object The cover photo for the entity''s Apple profile Image must be at least 1600 x 1040 pixels Image may be no more than 4864 x 3163 pixels Supported Aspect Ratios: 154 x 100 NOTE: Maximum image size is 5mb after normalization and padding (if applicable). As well, there is a 6 second download limit from the image host.
categories	object Yext Categories. (Supported for versions > 20240220) A map of category list external IDs (i.e. "yext") to a list of category IDs. IDs must be valid and selectable (i.e., cannot be parent categories). Partial updates are accepted, meaning sending only the "yext" property will have no effect on any category list except the "yext" category.
categoryIds	Array of strings[ items >= 0 characters ] Yext Category IDs. (Deprecated: For versions > 20240220) IDs must be valid and selectable (i.e., cannot be parent categories). NOTE: The list of category IDs that you send us must be comprehensive. For example, if you send us a list of IDs that does not include IDs that you sent in your last update, Yext considers the missing categories to be deleted, and we remove them from your listings.
closed	boolean Indicates whether the entity is closed
customKeywords	Array of strings unique [ items [ 0 .. 100 ] characters ] Additional keywords you would like us to use when tracking your search performance Array must be ordered. Array may have a maximum of 5 elements.
description	string [ 10 .. 15000 ] characters A description of the entity Cannot Include: HTML markup
	object Coordinates where the map pin for the entity should be displayed, as provided by you
	object Contains the daily drive-through hours, holiday drive-through hours, and reopen date for the Entity. Each day is represented by a sub-field of `driveThroughHours`. (e.g. `monday`, `tuesday`, etc.) Open times can be specified per day through the `openIntervals` field and the `isClosed` flag. Similarly, holiday drive-through hours are represented by the `holidayHours` sub-field. Setting the `reopenDate` sub-field indicates that the business is temporarily closed and will reopen on the specified date. SPECIAL CASES: To indicate that an Entity is open 24 hours on a specific day, set start to 00:00 and end to 23:59 in `openIntervals` for that day. To indicate that an Entity has split hours on a specific day (e.g., open from 9:00 AM to 12:00 PM and again from 1:00 PM to 5:00 PM), supply two or more `openIntervals` values with non-overlapping sets of hours. If you are providing `openIntervals`, you may not set `isClosed` to true for that day.
	object Coordinates of the drop-off area for the entity, as provided by you
facebookAbout	string [ 0 .. 255 ] characters A description of the entity to be used in the "About You" section on Facebook
	object Designates the Facebook Call-to-Action button text and value Valid contents of `value` depends on the Call-to-Action's `type`: `NONE`: (optional) `BOOK_NOW`: URL `CALL_NOW`: Phone number `CONTACT_US`: URL `SEND_MESSAGE`: Any string `USE_APP`: URL `PLAY_GAME`: URL `SHOP_NOW`: URL `SIGN_UP`: URL `WATCH_VIDEO`: URL `SEND_EMAIL`: Email address `LEARN_MORE`: URL `PURCHASE_GIFT_CARDS`: URL `ORDER_NOW`: URL `FOLLOW_PAGE`: Any string
	object The cover photo for the entity's Facebook profile Displayed as a 851 x 315 pixel image You may need a cover photo in order for your listing to appear on Facebook. Please check your listings tab to learn more. Image must be at least 400 x 150 pixels Image area (width x height) may be no more than 41000000 pixels Image may be no more than 30000 x 30000 pixels Supported Aspect Ratios: 1 x 1 4 x 3 3 x 2 5 x 3 16 x 9 3 x 1 2 x 3 5 x 7 4 x 5 4 x 1 NOTE: Maximum image size is 5mb after normalization and padding (if applicable). As well, there is a 6 second download limit from the image host.
facebookDescriptor	string [ 3 .. 75 ] characters Location Descriptors are used for Enterprise businesses that sync Facebook listings using brand page location structure. The Location Descriptor is typically an additional geographic description (e.g. geomodifier) that will appear in parentheses after the name on the Facebook listing. Cannot Include: HTML markup
facebookName	string >= 0 characters The name for this entity's Facebook profile. A separate name may be specified to send only to Facebook in order to comply with any specific Facebook rules or naming conventions.
facebookOverrideCity	string >= 0 characters The city to be displayed on this entity's Facebook profile
facebookPageUrl	string >= 0 characters URL for the entity's Facebook Page. Valid formats: facebook.com/profile.php?id=[numId] facebook.com/group.php?gid=[numId] facebook.com/groups/[numId] facebook.com/[Name] facebook.com/pages/[Name]/[numId] facebook.com/people/[Name]/[numId] where [Name] is a String and [numId] is an Integer The success response will contain a warning message explaining why the URL wasn't stored in the system.
facebookParentPageId	string [ 0 .. 65 ] characters The Facebook Page ID of this entity's brand page if in a brand page location structure
	object The profile picture for the entity's Facebook profile You must have a profile picture in order for your listing to appear on Facebook. Image must be at least 180 x 180 pixels Image area (width x height) may be no more than 41000000 pixels Image may be no more than 30000 x 30000 pixels Supported Aspect Ratios: 1 x 1 4 x 3 3 x 2 5 x 3 16 x 9 3 x 1 2 x 3 5 x 7 4 x 5 4 x 1 NOTE: Maximum image size is 5mb after normalization and padding (if applicable). As well, there is a 6 second download limit from the image host.
facebookStoreId	string >= 0 characters The Store ID used for this entity in a brand page location structure
facebookVanityUrl	string [ 0 .. 50 ] characters The username that appear's in the Facebook listing URL to help customers find and remember a brand’s Facebook page. The username is also be used for tagging the Facebook page in other users’ posts, and searching for the Facebook page.
facebookWebsiteOverride	string <uri> >= 0 characters The URL you would like to submit to Facebook in place of the one given in `websiteUrl` (if applicable).
fax	string >= 0 characters Must be a valid fax number. If the fax number's calling code is for a country other than the one given in the entity's `countryCode`, the fax number provided must contain the calling code (e.g., `+44` in `+442038083831`). Otherwise, the calling code is optional.
	object Information about the entity's Featured Message
	Array of objects unique A list of questions that are frequently asked about this entity Array must be ordered. Array may have a maximum of 100 elements.
geomodifier	string >= 0 characters Provides additional information on where the entity can be found (e.g., `Times Square`, `Global Center Mall`)
googleAttributes	object The unique IDs of the entity's Google Business Profile keywords, as well as the unique IDs of any values selected for each keyword. Valid keywords (e.g., `has_drive_through`, `has_fitting_room`, `kitchen_in_room`) are determined by the entity's primary category. A full list of keywords can be retrieved with the Google Fields: List endpoint. Keyword values provide more details on how the keyword applies to the entity (e.g., if the keyword is `has_drive_through`, its values may be `true` or `false`). If the `v` parameter is before `20181204`: `googleAttributes` is formatted as a map of key-value pairs (e.g., `[{ "id": "has_wheelchair_accessible_entrance", "values": [ "true" ] }]`) If the `v` parameter is on or after `20181204`: the contents are formatted as a list of objects (e.g., `{ "has_wheelchair_accessible_entrance": [ "true" ]}`) NOTE: The latest Google Attributes are available via the Google Fields: List endpoint. Google Attributes are managed by Google and are subject to change without notice. To prevent errors, make sure your API implementation is not dependent on the presence of specific attributes.
	object The cover photo for the entity's Google profile Image must be at least 250 x 250 pixels
googleMyBusinessLabels	Array of strings unique [ items [ 0 .. 50 ] characters ] Google Business Profile Labels help users organize their locations into groups within GBP. Array must be ordered. Array may have a maximum of 10 elements. Array item description: Cannot Include: HTML markup
googlePlaceId	string >= 0 characters The unique identifier of this entity on Google Maps.
	object The profile photo for the entity's Google profile Image must be at least 250 x 250 pixels Image may be no more than 5000 x 5000 pixels Supported Aspect Ratios: 1 x 1 NOTE: Maximum image size is 5mb after normalization and padding (if applicable). As well, there is a 6 second download limit from the image host.
googleWebsiteOverride	string <uri> >= 0 characters The URL you would like to submit to Google Business Profile in place of the one given in `websiteUrl` (if applicable). For example, if you want to analyze the traffic driven by your Google listings separately from other traffic, enter the alternate URL that you will use for tracking in this field.
holidayHoursConversationEnabled	boolean Indicates whether holiday-hour confirmation alerts are enabled for the Yext Knowledge Assistant for this entity
	object Contains the daily hours, holiday hours, and reopen date for the Entity. Each day is represented by a sub-field of `hours`. (e.g. `monday`, `tuesday`, etc.) Open times can be specified per day through the `openIntervals` field and the `isClosed` flag. Similarly, holiday hours are represented by the `holidayHours` sub-field. Setting the `reopenDate` sub-field indicates that the business is temporarily closed and will reopen on the specified date. SPECIAL CASES: To indicate that an Entity is open 24 hours on a specific day, set start to 00:00 and end to 23:59 in `openIntervals` for that day. To indicate that an Entity has split hours on a specific day (e.g., open from 9:00 AM to 12:00 PM and again from 1:00 PM to 5:00 PM), supply two or more `openIntervals` values with non-overlapping sets of hours. If you are providing `openIntervals`, you may not set `isClosed` to true for that day.
impressum	string [ 0 .. 2000 ] characters A statement of the ownership and authorship of a document. Individuals or organizations based in many German-speaking countries are required by law to include an Impressum in published media.
isoRegionCode	string >= 0 characters The ISO 3166-2 region code for the entity Yext will determine the entity's code and update `isoRegionCode` with that value. If Yext is unable to determine the code for the entity, the entity'ss ISO 3166-1 alpha-2 country code will be used.
keywords	Array of strings unique [ items [ 0 .. 100 ] characters ] Keywords that describe the entity. All strings must be non-empty when trimmed of whitespace. Array must be ordered. Array may have a maximum of 100 elements. Array item description: Cannot Include: HTML markup
labels	Array of strings[ items >= 0 characters ] The IDs of the entity labels that have been added to this entity. Entity labels help you identify entities that share a certain characteristic; they do not appear on your entity's listings. NOTE: You can only add labels that have already been created via our web interface. Currently, it is not possible to create new labels via the API.
landingPageUrl	string <uri> >= 0 characters The URL of this entity's Landing Page that was created with Yext Pages
localPhone	string >= 0 characters Must be a valid, non-toll-free phone number, based on the country specified in `address.region`. Phone numbers for US entities must contain 10 digits.
locatedIn	string For atms, the external ID of the entity that the atm is installed in. The entity must be in the same business account as the atm.
locationType	string Enum: "LOCATION" "HEALTHCARE_FACILITY" "HEALTHCARE_PROFESSIONAL" "ATM" "RESTAURANT" "HOTEL" Indicates the entity's type, if it is not an event
	object An image of the entity's logo Supported Aspect Ratios: 1 x 1 NOTE: Maximum image size is 5mb after normalization and padding (if applicable). As well, there is a 6 second download limit from the image host.
mainPhone	string >= 0 characters The main phone number of the entity's point of contact Must be a valid phone number. If the phone number's calling code is for a country other than the one given in the entity's `countryCode`, the phone number provided must contain the calling code (e.g., `+44` in `+442038083831`). Otherwise, the calling code is optional.
mobilePhone	string >= 0 characters Must be a valid phone number. If the phone number's calling code is for a country other than the one given in the entity's `countryCode`, the phone number provided must contain the calling code (e.g., `+44` in `+442038083831`). Otherwise, the calling code is optional.
nudgeEnabled	boolean Indicates whether Knowledge Nudge is enabled for the Yext Knowledge Assistant for this entity
	Array of objects NOTE: The list of photos that you send us must be comprehensive. For example, if you send us a list of photos that does not include photos that you sent in your last update, Yext considers the missing photos to be deleted, and we remove them from your listings. Array must be ordered. Array may have a maximum of 500 elements. Array item description: Supported Aspect Ratios: 1 x 1 4 x 3 3 x 2 5 x 3 16 x 9 3 x 1 2 x 3 5 x 7 4 x 5 4 x 1 NOTE: Maximum image size is 5mb after normalization and padding (if applicable). As well, there is a 6 second download limit from the image host.
	object Coordinates of where consumers can be picked up at the entity, as provided by you
priceRange	string Enum: "UNSPECIFIED" "ONE" "TWO" "THREE" "FOUR" he typical price of products sold by this location, on a scale of 1 (low) to 4 (high)
primaryConversationContact	string >= 0 characters ID of the user who is the primary Knowledge Assistant contact for the entity
questionsAndAnswers	boolean Indicates whether Yext Knowledge Assistant question-and-answer conversations are enabled for this entity
	Array of objects unique Information about the competitors whose search performance you would like to compare to your own Array must be ordered. Array may have a maximum of 5 elements.
rankTrackingEnabled	boolean Indicates whether Rank Tracking is enabled
rankTrackingFrequency	string Enum: "WEEKLY" "MONTHLY" "QUARTERLY" How often we send search queries to track your search performance
rankTrackingQueryTemplates	Array of strings unique Items Enum: "KEYWORD" "KEYWORD_ZIP" "KEYWORD_CITY" "KEYWORD_IN_CITY" "KEYWORD_NEAR_ME" "KEYWORD_CITY_STATE" The ways in which your keywords will be arranged in the search queries we use to track your performance Array must have a minimum of 2 elements. Array may have a maximum of 4 elements.
rankTrackingSites	Array of strings unique Items Enum: "GOOGLE_DESKTOP" "GOOGLE_MOBILE" "BING_DESKTOP" "BING_MOBILE" "YAHOO_DESKTOP" "YAHOO_MOBILE" The search engines that we will use to track your performance
reviewResponseConversationEnabled	boolean Indicates whether Yext Knowledge Assistant review-response conversations are enabled for this entity
	object Destination coordinates to use for driving directions to the entity, as provided by you
timezone	string >= 0 characters The timezone of the entity, in the standard `IANA time zone database` format (tz database). e.g. `"America/New_York"`
tollFreePhone	string >= 0 characters Must be a valid phone number. If the phone number's calling code is for a country other than the one given in the entity's `countryCode`, the phone number provided must contain the calling code (e.g., `+44` in `+442038083831`). Otherwise, the calling code is optional.
ttyPhone	string >= 0 characters Must be a valid phone number. If the phone number's calling code is for a country other than the one given in the entity's `countryCode`, the phone number provided must contain the calling code (e.g., `+44` in `+442038083831`). Otherwise, the calling code is optional.
	object Destination coordinates to use for walking directions to the entity, as provided by you
	object Information about the website for this entity

Responses

Request samples

Payload

Content type

application/json

Example

atm

{"EntityType": "atm",
"meta": {"countryCode": "string",
"folderId": "string",
"id": "string",
"labels": ["string"
],
"language": "string"
},
"name": "string",
"address": {"city": "string",
"countryCode": "string",
"extraDescription": "string",
"line1": "string",
"line2": "string",
"postalCode": "string",
"region": "string",
"sublocality": "string"
},
"accessHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"additionalHoursText": "string",
"alternateNames": ["string"
],
"alternatePhone": "string",
"alternateWebsites": ["http://example.com"
],
"appleActionLinks": [{"appName": "string",
"appStoreUrl": "http://example.com",
"category": "BOOK_TRAVEL",
"quickLinkUrl": "http://example.com"
}
],
"appleBusinessDescription": "string",
"appleBusinessId": "string",
"appleCompanyId": "string",
"appleCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"categories": { },
"categoryIds": ["string"
],
"closed": true,
"customKeywords": ["string"
],
"description": "stringstri",
"displayCoordinate": {"latitude": -90,
"longitude": -180
},
"driveThroughHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"dropoffCoordinate": {"latitude": -90,
"longitude": -180
},
"facebookAbout": "string",
"facebookCallToAction": {"type": "NONE",
"value": "string"
},
"facebookCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"facebookDescriptor": "string",
"facebookName": "string",
"facebookOverrideCity": "string",
"facebookPageUrl": "string",
"facebookParentPageId": "string",
"facebookProfilePhoto": {"alternateText": "string",
"url": "http://example.com"
},
"facebookStoreId": "string",
"facebookVanityUrl": "string",
"facebookWebsiteOverride": "http://example.com",
"fax": "string",
"featuredMessage": {"description": "string",
"url": "http://example.com"
},
"frequentlyAskedQuestions": [{"answer": "string",
"question": "string"
}
],
"geomodifier": "string",
"googleAttributes": { },
"googleCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"googleMyBusinessLabels": ["string"
],
"googlePlaceId": "string",
"googleProfilePhoto": {"alternateText": "string",
"url": "http://example.com"
},
"googleWebsiteOverride": "http://example.com",
"holidayHoursConversationEnabled": true,
"hours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"impressum": "string",
"isoRegionCode": "string",
"keywords": ["string"
],
"labels": ["string"
],
"landingPageUrl": "http://example.com",
"localPhone": "string",
"locatedIn": "string",
"locationType": "LOCATION",
"logo": {"clickthroughUrl": "http://example.com",
"description": "string",
"details": "string",
"image": {"alternateText": "string",
"url": "http://example.com"
}
},
"mainPhone": "string",
"mobilePhone": "string",
"nudgeEnabled": true,
"photoGallery": [{"clickthroughUrl": "http://example.com",
"description": "string",
"details": "string",
"image": {"alternateText": "string",
"url": "http://example.com"
}
}
],
"pickupCoordinate": {"latitude": -90,
"longitude": -180
},
"priceRange": "UNSPECIFIED",
"primaryConversationContact": "string",
"questionsAndAnswers": true,
"rankTrackingCompetitors": [{"name": "string",
"website": "http://example.com"
}
],
"rankTrackingEnabled": true,
"rankTrackingFrequency": "WEEKLY",
"rankTrackingQueryTemplates": ["KEYWORD"
],
"rankTrackingSites": ["GOOGLE_DESKTOP"
],
"reviewResponseConversationEnabled": true,
"routableCoordinate": {"latitude": -90,
"longitude": -180
},
"timezone": "string",
"tollFreePhone": "string",
"ttyPhone": "string",
"walkableCoordinate": {"latitude": -90,
"longitude": -180
},
"websiteUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
}
}

Response samples

Content type

application/json

{"meta": {"uuid": "string"
},
"response": {"meta": {"accountId": "string",
"countryCode": "string",
"createdTimestamp": "string",
"entityType": "string",
"folderId": "string",
"id": "string",
"labels": ["string"
],
"language": "string",
"timestamp": "string",
"uid": "string"
},
"name": "string",
"address": {"city": "string",
"countryCode": "string",
"extraDescription": "string",
"line1": "string",
"line2": "string",
"postalCode": "string",
"region": "string",
"sublocality": "string"
},
"acceptingNewPatients": true,
"acceptsReservations": true,
"accessHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"additionalHoursText": "string",
"additionalPromotingLocations": ["string"
],
"addressHidden": true,
"admittingHospitals": ["string"
],
"adultPool": "YES",
"ageRange": {"maxValue": 0,
"minValue": 0
},
"airportShuttle": "AIRPORT_SHUTTLE_AVAILABLE",
"airportTransfer": "YES",
"allInclusive": "ALL_INCLUSIVE_RATES_AVAILABLE",
"alternateNames": ["string"
],
"alternatePhone": "string",
"alternateWebsites": ["http://example.com"
],
"androidAppUrl": "string",
"answer": "string",
"appleActionLinks": [{"appName": "string",
"appStoreUrl": "http://example.com",
"category": "BOOK_TRAVEL",
"quickLinkUrl": "http://example.com"
}
],
"appleBusinessDescription": "string",
"appleBusinessId": "string",
"appleCompanyId": "string",
"appleCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"applicationUrl": "http://example.com",
"associations": ["string"
],
"attendance": {"attendanceMode": "OFFLINE",
"virtualLocationUrl": "http://example.com"
},
"attire": "UNSPECIFIED",
"babysittingOffered": "YES",
"baggageStorage": "YES",
"bar": "YES",
"beachAccess": "YES",
"beachFrontProperty": "YES",
"bicycles": "BICYCLE_RENTALS",
"bios": {"ids": ["string"
],
"label": "string"
},
"boutiqueStores": "YES",
"brands": ["string"
],
"breakfast": "BREAKFAST_AVAILABLE",
"brunchHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"businessCenter": "YES",
"calendars": {"ids": ["string"
],
"label": "string"
},
"carRental": "YES",
"casino": "YES",
"categories": { },
"categoryIds": ["string"
],
"catsAllowed": "YES",
"certifications": ["string"
],
"checkInTime": "14:15:22Z",
"checkOutTime": "14:15:22Z",
"classificationRating": "string",
"closed": true,
"concierge": "YES",
"conditionsTreated": ["string"
],
"convenienceStore": "YES",
"covidMessaging": "string",
"covidTestAppointmentUrl": "http://example.com",
"covidTestingAppointmentRequired": true,
"covidTestingDriveThroughSite": true,
"covidTestingIsFree": true,
"covidTestingPatientRestrictions": true,
"covidTestingReferralRequired": true,
"covidTestingSiteInstructions": "string",
"covidVaccineAppointmentRequired": true,
"covidVaccineDriveThroughSite": true,
"covidVaccineInformationUrl": "http://example.com",
"covidVaccinePatientRestrictions": true,
"covidVaccineReferralRequired": true,
"covidVaccineSiteInstructions": "string",
"covidVaccinesOffered": ["PFIZER"
],
"currencyExchange": "YES",
"customKeywords": ["string"
],
"datePosted": "2019-08-24",
"degrees": ["ANP"
],
"deliveryHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"description": "stringstri",
"displayCoordinate": {"latitude": -90,
"longitude": -180
},
"doctorOnCall": "YES",
"dogsAllowed": "YES",
"driveThroughHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"dropoffCoordinate": {"latitude": -90,
"longitude": -180
},
"educationList": [{"institutionName": "string",
"type": "FELLOWSHIP",
"yearCompleted": 1900
}
],
"electricChargingStation": "YES",
"elevator": "YES",
"ellipticalMachine": "YES",
"emails": ["user@example.com"
],
"employmentType": "FULL_TIME",
"eventStatus": "SCHEDULED",
"facebookAbout": "string",
"facebookCallToAction": {"type": "NONE",
"value": "string"
},
"facebookCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"facebookDescriptor": "string",
"facebookName": "string",
"facebookOverrideCity": "string",
"facebookPageUrl": "string",
"facebookParentPageId": "string",
"facebookProfilePhoto": {"alternateText": "string",
"url": "http://example.com"
},
"facebookStoreId": "string",
"facebookVanityUrl": "string",
"facebookWebsiteOverride": "http://example.com",
"fax": "string",
"featuredMessage": {"description": "string",
"url": "http://example.com"
},
"firstName": "string",
"firstPartyReviewPage": "string",
"fitnessCenter": "FITNESS_CENTER_AVAILABLE",
"floorCount": 0,
"freeWeights": "YES",
"frequentlyAskedQuestions": [{"answer": "string",
"question": "string"
}
],
"frontDesk": "FRONT_DESK_AVAILABLE",
"fullyVaccinatedStaff": true,
"gameRoom": "YES",
"gender": "UNSPECIFIED",
"geomodifier": "string",
"giftShop": "YES",
"golf": "YES",
"googleAttributes": { },
"googleCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"googleMyBusinessLabels": ["string"
],
"googlePlaceId": "string",
"googleProfilePhoto": {"alternateText": "string",
"url": "http://example.com"
},
"googleWebsiteOverride": "http://example.com",
"happyHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"headshot": {"alternateText": "string",
"url": "http://example.com"
},
"hiringOrganization": "string",
"holidayHoursConversationEnabled": true,
"horsebackRiding": "YES",
"hotTub": "YES",
"hours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"housekeeping": "HOUSEKEEPING_AVAILABLE",
"impressum": "string",
"indoorPoolCount": 0,
"instagramHandle": "string",
"insuranceAccepted": ["string"
],
"iosAppUrl": "string",
"isClusterPrimary": true,
"isFreeEvent": true,
"isoRegionCode": "string",
"keywords": ["string"
],
"kidFriendly": "YES",
"kidsClub": "YES",
"kidsStayFree": "YES",
"kitchenHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"labels": ["string"
],
"landingPageUrl": "http://example.com",
"languages": ["string"
],
"lastName": "string",
"laundry": "FULL_SERVICE",
"lazyRiver": "YES",
"lifeguard": "YES",
"linkedInUrl": "http://example.com",
"linkedLocation": "string",
"localPhone": "string",
"localShuttle": "YES",
"locatedIn": "string",
"location": {"existingLocation": "string",
"externalLocation": "string"
},
"locationType": "LOCATION",
"logo": {"clickthroughUrl": "http://example.com",
"description": "string",
"details": "string",
"image": {"alternateText": "string",
"url": "http://example.com"
}
},
"mainPhone": "string",
"massage": "YES",
"maxAgeOfKidsStayFree": 0,
"maxNumberOfKidsStayFree": 0,
"mealsServed": ["BREAKFAST"
],
"meetingRoomCount": 0,
"menuUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"menus": {"ids": ["string"
],
"label": "string"
},
"middleName": "string",
"mobilePhone": "string",
"mobilityAccessible": "YES",
"nightclub": "YES",
"npi": "string",
"nudgeEnabled": true,
"officeName": "string",
"onlineServiceHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"operatingCountries": ["AD"
],
"orderUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"organizerEmail": "user@example.com",
"organizerName": "string",
"organizerPhone": "string",
"outdoorPoolCount": 0,
"parking": "PARKING_AVAILABLE",
"paymentOptions": ["AFTERPAY"
],
"performers": ["string"
],
"petsAllowed": "PETS_WELCOME",
"photoGallery": [{"clickthroughUrl": "http://example.com",
"description": "string",
"details": "string",
"image": {"alternateText": "string",
"url": "http://example.com"
}
}
],
"pickupCoordinate": {"latitude": -90,
"longitude": -180
},
"pickupHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"pinterestUrl": "http://example.com",
"priceRange": "UNSPECIFIED",
"primaryConversationContact": "string",
"privateBeach": "YES",
"privateCarService": "PRIVATE_CAR_SERVICE",
"productLists": {"ids": ["string"
],
"label": "string"
},
"products": ["string"
],
"questionsAndAnswers": true,
"rankTrackingCompetitors": [{"name": "string",
"website": "http://example.com"
}
],
"rankTrackingEnabled": true,
"rankTrackingFrequency": "WEEKLY",
"rankTrackingQueryTemplates": ["KEYWORD"
],
"rankTrackingSites": ["GOOGLE_DESKTOP"
],
"reservationUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"restaurantCount": 0,
"reviewGenerationUrl": "string",
"reviewResponseConversationEnabled": true,
"roomCount": 0,
"roomService": "ROOM_SERVICE_AVAILABLE",
"routableCoordinate": {"latitude": -90,
"longitude": -180
},
"salon": "YES",
"sauna": "YES",
"scuba": "YES",
"selfParking": "SELF_PARKING_AVAILABLE",
"seniorHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"serviceArea": {"places": ["string"
]
},
"serviceAreaPlaces": [{"name": "string",
"googlePlaceId": "string",
"type": "POSTAL_CODE"
}
],
"services": ["string"
],
"smokeFreeProperty": "YES",
"snorkeling": "YES",
"socialHour": "YES",
"spa": "YES",
"specialities": ["string"
],
"tableService": "YES",
"takeoutHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"tennis": "YES",
"thermalPool": "YES",
"ticketAvailability": "IN_STOCK",
"ticketPriceRange": {"currencyCode": "string",
"maxValue": "string",
"minValue": "string"
},
"ticketSaleDateTime": "2019-08-24T14:15:22Z",
"ticketUrl": "http://example.com",
"tikTokUrl": "http://example.com",
"time": {"end": "2019-08-24T14:15:22Z",
"start": "2019-08-24T14:15:22Z"
},
"timeZoneUtcOffset": "string",
"timezone": "string",
"tollFreePhone": "string",
"treadmill": "YES",
"ttyPhone": "string",
"turndownService": "YES",
"twitterHandle": "string",
"uberLink": {"presentation": "BUTTON",
"text": "string"
},
"uberTripBranding": {"description": "string",
"text": "string",
"url": "http://example.com"
},
"valetParking": "VALET_PARKING_AVAILABLE",
"validThrough": "2019-08-24T14:15:22Z",
"vendingMachine": "YES",
"venueName": "string",
"videos": [{"description": "string",
"video": {"url": "http://example.com"
}
}
],
"wadingPool": "YES",
"wakeUpCalls": "YES",
"walkableCoordinate": {"latitude": -90,
"longitude": -180
},
"waterPark": "YES",
"waterSkiing": "YES",
"watercraft": "WATERCRAFT_RENTALS",
"waterslide": "YES",
"wavePool": "YES",
"websiteUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"weightMachine": "YES",
"wheelchairAccessible": "YES",
"wifiAvailable": "WIFI_AVAILABLE",
"workRemote": true,
"yearEstablished": 1000,
"yearLastRenovated": 1000,
"yextDisplayCoordinate": {"latitude": -90,
"longitude": -180
},
"yextDropoffCoordinate": {"latitude": -90,
"longitude": -180
},
"yextPickupCoordinate": {"latitude": -90,
"longitude": -180
},
"yextRoutableCoordinate": {"latitude": -90,
"longitude": -180
},
"yextWalkableCoordinate": {"latitude": -90,
"longitude": -180
},
"youTubeChannelUrl": "http://example.com"
}
}

Entities: Delete

Delete the Entity with the given ID

path Parameters

accountId required	string >= 0 characters
entityId required	string >= 0 characters The external ID of the requested Entity

query Parameters

required

string >= 0 characters

A date in YYYYMMDD format.

header Parameters

Update-Operation-Id

string >= 0 characters

The ID of the operation. Leave this blank to create a new operation or supply an ID to continue an existing operation

Responses

Response samples

Content type

application/json

{"meta": {"uuid": "string"
},
"id": "string"
}

Entity Language Profiles: List

Retrieve Language Profiles for an Entity

If the v parameter is before 20190103: by default, returned alternate Language Profiles include googleAttributes and categoryIds fields
If the v parameter is 20190103 or later: by default, returned alternate Language Profiles do not include googleAttributes and categoryIds fields. However, these fields can still be retrieved if the rendered parameter in the request is set to true.
If the v parameter is 20240221 or later: returned alternate Language Profiles replace the categoryIds field with the categories field.

path Parameters

accountId required	string >= 0 characters
entityId required	string >= 0 characters The external ID of the requested Entity

query Parameters

v required	string >= 0 characters A date in `YYYYMMDD` format.
convertMarkdownToHTML	string >= 0 characters Optional parameter to return fields of type Markdown as HTML. `false`: Markdown fields will be returned as JSON `true`: Markdown fields will be returned as HTML
convertRichTextToHTML	string >= 0 characters Optional parameter to return fields of type Rich Text as HTML. `false`: Rich Text fields will be returned as JSON `true`: Rich Text fields will be returned as HTML
entityTypes	string >= 0 characters Comma-separated list of Entity types to filter on. Example: `"location,event"` Should be from the following types: `atm` `event` `faq` `financialProfessional` `healthcareFacility` `healthcareProfessional` `hotel` `hotelRoomType` `job` `location` `organization` `product` `restaurant` OR the API name of a custom entity type.
fields	string >= 0 characters Comma-separated list of field names. When present, only the fields listed will be returned. You can use dot notation to specify substructures (e.g., `"address.line1"`). Custom fields are specified in the same way, albeit with their `c_*` name.
format	string >= 0 characters Default: "markdown" Present if and only if at least one field is of type "Legacy Rich Text." Valid values: `markdown` `html` `none`
languageCodes	string >= 0 characters The comma-separated language codes corresponding to the languages of the profile that the user wishes to retrieve
rendered	string >= 0 characters Default: "false" `false`: The response will only contain overridable or language-specific fields for the requested language. `true`: The response will contain the full location profile in the requested language, including data that remains the same across languages.

Responses

Response samples

Content type

application/json

{"meta": {"uuid": "string"
},
"response": {"profiles": [{"meta": {"accountId": "string",
"countryCode": "string",
"createdTimestamp": "string",
"entityType": "string",
"folderId": "string",
"id": "string",
"labels": ["string"
],
"language": "string",
"timestamp": "string",
"uid": "string"
},
"name": "string",
"address": {"city": "string",
"countryCode": "string",
"extraDescription": "string",
"line1": "string",
"line2": "string",
"postalCode": "string",
"region": "string",
"sublocality": "string"
},
"acceptingNewPatients": true,
"acceptsReservations": true,
"accessHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"additionalHoursText": "string",
"additionalPromotingLocations": ["string"
],
"addressHidden": true,
"admittingHospitals": ["string"
],
"adultPool": "YES",
"ageRange": {"maxValue": 0,
"minValue": 0
},
"airportShuttle": "AIRPORT_SHUTTLE_AVAILABLE",
"airportTransfer": "YES",
"allInclusive": "ALL_INCLUSIVE_RATES_AVAILABLE",
"alternateNames": ["string"
],
"alternatePhone": "string",
"alternateWebsites": ["http://example.com"
],
"androidAppUrl": "string",
"answer": "string",
"appleActionLinks": [{"appName": "string",
"appStoreUrl": "http://example.com",
"category": "BOOK_TRAVEL",
"quickLinkUrl": "http://example.com"
}
],
"appleBusinessDescription": "string",
"appleBusinessId": "string",
"appleCompanyId": "string",
"appleCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"applicationUrl": "http://example.com",
"associations": ["string"
],
"attendance": {"attendanceMode": "OFFLINE",
"virtualLocationUrl": "http://example.com"
},
"attire": "UNSPECIFIED",
"babysittingOffered": "YES",
"baggageStorage": "YES",
"bar": "YES",
"beachAccess": "YES",
"beachFrontProperty": "YES",
"bicycles": "BICYCLE_RENTALS",
"bios": {"ids": ["string"
],
"label": "string"
},
"boutiqueStores": "YES",
"brands": ["string"
],
"breakfast": "BREAKFAST_AVAILABLE",
"brunchHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"businessCenter": "YES",
"calendars": {"ids": ["string"
],
"label": "string"
},
"carRental": "YES",
"casino": "YES",
"categories": { },
"categoryIds": ["string"
],
"catsAllowed": "YES",
"certifications": ["string"
],
"checkInTime": "14:15:22Z",
"checkOutTime": "14:15:22Z",
"classificationRating": "string",
"closed": true,
"concierge": "YES",
"conditionsTreated": ["string"
],
"convenienceStore": "YES",
"covidMessaging": "string",
"covidTestAppointmentUrl": "http://example.com",
"covidTestingAppointmentRequired": true,
"covidTestingDriveThroughSite": true,
"covidTestingIsFree": true,
"covidTestingPatientRestrictions": true,
"covidTestingReferralRequired": true,
"covidTestingSiteInstructions": "string",
"covidVaccineAppointmentRequired": true,
"covidVaccineDriveThroughSite": true,
"covidVaccineInformationUrl": "http://example.com",
"covidVaccinePatientRestrictions": true,
"covidVaccineReferralRequired": true,
"covidVaccineSiteInstructions": "string",
"covidVaccinesOffered": ["PFIZER"
],
"currencyExchange": "YES",
"customKeywords": ["string"
],
"datePosted": "2019-08-24",
"degrees": ["ANP"
],
"deliveryHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"description": "stringstri",
"displayCoordinate": {"latitude": -90,
"longitude": -180
},
"doctorOnCall": "YES",
"dogsAllowed": "YES",
"driveThroughHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"dropoffCoordinate": {"latitude": -90,
"longitude": -180
},
"educationList": [{"institutionName": "string",
"type": "FELLOWSHIP",
"yearCompleted": 1900
}
],
"electricChargingStation": "YES",
"elevator": "YES",
"ellipticalMachine": "YES",
"emails": ["user@example.com"
],
"employmentType": "FULL_TIME",
"eventStatus": "SCHEDULED",
"facebookAbout": "string",
"facebookCallToAction": {"type": "NONE",
"value": "string"
},
"facebookCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"facebookDescriptor": "string",
"facebookName": "string",
"facebookOverrideCity": "string",
"facebookPageUrl": "string",
"facebookParentPageId": "string",
"facebookProfilePhoto": {"alternateText": "string",
"url": "http://example.com"
},
"facebookStoreId": "string",
"facebookVanityUrl": "string",
"facebookWebsiteOverride": "http://example.com",
"fax": "string",
"featuredMessage": {"description": "string",
"url": "http://example.com"
},
"firstName": "string",
"firstPartyReviewPage": "string",
"fitnessCenter": "FITNESS_CENTER_AVAILABLE",
"floorCount": 0,
"freeWeights": "YES",
"frequentlyAskedQuestions": [{"answer": "string",
"question": "string"
}
],
"frontDesk": "FRONT_DESK_AVAILABLE",
"fullyVaccinatedStaff": true,
"gameRoom": "YES",
"gender": "UNSPECIFIED",
"geomodifier": "string",
"giftShop": "YES",
"golf": "YES",
"googleAttributes": { },
"googleCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"googleMyBusinessLabels": ["string"
],
"googlePlaceId": "string",
"googleProfilePhoto": {"alternateText": "string",
"url": "http://example.com"
},
"googleWebsiteOverride": "http://example.com",
"happyHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"headshot": {"alternateText": "string",
"url": "http://example.com"
},
"hiringOrganization": "string",
"holidayHoursConversationEnabled": true,
"horsebackRiding": "YES",
"hotTub": "YES",
"hours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"housekeeping": "HOUSEKEEPING_AVAILABLE",
"impressum": "string",
"indoorPoolCount": 0,
"instagramHandle": "string",
"insuranceAccepted": ["string"
],
"iosAppUrl": "string",
"isClusterPrimary": true,
"isFreeEvent": true,
"isoRegionCode": "string",
"keywords": ["string"
],
"kidFriendly": "YES",
"kidsClub": "YES",
"kidsStayFree": "YES",
"kitchenHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"labels": ["string"
],
"landingPageUrl": "http://example.com",
"languages": ["string"
],
"lastName": "string",
"laundry": "FULL_SERVICE",
"lazyRiver": "YES",
"lifeguard": "YES",
"linkedInUrl": "http://example.com",
"linkedLocation": "string",
"localPhone": "string",
"localShuttle": "YES",
"locatedIn": "string",
"location": {"existingLocation": "string",
"externalLocation": "string"
},
"locationType": "LOCATION",
"logo": {"clickthroughUrl": "http://example.com",
"description": "string",
"details": "string",
"image": {"alternateText": "string",
"url": "http://example.com"
}
},
"mainPhone": "string",
"massage": "YES",
"maxAgeOfKidsStayFree": 0,
"maxNumberOfKidsStayFree": 0,
"mealsServed": ["BREAKFAST"
],
"meetingRoomCount": 0,
"menuUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"menus": {"ids": ["string"
],
"label": "string"
},
"middleName": "string",
"mobilePhone": "string",
"mobilityAccessible": "YES",
"nightclub": "YES",
"npi": "string",
"nudgeEnabled": true,
"officeName": "string",
"onlineServiceHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"operatingCountries": ["AD"
],
"orderUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"organizerEmail": "user@example.com",
"organizerName": "string",
"organizerPhone": "string",
"outdoorPoolCount": 0,
"parking": "PARKING_AVAILABLE",
"paymentOptions": ["AFTERPAY"
],
"performers": ["string"
],
"petsAllowed": "PETS_WELCOME",
"photoGallery": [{"clickthroughUrl": "http://example.com",
"description": "string",
"details": "string",
"image": {"alternateText": "string",
"url": "http://example.com"
}
}
],
"pickupCoordinate": {"latitude": -90,
"longitude": -180
},
"pickupHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"pinterestUrl": "http://example.com",
"priceRange": "UNSPECIFIED",
"primaryConversationContact": "string",
"privateBeach": "YES",
"privateCarService": "PRIVATE_CAR_SERVICE",
"productLists": {"ids": ["string"
],
"label": "string"
},
"products": ["string"
],
"questionsAndAnswers": true,
"rankTrackingCompetitors": [{"name": "string",
"website": "http://example.com"
}
],
"rankTrackingEnabled": true,
"rankTrackingFrequency": "WEEKLY",
"rankTrackingQueryTemplates": ["KEYWORD"
],
"rankTrackingSites": ["GOOGLE_DESKTOP"
],
"reservationUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"restaurantCount": 0,
"reviewGenerationUrl": "string",
"reviewResponseConversationEnabled": true,
"roomCount": 0,
"roomService": "ROOM_SERVICE_AVAILABLE",
"routableCoordinate": {"latitude": -90,
"longitude": -180
},
"salon": "YES",
"sauna": "YES",
"scuba": "YES",
"selfParking": "SELF_PARKING_AVAILABLE",
"seniorHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"serviceArea": {"places": ["string"
]
},
"serviceAreaPlaces": [{"name": "string",
"googlePlaceId": "string",
"type": "POSTAL_CODE"
}
],
"services": ["string"
],
"smokeFreeProperty": "YES",
"snorkeling": "YES",
"socialHour": "YES",
"spa": "YES",
"specialities": ["string"
],
"tableService": "YES",
"takeoutHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"tennis": "YES",
"thermalPool": "YES",
"ticketAvailability": "IN_STOCK",
"ticketPriceRange": {"currencyCode": "string",
"maxValue": "string",
"minValue": "string"
},
"ticketSaleDateTime": "2019-08-24T14:15:22Z",
"ticketUrl": "http://example.com",
"tikTokUrl": "http://example.com",
"time": {"end": "2019-08-24T14:15:22Z",
"start": "2019-08-24T14:15:22Z"
},
"timeZoneUtcOffset": "string",
"timezone": "string",
"tollFreePhone": "string",
"treadmill": "YES",
"ttyPhone": "string",
"turndownService": "YES",
"twitterHandle": "string",
"uberLink": {"presentation": "BUTTON",
"text": "string"
},
"uberTripBranding": {"description": "string",
"text": "string",
"url": "http://example.com"
},
"valetParking": "VALET_PARKING_AVAILABLE",
"validThrough": "2019-08-24T14:15:22Z",
"vendingMachine": "YES",
"venueName": "string",
"videos": [{"description": "string",
"video": {"url": "http://example.com"
}
}
],
"wadingPool": "YES",
"wakeUpCalls": "YES",
"walkableCoordinate": {"latitude": -90,
"longitude": -180
},
"waterPark": "YES",
"waterSkiing": "YES",
"watercraft": "WATERCRAFT_RENTALS",
"waterslide": "YES",
"wavePool": "YES",
"websiteUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"weightMachine": "YES",
"wheelchairAccessible": "YES",
"wifiAvailable": "WIFI_AVAILABLE",
"workRemote": true,
"yearEstablished": 1000,
"yearLastRenovated": 1000,
"yextDisplayCoordinate": {"latitude": -90,
"longitude": -180
},
"yextDropoffCoordinate": {"latitude": -90,
"longitude": -180
},
"yextPickupCoordinate": {"latitude": -90,
"longitude": -180
},
"yextRoutableCoordinate": {"latitude": -90,
"longitude": -180
},
"yextWalkableCoordinate": {"latitude": -90,
"longitude": -180
},
"youTubeChannelUrl": "http://example.com"
}
]
}
}

Entity Language Profiles: List All

Retrieve a list of Language Profiles for Entities within an account

NOTE:

If the v parameter is before 20190103: by default, returned alternate Language Profiles include googleAttributes and categoryIds fields
If the v parameter is 20190103 or later: by default, returned alternate Language Profiles do not include googleAttributes and categoryIds fields. However, these fields can still be retrieved if the rendered parameter in the request is set to true.
If the v parameter is 20240221 or later: returned alternate Language Profiles replace the categoryIds field with the categories field.

path Parameters

accountId

required

string >= 0 characters

query Parameters

required

string >= 0 characters

A date in YYYYMMDD format.

convertMarkdownToHTML

string >= 0 characters

Optional parameter to return fields of type Markdown as HTML.

false: Markdown fields will be returned as JSON
true: Markdown fields will be returned as HTML

convertRichTextToHTML

string >= 0 characters

Optional parameter to return fields of type Rich Text as HTML.

false: Rich Text fields will be returned as JSON
true: Rich Text fields will be returned as HTML

entityTypes

string >= 0 characters

Comma-separated list of Entity types to filter on. Example: "location,event"

Should be from the following types:

atm
event
faq
financialProfessional
healthcareFacility
healthcareProfessional
hotel
hotelRoomType
job
location
organization
product
restaurant

OR the API name of a custom entity type.

fields

string >= 0 characters

filter

string >= 0 characters

For example, if the filter JSON is {"name":{"$eq":"John"}}, then the filter param after URL-encoding will be: filter=%7B%22name%22%3A%7B%22%24eq%22%3A%22John%22%7D%7D

Basic Filter Structure

The filter object at its core consists of a matcher, a field, and an argument.

For example, in the following filter JSON:

{
"name":{
"$eq":"John"
}
}

$eq is the matcher, or filtering operation (equals, in this example),

name is the field being filtered by, and

John is value to be matched against.

Combining Multiple Filters

Multiple filters can be combined into one object using combinators. For example, the following filter JSON combines multiple filters using the combinator $and. $or is also supported.

{
"$and":[
{
"firstName":{
"$eq":"John"
}
},
{
"countryCode":{
"$in":[
"US",
"GB"
]
}
}
]
}

Filter Negation

Certain filter types may be negated. For example:

{
"$not": {
"name": {
"$eq": "John"
}
}
}

This can also be written more simply with a ! in the $eq parameter. The following filter would have the same effect:

{
"name":{
"!$eq":"John"
}
}

Filter Complement

{
"$complement":{
"description":{
"$contains":"hello"
}
}
}

Addressing Subfields

Subfields of fields can be addressed using the "dot" notation while filtering. For example, if you have a custom field called c_myCustomField:

{
"c_myCustomField":{
"age": 30,
"name": "Jim",
}
}

While filtering, subfields may be addressed using the "dot" notation.

{
"c_myCustomField.name":{
"!$eq":"John"
}
}

Field Support

TEXT

The TEXT filter type is supported for text fields. (e.g., name, countryCode)

Matcher	Details
$eq (equals)	`{ "countryCode":{ "$eq":"US" } }, { "countryCode":{ "!$eq":"US" } }` Supports negation. Case insensitive.
$startsWith	Matches if the field starts with the argument value. e.g., "Amazing" starts with "amaz" `{ "address.line1":{ "$startsWith": "Jo" } }` Supports negation. Case insensitive.
$in	Matches if field value is a member of the argument list. `{ "firstName":{ "$in": ["John", "Jimmy"] } }` Does not support negation. Negation can be mimicked by using an "OR" matcher, for example: `{ "$and":[ { "firstName":{ "!$eq": "John" } }, { "firstName":{ "!$eq": "Jimmy" } } ] }`
$contains	`{ "c_myString":{ "$contains":"sample" } }` This filter will match if "sample" is contained in any string within `c_myString`. Note that this matching is "left-edge n-gram", meaning the argument string must be the beginning of a token. The string "sample" will match strings like "This a sample", "Sample one", and "Sample 2", but not strings like "thisisasamplewithoutspaces". Supports negation.
$containsAny	`{ "c_myString":{ "$containsAny":[ "sample1", "sample2" ] } }` This filter will match if either "sample1" or "sample2" is contained in any string within `c_myString`. The argument list can contain more than two strings. Note that this matching is "left-edge n-gram", meaning the argument string must be the beginning of a token. The string "sample" will match strings like "This a sample", "Sample one", and "Sample 2", but not strings like "thisisasamplewithoutspaces". Supports negation.
$containsAll	`{ "c_myString":{ "$containsAll":[ "sample1", "sample2" ] } }` This filter will match if both "sample1" and "sample2" are contained in any string within `c_myString`. The argument list can contain more than two strings. Note that this matching is "left-edge n-gram", meaning the argument string must be the beginning of a token. The string "sample" will match strings like "This a sample", "Sample one", and "Sample 2", but not strings like "thisisasamplewithoutspaces". Supports negation.

BOOLEAN

The BOOLEAN filter type is supported for boolean fields and Yes / No custom fields.

Matcher	Details
$eq	`{ "isFreeEvent": { "$eq": true } }` For booleans, the filter takes a boolean value, not a string. Supports negation.

STRUCT

The STRUCT filter type is supported for compound fields with subfields.

*e.g., address, featuredMessage, fields of custom types*

Matcher Details

$hasProperty

Matches if argument is a key (subfield) of field being filtered by. This filter type is useful for filtering by compound fields or to check if certain fields have a value set.

{
"address": {
"$hasProperty": "line1"
}
}

Supports negation.

OPTION

The OPTION filter type is supported for options custom fields and fields that have a predetermined list of valid values.

*e.g., eventStatus, gender, SINGLE_OPTION and MULTI_OPTION types of custom fields.*

Matcher Details

$eq

Matching is case insensitive and insensitive to consecutive whitespace.

e.g., "XYZ 123" matches "xyz 123"

{
"eventStatus": {
"$eq": "SCHEDULED"
}
}

Supports negation. Negating $eq on the list will match any field that does not hold any of the provided values.

$in

{
"eventStatus": {
"$in": [
"SCHEDULED",
"POSTPONED"
]
}
}

Does not support negation. However, negation can be mimicked by using an $and matcher to negate individually over the desired values. For example:

{
"$and": [
{
"eventStatus":{
"!$eq": "SCHEDULED"
}
},
{
"firstName":{
"!$eq": "POSTPONED"
}
}
]
}

PHONE

The PHONE filter type is supported for phone number fields only. PHONE will support the same matchers as TEXT, except that for $eq, the same phone number with or without calling code will match.

Matcher Details

$eq

{
"mainPhone":{
"$eq":"+18187076189"
}
},
{
"mainPhone":{
"$eq":"8187076189"
}
},
{
"mainPhone":{
"!$eq":"9177076189"
}
}

Supports negation. Case insensitive.

$startsWith

Matches if the field starts with the argument value.

e.g., "8187076189" starts with "818"

{
"mainPhone":{
"$startsWith": "818"
}
}

Supports negation. Case insensitive.

$in

Matches if field value is a member of the argument list.

{
"mainPhone":{
"$in": [
"8185551616",
"9171112211"
]
}
}

Does not support negation. However, negation can be mimicked by using an $and matcher to negate individually over the desired values.

INTEGER, FLOAT, DATE, DATETIME, and TIME

These filter types are strictly ordered -- therefore, they support the following matchers:

Equals
Less Than / Less Than or Equal To
Greater Than / Greater Than or Equal To

Matcher	Details
$eq	Equals `{ "ageRange.maxValue": { "$eq": "80" } }` Supports negation.
$lt	Less than `{ "time.start": { "$lt": "2018-08-28T05:56" } }`
$gt	Greater than `{ "ageRange.maxValue": { "$gt": "50" } }`
$le	Less than or equal to `{ "ageRange.maxValue": { "$le": "40" } }`
$ge	Greater than or equal to `{ "time.end": { "$ge": "2018-08-28T05:56" } }`
Combinations	While we do not support "between" in our filtering syntax, it is possible to combine multiple matchers for a result similar to an "and" operation: `{ "ageRange.maxValue : { "$gt" : 10, "$lt": 20 } }`

LIST OF TEXT

Any field that has a list of valid values and supports any of the previously mentioned filter types will also support the $contains matcher.

Matcher	Details
$eq	`{ "c_myStringList": { "$eq": "sample" } }` This filter will match if "sample" EXACTLY matches any string within `c_myStringList`. Supports negation.
$eqAny	`{ "c_myStringList": { "$eqAny": [ "sample1", "sample2" ] } }` This filter will match if any one of "sample1" or "sample2" EXACTLY match a string within `c_myStringList` . The argument can have more than two strings. Supports negation.
$eqAll	`{ "c_myStringList": { "$eqAll": [ "sample1", "sample2" ] } }` This filter will match if both "sample1" AND "sample2" EXACTLY match a string within `c_myStringList`. The argument can have more than two strings. Supports negation.
$contains	`{ "c_myStringList":{ "$contains":"sample" } }` This filter will match if "sample" is contained in any string within `c_myStringList`. Note that this matching is "left edge n-gram", meaning the argument string must be the beginning of a token. The string "sample" will match strings like "This is a sample", "Sample one", "Sample 2" but not strings like "thisisasamplewithoutspaces". Supports negation.
$containsAny	`{ "c_myStringList": { "$containsAny": [ "sample1", "sample2" ] } }` This filter will match if either "sample1" or "sample2" is contained in any string within `c_myStringList`. The argument list can have more than two strings. Note that similar to `$contains`, the matching for `$containsAny` is "left edge n-gram", meaning the argument string must be the beginning of a token. The string "sample" will match strings like "This is a sample", "Sample one", "Sample 2" but not strings like "thisisasamplewithoutspaces". Supports negation.
$containsAll	`{ "c_myStringList": { "$containsAll": [ "sample1", "sample2" ] } }` This filter will match if BOTH "sample1" and "sample2" are contained in strings within `c_myStringList`. The argument list can have more than two strings. Note that similar to `$contains`, the matching for `$containsAll` is "left-edge n-gram", meaning the argument string must be the beginning of a token. The string "sample" will match strings like "This a sample", "Sample one", and "Sample 2", but not strings like "thisisasamplewithoutspaces". Supports negation.
$startsWith	`{ "c_myStringList": { "$startsWith":"sample" } }` This filter will match if any string within `c_myStringList` starts with "sample". Does not supports negation. Case Insensitive.

LIST OF BOOLEAN, OPTION, PHONE, INTEGER, FLOAT, DATE, DATETIME, OR TIME

Matcher Details

$eq

{
"c_myDateList": {
"$eq": "2019-01-01"
}
}

This filter will match if "2019-01-01" EXACTLY matches any date within c_myDateList.

Supports negation.

$eqAny

{
"c_myIntegerList": {
"$eqAny": [1, 2]
}
}

This filter will match if 1 or 2 EXACTLY match any integer within c_myIntegerList. The argument list can have more than two elements.

Supports negation.

$eqAll

{
"c_myStringList": {
"$eqAll": [
"sample1",
"sample2"
]
}
}

This filter will match if both "2019-01-01" AND "2019-01-02" EXACTLY match a date within c_myDateList. The argument list can have more than two elements.

Supports negation.

LIST OF STRUCT

{
"c_myStructList.age":{
"$eq": 20
}
}

HOURS

Matcher	Details
$openAt	`{ "hours": { "$openAt": "2019-01-06T13:45" } }` This filter would match entities open at the specified time.
$closedAt	`{ "hours": { "$closedAt: "2019-01-06T13:45" } }`
$openForAllOf	`{ "hours": { "$openForAllOf": { "start": "2019-01-06T13:45", "end": "2019-01-06T15:00" } } }` This filter would match only those entities that are open for the entire range between 2019-01-06T13:45 and 2019-01-06T15:00. `{ "hours": { "$openForAllOf": "2019-05-10" } }` This filter would match entities open for the entire 24 hour period on 2019-05-10. You can also supply a year, a month, or an hour to filter for entities open for the entire year, month, or hour, respectively.
$openForAnyOf	`{ "hours": { "$openForAnyOf": { "start": "now", "end": "now+2h" } } }` This filter will match any entities that are open for at least a portion of the time range between now and two hours from now.
$closedForAllOf	`{ "hours": { "$closedForAllOf": { "start": "2019-01-06T13:45", "end": "2019-01-06T15:00" } } }` This filter will match only those entities that are closed for the entire given time range.
$closedForAnyOf	`{ "hours": { "$closedForAnyOf": { "start": "2019-01-06T13:45", "end": "2019-01-06T15:00" } } }` This filter will match any entities that are closed for at least a portion of the given time range.

Filtering by Dates and Times

Time zones

To search in local time, simply provide the date or time without any zone: 2019-06-07T15:30 or 2019-06-07.

To conduct a zoned search, provide the name of the time zone in brackets after the time, as it is shown in the tz database: 2019-06-07T15:30[America/New_York] or 2019-06-06[America/Phoenix].

Date and time types

In addition to searching with dates and datetimes, you can also query with years, months, and hours. For example, the filter:

{
"time.start": {
"$eq": "2018"
}
}

would match all start times in the year 2018. The same logic would apply for a month (2019-05), a date (2019-05-01), or an hour (2019-05-01T06).

These types also work with ordered searches. For example:

{
"time.start": {
"$lt": "2018"
}
}

would match start times before 2018 (i.e., anything in 2017 or before). On the other hand, the same query with a $le matcher would include anything in or before 2018.

"Now" and Date Math

Instead of providing a static date or time, you can also use now in place of any date time. When you do so, the system will calculate the time when the query is made and conduct a zoned search.

Filtering Across an Entity

It is possible to search for a specific text string across all fields of an entity by using the $anywhere matcher.

Matcher Details

$anywhere

Matches if the argument text appears anywhere in the entity (including subfields, structs, and lists)

{
"$anywhere": "hello"
}

This filter will match all entities that contain the string "hello" or strings that begin with "hello".

Examples

The following filter will match against entities that:

Are of type event (note that entity types can also be filtered by the entityTypes query parameter)
Have a name that starts with the text "Century"
Have a maximum age between 10 and 20
Have a minimum age between 5 and 7
Start after 7 PM (19:00) on August 28, 2018

{
"$and":[
{
"entityType":{
"$eq":"event"
}
},
{
"name":{
"$startsWith":"Century"
}
},
{
"ageRange.maxValue":{
"$gt":10,
"$lt":20
}
},
{
"ageRange.minValue":{
"$gt":5,
"$lt":7
}
},
{
"time.start":{
"$ge":"2018-08-28T19:00"
}
}
]
}

format

string >= 0 characters

Default: "markdown"

Present if and only if at least one field is of type "Legacy Rich Text."

Valid values:

markdown
html
none

languageCodes

string >= 0 characters

The comma-separated language codes corresponding to the languages of the profile that the user wishes to retrieve

limit

number multiple of 1 <= 50

Default: "10"

Number of results to return.

offset

number multiple of 1

Default: "0"

Number of results to skip. Used to page through results. Cannot be used together with pageToken.

For Live API requests, the offset cannot be higher than 9,950. For Knowledge API the maximum limit is only enforced if a filter and/or sortBy parameter are given.

pageToken

string >= 0 characters

If a response to a previous request contained the pageToken field, pass that field's value as the pageToken parameter to retrieve the next page of data.

rendered

string >= 0 characters

Default: "false"

false: The response will only contain overridable or language-specific fields for the requested language.
true: The response will contain the full location profile in the requested language, including data that remains the same across languages.

sortBy

string >= 0 characters

Responses

Response samples

Content type

application/json

{"meta": {"uuid": "string"
},
"response": {"count": 0,
"pageToken": "string",
"profileLists": [{"profiles": [{"meta": {"accountId": "string",
"countryCode": "string",
"createdTimestamp": "string",
"entityType": "string",
"folderId": "string",
"id": "string",
"labels": ["string"
],
"language": "string",
"timestamp": "string",
"uid": "string"
},
"name": "string",
"address": {"city": "string",
"countryCode": "string",
"extraDescription": "string",
"line1": "string",
"line2": "string",
"postalCode": "string",
"region": "string",
"sublocality": "string"
},
"acceptingNewPatients": true,
"acceptsReservations": true,
"accessHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{ }
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
}
},
"additionalHoursText": "string",
"additionalPromotingLocations": ["string"
],
"addressHidden": true,
"admittingHospitals": ["string"
],
"adultPool": "YES",
"ageRange": {"maxValue": 0,
"minValue": 0
},
"airportShuttle": "AIRPORT_SHUTTLE_AVAILABLE",
"airportTransfer": "YES",
"allInclusive": "ALL_INCLUSIVE_RATES_AVAILABLE",
"alternateNames": ["string"
],
"alternatePhone": "string",
"alternateWebsites": ["http://example.com"
],
"androidAppUrl": "string",
"answer": "string",
"appleActionLinks": [{"appName": "string",
"appStoreUrl": "http://example.com",
"category": "BOOK_TRAVEL",
"quickLinkUrl": "http://example.com"
}
],
"appleBusinessDescription": "string",
"appleBusinessId": "string",
"appleCompanyId": "string",
"appleCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"applicationUrl": "http://example.com",
"associations": ["string"
],
"attendance": {"attendanceMode": "OFFLINE",
"virtualLocationUrl": "http://example.com"
},
"attire": "UNSPECIFIED",
"babysittingOffered": "YES",
"baggageStorage": "YES",
"bar": "YES",
"beachAccess": "YES",
"beachFrontProperty": "YES",
"bicycles": "BICYCLE_RENTALS",
"bios": {"ids": ["string"
],
"label": "string"
},
"boutiqueStores": "YES",
"brands": ["string"
],
"breakfast": "BREAKFAST_AVAILABLE",
"brunchHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{ }
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
}
},
"businessCenter": "YES",
"calendars": {"ids": ["string"
],
"label": "string"
},
"carRental": "YES",
"casino": "YES",
"categories": { },
"categoryIds": ["string"
],
"catsAllowed": "YES",
"certifications": ["string"
],
"checkInTime": "14:15:22Z",
"checkOutTime": "14:15:22Z",
"classificationRating": "string",
"closed": true,
"concierge": "YES",
"conditionsTreated": ["string"
],
"convenienceStore": "YES",
"covidMessaging": "string",
"covidTestAppointmentUrl": "http://example.com",
"covidTestingAppointmentRequired": true,
"covidTestingDriveThroughSite": true,
"covidTestingIsFree": true,
"covidTestingPatientRestrictions": true,
"covidTestingReferralRequired": true,
"covidTestingSiteInstructions": "string",
"covidVaccineAppointmentRequired": true,
"covidVaccineDriveThroughSite": true,
"covidVaccineInformationUrl": "http://example.com",
"covidVaccinePatientRestrictions": true,
"covidVaccineReferralRequired": true,
"covidVaccineSiteInstructions": "string",
"covidVaccinesOffered": ["PFIZER"
],
"currencyExchange": "YES",
"customKeywords": ["string"
],
"datePosted": "2019-08-24",
"degrees": ["ANP"
],
"deliveryHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{ }
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
}
},
"description": "stringstri",
"displayCoordinate": {"latitude": -90,
"longitude": -180
},
"doctorOnCall": "YES",
"dogsAllowed": "YES",
"driveThroughHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{ }
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
}
},
"dropoffCoordinate": {"latitude": -90,
"longitude": -180
},
"educationList": [{"institutionName": "string",
"type": "FELLOWSHIP",
"yearCompleted": 1900
}
],
"electricChargingStation": "YES",
"elevator": "YES",
"ellipticalMachine": "YES",
"emails": ["user@example.com"
],
"employmentType": "FULL_TIME",
"eventStatus": "SCHEDULED",
"facebookAbout": "string",
"facebookCallToAction": {"type": "NONE",
"value": "string"
},
"facebookCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"facebookDescriptor": "string",
"facebookName": "string",
"facebookOverrideCity": "string",
"facebookPageUrl": "string",
"facebookParentPageId": "string",
"facebookProfilePhoto": {"alternateText": "string",
"url": "http://example.com"
},
"facebookStoreId": "string",
"facebookVanityUrl": "string",
"facebookWebsiteOverride": "http://example.com",
"fax": "string",
"featuredMessage": {"description": "string",
"url": "http://example.com"
},
"firstName": "string",
"firstPartyReviewPage": "string",
"fitnessCenter": "FITNESS_CENTER_AVAILABLE",
"floorCount": 0,
"freeWeights": "YES",
"frequentlyAskedQuestions": [{"answer": "string",
"question": "string"
}
],
"frontDesk": "FRONT_DESK_AVAILABLE",
"fullyVaccinatedStaff": true,
"gameRoom": "YES",
"gender": "UNSPECIFIED",
"geomodifier": "string",
"giftShop": "YES",
"golf": "YES",
"googleAttributes": { },
"googleCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"googleMyBusinessLabels": ["string"
],
"googlePlaceId": "string",
"googleProfilePhoto": {"alternateText": "string",
"url": "http://example.com"
},
"googleWebsiteOverride": "http://example.com",
"happyHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{ }
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
}
},
"headshot": {"alternateText": "string",
"url": "http://example.com"
},
"hiringOrganization": "string",
"holidayHoursConversationEnabled": true,
"horsebackRiding": "YES",
"hotTub": "YES",
"hours": {"friday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{ }
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
}
},
"housekeeping": "HOUSEKEEPING_AVAILABLE",
"impressum": "string",
"indoorPoolCount": 0,
"instagramHandle": "string",
"insuranceAccepted": ["string"
],
"iosAppUrl": "string",
"isClusterPrimary": true,
"isFreeEvent": true,
"isoRegionCode": "string",
"keywords": ["string"
],
"kidFriendly": "YES",
"kidsClub": "YES",
"kidsStayFree": "YES",
"kitchenHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{ }
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
}
},
"labels": ["string"
],
"landingPageUrl": "http://example.com",
"languages": ["string"
],
"lastName": "string",
"laundry": "FULL_SERVICE",
"lazyRiver": "YES",
"lifeguard": "YES",
"linkedInUrl": "http://example.com",
"linkedLocation": "string",
"localPhone": "string",
"localShuttle": "YES",
"locatedIn": "string",
"location": {"existingLocation": "string",
"externalLocation": "string"
},
"locationType": "LOCATION",
"logo": {"clickthroughUrl": "http://example.com",
"description": "string",
"details": "string",
"image": {"alternateText": "string",
"url": "http://example.com"
}
},
"mainPhone": "string",
"massage": "YES",
"maxAgeOfKidsStayFree": 0,
"maxNumberOfKidsStayFree": 0,
"mealsServed": ["BREAKFAST"
],
"meetingRoomCount": 0,
"menuUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"menus": {"ids": ["string"
],
"label": "string"
},
"middleName": "string",
"mobilePhone": "string",
"mobilityAccessible": "YES",
"nightclub": "YES",
"npi": "string",
"nudgeEnabled": true,
"officeName": "string",
"onlineServiceHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{ }
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
}
},
"operatingCountries": ["AD"
],
"orderUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"organizerEmail": "user@example.com",
"organizerName": "string",
"organizerPhone": "string",
"outdoorPoolCount": 0,
"parking": "PARKING_AVAILABLE",
"paymentOptions": ["AFTERPAY"
],
"performers": ["string"
],
"petsAllowed": "PETS_WELCOME",
"photoGallery": [{"clickthroughUrl": "http://example.com",
"description": "string",
"details": "string",
"image": {"alternateText": "string",
"url": "http://example.com"
}
}
],
"pickupCoordinate": {"latitude": -90,
"longitude": -180
},
"pickupHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{ }
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
}
},
"pinterestUrl": "http://example.com",
"priceRange": "UNSPECIFIED",
"primaryConversationContact": "string",
"privateBeach": "YES",
"privateCarService": "PRIVATE_CAR_SERVICE",
"productLists": {"ids": ["string"
],
"label": "string"
},
"products": ["string"
],
"questionsAndAnswers": true,
"rankTrackingCompetitors": [{"name": "string",
"website": "http://example.com"
}
],
"rankTrackingEnabled": true,
"rankTrackingFrequency": "WEEKLY",
"rankTrackingQueryTemplates": ["KEYWORD"
],
"rankTrackingSites": ["GOOGLE_DESKTOP"
],
"reservationUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"restaurantCount": 0,
"reviewGenerationUrl": "string",
"reviewResponseConversationEnabled": true,
"roomCount": 0,
"roomService": "ROOM_SERVICE_AVAILABLE",
"routableCoordinate": {"latitude": -90,
"longitude": -180
},
"salon": "YES",
"sauna": "YES",
"scuba": "YES",
"selfParking": "SELF_PARKING_AVAILABLE",
"seniorHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{ }
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
}
},
"serviceArea": {"places": ["string"
]
},
"serviceAreaPlaces": [{"name": "string",
"googlePlaceId": "string",
"type": "POSTAL_CODE"
}
],
"services": ["string"
],
"smokeFreeProperty": "YES",
"snorkeling": "YES",
"socialHour": "YES",
"spa": "YES",
"specialities": ["string"
],
"tableService": "YES",
"takeoutHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{ }
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": null,
"start": null
}
]
}
},
"tennis": "YES",
"thermalPool": "YES",
"ticketAvailability": "IN_STOCK",
"ticketPriceRange": {"currencyCode": "string",
"maxValue": "string",
"minValue": "string"
},
"ticketSaleDateTime": "2019-08-24T14:15:22Z",
"ticketUrl": "http://example.com",
"tikTokUrl": "http://example.com",
"time": {"end": "2019-08-24T14:15:22Z",
"start": "2019-08-24T14:15:22Z"
},
"timeZoneUtcOffset": "string",
"timezone": "string",
"tollFreePhone": "string",
"treadmill": "YES",
"ttyPhone": "string",
"turndownService": "YES",
"twitterHandle": "string",
"uberLink": {"presentation": "BUTTON",
"text": "string"
},
"uberTripBranding": {"description": "string",
"text": "string",
"url": "http://example.com"
},
"valetParking": "VALET_PARKING_AVAILABLE",
"validThrough": "2019-08-24T14:15:22Z",
"vendingMachine": "YES",
"venueName": "string",
"videos": [{"description": "string",
"video": {"url": "http://example.com"
}
}
],
"wadingPool": "YES",
"wakeUpCalls": "YES",
"walkableCoordinate": {"latitude": -90,
"longitude": -180
},
"waterPark": "YES",
"waterSkiing": "YES",
"watercraft": "WATERCRAFT_RENTALS",
"waterslide": "YES",
"wavePool": "YES",
"websiteUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"weightMachine": "YES",
"wheelchairAccessible": "YES",
"wifiAvailable": "WIFI_AVAILABLE",
"workRemote": true,
"yearEstablished": 1000,
"yearLastRenovated": 1000,
"yextDisplayCoordinate": {"latitude": -90,
"longitude": -180
},
"yextDropoffCoordinate": {"latitude": -90,
"longitude": -180
},
"yextPickupCoordinate": {"latitude": -90,
"longitude": -180
},
"yextRoutableCoordinate": {"latitude": -90,
"longitude": -180
},
"yextWalkableCoordinate": {"latitude": -90,
"longitude": -180
},
"youTubeChannelUrl": "http://example.com"
}
]
}
]
}
}

Entity Language Profiles: Get

Retrieve a Language Profile for an Entity

NOTE:

If the v parameter is before 20190103: by default, returned alternate Language Profiles include googleAttributes and categoryIds fields
If the v parameter is 20190103 or later: by default, returned alternate Language Profiles do not include googleAttributes and categoryIds fields. However, these fields can still be retrieved if the rendered parameter in the request is set to true.
If the v parameter is 20240221 or later: returned alternate Language Profiles replace the categoryIds field with the categories field.

path Parameters

accountId required	string >= 0 characters
entityId required	string >= 0 characters The external ID of the requested Entity
languageCode required	string >= 0 characters The language code corresponding to the language of the profiles that the user wishes to retrieve

query Parameters

v required	string >= 0 characters A date in `YYYYMMDD` format.
convertMarkdownToHTML	string >= 0 characters Optional parameter to return fields of type Markdown as HTML. `false`: Markdown fields will be returned as JSON `true`: Markdown fields will be returned as HTML
convertRichTextToHTML	string >= 0 characters Optional parameter to return fields of type Rich Text as HTML. `false`: Rich Text fields will be returned as JSON `true`: Rich Text fields will be returned as HTML
fields	string >= 0 characters Comma-separated list of field names. When present, only the fields listed will be returned. You can use dot notation to specify substructures (e.g., `"address.line1"`). Custom fields are specified in the same way, albeit with their `c_*` name.
format	string >= 0 characters Default: "markdown" Present if and only if at least one field is of type "Legacy Rich Text." Valid values: `markdown` `html` `none`
rendered	boolean Default: "false" `false`: The response will only contain overridable or language-specific fields for the requested language. `true`: The response will contain the full location profile in the requested language, including data that remains the same across languages.

Responses

Response samples

Content type

application/json

{"meta": {"uuid": "string"
},
"response": {"meta": {"accountId": "string",
"countryCode": "string",
"createdTimestamp": "string",
"entityType": "string",
"folderId": "string",
"id": "string",
"labels": ["string"
],
"language": "string",
"timestamp": "string",
"uid": "string"
},
"name": "string",
"address": {"city": "string",
"countryCode": "string",
"extraDescription": "string",
"line1": "string",
"line2": "string",
"postalCode": "string",
"region": "string",
"sublocality": "string"
},
"acceptingNewPatients": true,
"acceptsReservations": true,
"accessHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"additionalHoursText": "string",
"additionalPromotingLocations": ["string"
],
"addressHidden": true,
"admittingHospitals": ["string"
],
"adultPool": "YES",
"ageRange": {"maxValue": 0,
"minValue": 0
},
"airportShuttle": "AIRPORT_SHUTTLE_AVAILABLE",
"airportTransfer": "YES",
"allInclusive": "ALL_INCLUSIVE_RATES_AVAILABLE",
"alternateNames": ["string"
],
"alternatePhone": "string",
"alternateWebsites": ["http://example.com"
],
"androidAppUrl": "string",
"answer": "string",
"appleActionLinks": [{"appName": "string",
"appStoreUrl": "http://example.com",
"category": "BOOK_TRAVEL",
"quickLinkUrl": "http://example.com"
}
],
"appleBusinessDescription": "string",
"appleBusinessId": "string",
"appleCompanyId": "string",
"appleCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"applicationUrl": "http://example.com",
"associations": ["string"
],
"attendance": {"attendanceMode": "OFFLINE",
"virtualLocationUrl": "http://example.com"
},
"attire": "UNSPECIFIED",
"babysittingOffered": "YES",
"baggageStorage": "YES",
"bar": "YES",
"beachAccess": "YES",
"beachFrontProperty": "YES",
"bicycles": "BICYCLE_RENTALS",
"bios": {"ids": ["string"
],
"label": "string"
},
"boutiqueStores": "YES",
"brands": ["string"
],
"breakfast": "BREAKFAST_AVAILABLE",
"brunchHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"businessCenter": "YES",
"calendars": {"ids": ["string"
],
"label": "string"
},
"carRental": "YES",
"casino": "YES",
"categories": { },
"categoryIds": ["string"
],
"catsAllowed": "YES",
"certifications": ["string"
],
"checkInTime": "14:15:22Z",
"checkOutTime": "14:15:22Z",
"classificationRating": "string",
"closed": true,
"concierge": "YES",
"conditionsTreated": ["string"
],
"convenienceStore": "YES",
"covidMessaging": "string",
"covidTestAppointmentUrl": "http://example.com",
"covidTestingAppointmentRequired": true,
"covidTestingDriveThroughSite": true,
"covidTestingIsFree": true,
"covidTestingPatientRestrictions": true,
"covidTestingReferralRequired": true,
"covidTestingSiteInstructions": "string",
"covidVaccineAppointmentRequired": true,
"covidVaccineDriveThroughSite": true,
"covidVaccineInformationUrl": "http://example.com",
"covidVaccinePatientRestrictions": true,
"covidVaccineReferralRequired": true,
"covidVaccineSiteInstructions": "string",
"covidVaccinesOffered": ["PFIZER"
],
"currencyExchange": "YES",
"customKeywords": ["string"
],
"datePosted": "2019-08-24",
"degrees": ["ANP"
],
"deliveryHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"description": "stringstri",
"displayCoordinate": {"latitude": -90,
"longitude": -180
},
"doctorOnCall": "YES",
"dogsAllowed": "YES",
"driveThroughHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"dropoffCoordinate": {"latitude": -90,
"longitude": -180
},
"educationList": [{"institutionName": "string",
"type": "FELLOWSHIP",
"yearCompleted": 1900
}
],
"electricChargingStation": "YES",
"elevator": "YES",
"ellipticalMachine": "YES",
"emails": ["user@example.com"
],
"employmentType": "FULL_TIME",
"eventStatus": "SCHEDULED",
"facebookAbout": "string",
"facebookCallToAction": {"type": "NONE",
"value": "string"
},
"facebookCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"facebookDescriptor": "string",
"facebookName": "string",
"facebookOverrideCity": "string",
"facebookPageUrl": "string",
"facebookParentPageId": "string",
"facebookProfilePhoto": {"alternateText": "string",
"url": "http://example.com"
},
"facebookStoreId": "string",
"facebookVanityUrl": "string",
"facebookWebsiteOverride": "http://example.com",
"fax": "string",
"featuredMessage": {"description": "string",
"url": "http://example.com"
},
"firstName": "string",
"firstPartyReviewPage": "string",
"fitnessCenter": "FITNESS_CENTER_AVAILABLE",
"floorCount": 0,
"freeWeights": "YES",
"frequentlyAskedQuestions": [{"answer": "string",
"question": "string"
}
],
"frontDesk": "FRONT_DESK_AVAILABLE",
"fullyVaccinatedStaff": true,
"gameRoom": "YES",
"gender": "UNSPECIFIED",
"geomodifier": "string",
"giftShop": "YES",
"golf": "YES",
"googleAttributes": { },
"googleCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"googleMyBusinessLabels": ["string"
],
"googlePlaceId": "string",
"googleProfilePhoto": {"alternateText": "string",
"url": "http://example.com"
},
"googleWebsiteOverride": "http://example.com",
"happyHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"headshot": {"alternateText": "string",
"url": "http://example.com"
},
"hiringOrganization": "string",
"holidayHoursConversationEnabled": true,
"horsebackRiding": "YES",
"hotTub": "YES",
"hours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"housekeeping": "HOUSEKEEPING_AVAILABLE",
"impressum": "string",
"indoorPoolCount": 0,
"instagramHandle": "string",
"insuranceAccepted": ["string"
],
"iosAppUrl": "string",
"isClusterPrimary": true,
"isFreeEvent": true,
"isoRegionCode": "string",
"keywords": ["string"
],
"kidFriendly": "YES",
"kidsClub": "YES",
"kidsStayFree": "YES",
"kitchenHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"labels": ["string"
],
"landingPageUrl": "http://example.com",
"languages": ["string"
],
"lastName": "string",
"laundry": "FULL_SERVICE",
"lazyRiver": "YES",
"lifeguard": "YES",
"linkedInUrl": "http://example.com",
"linkedLocation": "string",
"localPhone": "string",
"localShuttle": "YES",
"locatedIn": "string",
"location": {"existingLocation": "string",
"externalLocation": "string"
},
"locationType": "LOCATION",
"logo": {"clickthroughUrl": "http://example.com",
"description": "string",
"details": "string",
"image": {"alternateText": "string",
"url": "http://example.com"
}
},
"mainPhone": "string",
"massage": "YES",
"maxAgeOfKidsStayFree": 0,
"maxNumberOfKidsStayFree": 0,
"mealsServed": ["BREAKFAST"
],
"meetingRoomCount": 0,
"menuUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"menus": {"ids": ["string"
],
"label": "string"
},
"middleName": "string",
"mobilePhone": "string",
"mobilityAccessible": "YES",
"nightclub": "YES",
"npi": "string",
"nudgeEnabled": true,
"officeName": "string",
"onlineServiceHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"operatingCountries": ["AD"
],
"orderUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"organizerEmail": "user@example.com",
"organizerName": "string",
"organizerPhone": "string",
"outdoorPoolCount": 0,
"parking": "PARKING_AVAILABLE",
"paymentOptions": ["AFTERPAY"
],
"performers": ["string"
],
"petsAllowed": "PETS_WELCOME",
"photoGallery": [{"clickthroughUrl": "http://example.com",
"description": "string",
"details": "string",
"image": {"alternateText": "string",
"url": "http://example.com"
}
}
],
"pickupCoordinate": {"latitude": -90,
"longitude": -180
},
"pickupHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"pinterestUrl": "http://example.com",
"priceRange": "UNSPECIFIED",
"primaryConversationContact": "string",
"privateBeach": "YES",
"privateCarService": "PRIVATE_CAR_SERVICE",
"productLists": {"ids": ["string"
],
"label": "string"
},
"products": ["string"
],
"questionsAndAnswers": true,
"rankTrackingCompetitors": [{"name": "string",
"website": "http://example.com"
}
],
"rankTrackingEnabled": true,
"rankTrackingFrequency": "WEEKLY",
"rankTrackingQueryTemplates": ["KEYWORD"
],
"rankTrackingSites": ["GOOGLE_DESKTOP"
],
"reservationUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"restaurantCount": 0,
"reviewGenerationUrl": "string",
"reviewResponseConversationEnabled": true,
"roomCount": 0,
"roomService": "ROOM_SERVICE_AVAILABLE",
"routableCoordinate": {"latitude": -90,
"longitude": -180
},
"salon": "YES",
"sauna": "YES",
"scuba": "YES",
"selfParking": "SELF_PARKING_AVAILABLE",
"seniorHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"serviceArea": {"places": ["string"
]
},
"serviceAreaPlaces": [{"name": "string",
"googlePlaceId": "string",
"type": "POSTAL_CODE"
}
],
"services": ["string"
],
"smokeFreeProperty": "YES",
"snorkeling": "YES",
"socialHour": "YES",
"spa": "YES",
"specialities": ["string"
],
"tableService": "YES",
"takeoutHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"tennis": "YES",
"thermalPool": "YES",
"ticketAvailability": "IN_STOCK",
"ticketPriceRange": {"currencyCode": "string",
"maxValue": "string",
"minValue": "string"
},
"ticketSaleDateTime": "2019-08-24T14:15:22Z",
"ticketUrl": "http://example.com",
"tikTokUrl": "http://example.com",
"time": {"end": "2019-08-24T14:15:22Z",
"start": "2019-08-24T14:15:22Z"
},
"timeZoneUtcOffset": "string",
"timezone": "string",
"tollFreePhone": "string",
"treadmill": "YES",
"ttyPhone": "string",
"turndownService": "YES",
"twitterHandle": "string",
"uberLink": {"presentation": "BUTTON",
"text": "string"
},
"uberTripBranding": {"description": "string",
"text": "string",
"url": "http://example.com"
},
"valetParking": "VALET_PARKING_AVAILABLE",
"validThrough": "2019-08-24T14:15:22Z",
"vendingMachine": "YES",
"venueName": "string",
"videos": [{"description": "string",
"video": {"url": "http://example.com"
}
}
],
"wadingPool": "YES",
"wakeUpCalls": "YES",
"walkableCoordinate": {"latitude": -90,
"longitude": -180
},
"waterPark": "YES",
"waterSkiing": "YES",
"watercraft": "WATERCRAFT_RENTALS",
"waterslide": "YES",
"wavePool": "YES",
"websiteUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"weightMachine": "YES",
"wheelchairAccessible": "YES",
"wifiAvailable": "WIFI_AVAILABLE",
"workRemote": true,
"yearEstablished": 1000,
"yearLastRenovated": 1000,
"yextDisplayCoordinate": {"latitude": -90,
"longitude": -180
},
"yextDropoffCoordinate": {"latitude": -90,
"longitude": -180
},
"yextPickupCoordinate": {"latitude": -90,
"longitude": -180
},
"yextRoutableCoordinate": {"latitude": -90,
"longitude": -180
},
"yextWalkableCoordinate": {"latitude": -90,
"longitude": -180
},
"youTubeChannelUrl": "http://example.com"
}
}

Entity Language Profiles: Upsert

Add a language profile

NOTE

If the v parameter is 20240221 or later: returned Language Profile replaces the categoryIds field with the categories field.

path Parameters

accountId required	string >= 0 characters
entityId required	string >= 0 characters The external ID of the requested Entity
languageCode required	string >= 0 characters The language code corresponding to the language of the profile that the user wishes to create or update

query Parameters

required

string >= 0 characters

A date in YYYYMMDD format.

header Parameters

Update-Operation-Id

string >= 0 characters

The ID of the operation. Leave this blank to create a new operation or supply an ID to continue an existing operation

Request Body schema: application/json

The entity profile to create

EntityType	string This is used only to filter the fields below and should NOT be included in any API calls. If create, specify the entity type in the query parameter. If update, specify the entity type in the request body in the `meta` object. atm
	object Contains the metadata about the entity.
name	string [ 0 .. 5000 ] characters Cannot Include: HTML markup
	object Contains the address of the entity (or where the entity is located) Must be a valid address Cannot be a P.O. Box If the entity is an `event`, either an `address` value or a `linkedLocation` value can be provided.
	object Contains the daily access hours, holiday access hours, and reopen date for the Entity. Each day is represented by a sub-field of `accessHours`. (e.g. `monday`, `tuesday`, etc.) Open times can be specified per day through the `openIntervals` field and the `isClosed` flag. Similarly, holiday access hours are represented by the `holidayHours` sub-field. Setting the `reopenDate` sub-field indicates that the business is temporarily closed and will reopen on the specified date. SPECIAL CASES: To indicate that an Entity is open 24 hours on a specific day, set start to 00:00 and end to 23:59 in `openIntervals` for that day. To indicate that an Entity has split hours on a specific day (e.g., open from 9:00 AM to 12:00 PM and again from 1:00 PM to 5:00 PM), supply two or more `openIntervals` values with non-overlapping sets of hours. If you are providing `openIntervals`, you may not set `isClosed` to true for that day.
additionalHoursText	string [ 0 .. 255 ] characters Additional information about hours that does not fit in `hours` (e.g., `"Closed during the winter"`)
alternateNames	Array of strings unique [ items [ 0 .. 100 ] characters ] Other names for your business that you would like us to use when tracking your search performance Array must be ordered. Array may have a maximum of 3 elements. Array item description: Cannot Include: HTML markup
alternatePhone	string >= 0 characters Must be a valid phone number. If the phone number's calling code is for a country other than the one given in the entity's `countryCode`, the phone number provided must contain the calling code (e.g., `+44` in `+442038083831`). Otherwise, the calling code is optional.
alternateWebsites	Array of strings <uri> unique [ items <uri > [ 0 .. 255 ] characters ] Other websites for your business that we should search for when tracking your search performance Array must be ordered. Array may have a maximum of 3 elements. Array item description: Cannot Include: common domain names, e.g., google.com, youtube.com, etc.
	Array of objects unique Use this field to add action links to your Apple Listings. The call to action category will be displayed on the action link button. The App Store URL should contain a valid link to the landing page of an App in the Apple App Store. The Quick Link URL is where a user is taken when an action link is clicked by a user. The App Name sub-field is not displayed on Apple Listings and is only used to distinguish the call-to-action type when utilizing action links in Apple posts. Array must be ordered.
appleBusinessDescription	string [ 0 .. 500 ] characters The business description to be sent to Apple
appleBusinessId	string >= 0 characters ^\d\.?\d$ The ID associated with an individual Business Folder in your Apple account
appleCompanyId	string >= 0 characters ^\d\.?\d$ The ID associated with your Apple account. Numerical values only
	object The cover photo for the entity''s Apple profile Image must be at least 1600 x 1040 pixels Image may be no more than 4864 x 3163 pixels Supported Aspect Ratios: 154 x 100 NOTE: Maximum image size is 5mb after normalization and padding (if applicable). As well, there is a 6 second download limit from the image host.
categories	object Yext Categories. (Supported for versions > 20240220) A map of category list external IDs (i.e. "yext") to a list of category IDs. IDs must be valid and selectable (i.e., cannot be parent categories). Partial updates are accepted, meaning sending only the "yext" property will have no effect on any category list except the "yext" category.
categoryIds	Array of strings[ items >= 0 characters ] Yext Category IDs. (Deprecated: For versions > 20240220) IDs must be valid and selectable (i.e., cannot be parent categories). NOTE: The list of category IDs that you send us must be comprehensive. For example, if you send us a list of IDs that does not include IDs that you sent in your last update, Yext considers the missing categories to be deleted, and we remove them from your listings.
closed	boolean Indicates whether the entity is closed
customKeywords	Array of strings unique [ items [ 0 .. 100 ] characters ] Additional keywords you would like us to use when tracking your search performance Array must be ordered. Array may have a maximum of 5 elements.
description	string [ 10 .. 15000 ] characters A description of the entity Cannot Include: HTML markup
	object Coordinates where the map pin for the entity should be displayed, as provided by you
	object Contains the daily drive-through hours, holiday drive-through hours, and reopen date for the Entity. Each day is represented by a sub-field of `driveThroughHours`. (e.g. `monday`, `tuesday`, etc.) Open times can be specified per day through the `openIntervals` field and the `isClosed` flag. Similarly, holiday drive-through hours are represented by the `holidayHours` sub-field. Setting the `reopenDate` sub-field indicates that the business is temporarily closed and will reopen on the specified date. SPECIAL CASES: To indicate that an Entity is open 24 hours on a specific day, set start to 00:00 and end to 23:59 in `openIntervals` for that day. To indicate that an Entity has split hours on a specific day (e.g., open from 9:00 AM to 12:00 PM and again from 1:00 PM to 5:00 PM), supply two or more `openIntervals` values with non-overlapping sets of hours. If you are providing `openIntervals`, you may not set `isClosed` to true for that day.
	object Coordinates of the drop-off area for the entity, as provided by you
facebookAbout	string [ 0 .. 255 ] characters A description of the entity to be used in the "About You" section on Facebook
	object Designates the Facebook Call-to-Action button text and value Valid contents of `value` depends on the Call-to-Action's `type`: `NONE`: (optional) `BOOK_NOW`: URL `CALL_NOW`: Phone number `CONTACT_US`: URL `SEND_MESSAGE`: Any string `USE_APP`: URL `PLAY_GAME`: URL `SHOP_NOW`: URL `SIGN_UP`: URL `WATCH_VIDEO`: URL `SEND_EMAIL`: Email address `LEARN_MORE`: URL `PURCHASE_GIFT_CARDS`: URL `ORDER_NOW`: URL `FOLLOW_PAGE`: Any string
	object The cover photo for the entity's Facebook profile Displayed as a 851 x 315 pixel image You may need a cover photo in order for your listing to appear on Facebook. Please check your listings tab to learn more. Image must be at least 400 x 150 pixels Image area (width x height) may be no more than 41000000 pixels Image may be no more than 30000 x 30000 pixels Supported Aspect Ratios: 1 x 1 4 x 3 3 x 2 5 x 3 16 x 9 3 x 1 2 x 3 5 x 7 4 x 5 4 x 1 NOTE: Maximum image size is 5mb after normalization and padding (if applicable). As well, there is a 6 second download limit from the image host.
facebookDescriptor	string [ 3 .. 75 ] characters Location Descriptors are used for Enterprise businesses that sync Facebook listings using brand page location structure. The Location Descriptor is typically an additional geographic description (e.g. geomodifier) that will appear in parentheses after the name on the Facebook listing. Cannot Include: HTML markup
facebookName	string >= 0 characters The name for this entity's Facebook profile. A separate name may be specified to send only to Facebook in order to comply with any specific Facebook rules or naming conventions.
facebookOverrideCity	string >= 0 characters The city to be displayed on this entity's Facebook profile
facebookPageUrl	string >= 0 characters URL for the entity's Facebook Page. Valid formats: facebook.com/profile.php?id=[numId] facebook.com/group.php?gid=[numId] facebook.com/groups/[numId] facebook.com/[Name] facebook.com/pages/[Name]/[numId] facebook.com/people/[Name]/[numId] where [Name] is a String and [numId] is an Integer The success response will contain a warning message explaining why the URL wasn't stored in the system.
facebookParentPageId	string [ 0 .. 65 ] characters The Facebook Page ID of this entity's brand page if in a brand page location structure
	object The profile picture for the entity's Facebook profile You must have a profile picture in order for your listing to appear on Facebook. Image must be at least 180 x 180 pixels Image area (width x height) may be no more than 41000000 pixels Image may be no more than 30000 x 30000 pixels Supported Aspect Ratios: 1 x 1 4 x 3 3 x 2 5 x 3 16 x 9 3 x 1 2 x 3 5 x 7 4 x 5 4 x 1 NOTE: Maximum image size is 5mb after normalization and padding (if applicable). As well, there is a 6 second download limit from the image host.
facebookStoreId	string >= 0 characters The Store ID used for this entity in a brand page location structure
facebookVanityUrl	string [ 0 .. 50 ] characters The username that appear's in the Facebook listing URL to help customers find and remember a brand’s Facebook page. The username is also be used for tagging the Facebook page in other users’ posts, and searching for the Facebook page.
facebookWebsiteOverride	string <uri> >= 0 characters The URL you would like to submit to Facebook in place of the one given in `websiteUrl` (if applicable).
fax	string >= 0 characters Must be a valid fax number. If the fax number's calling code is for a country other than the one given in the entity's `countryCode`, the fax number provided must contain the calling code (e.g., `+44` in `+442038083831`). Otherwise, the calling code is optional.
	object Information about the entity's Featured Message
	Array of objects unique A list of questions that are frequently asked about this entity Array must be ordered. Array may have a maximum of 100 elements.
geomodifier	string >= 0 characters Provides additional information on where the entity can be found (e.g., `Times Square`, `Global Center Mall`)
googleAttributes	object The unique IDs of the entity's Google Business Profile keywords, as well as the unique IDs of any values selected for each keyword. Valid keywords (e.g., `has_drive_through`, `has_fitting_room`, `kitchen_in_room`) are determined by the entity's primary category. A full list of keywords can be retrieved with the Google Fields: List endpoint. Keyword values provide more details on how the keyword applies to the entity (e.g., if the keyword is `has_drive_through`, its values may be `true` or `false`). If the `v` parameter is before `20181204`: `googleAttributes` is formatted as a map of key-value pairs (e.g., `[{ "id": "has_wheelchair_accessible_entrance", "values": [ "true" ] }]`) If the `v` parameter is on or after `20181204`: the contents are formatted as a list of objects (e.g., `{ "has_wheelchair_accessible_entrance": [ "true" ]}`) NOTE: The latest Google Attributes are available via the Google Fields: List endpoint. Google Attributes are managed by Google and are subject to change without notice. To prevent errors, make sure your API implementation is not dependent on the presence of specific attributes.
	object The cover photo for the entity's Google profile Image must be at least 250 x 250 pixels
googleMyBusinessLabels	Array of strings unique [ items [ 0 .. 50 ] characters ] Google Business Profile Labels help users organize their locations into groups within GBP. Array must be ordered. Array may have a maximum of 10 elements. Array item description: Cannot Include: HTML markup
googlePlaceId	string >= 0 characters The unique identifier of this entity on Google Maps.
	object The profile photo for the entity's Google profile Image must be at least 250 x 250 pixels Image may be no more than 5000 x 5000 pixels Supported Aspect Ratios: 1 x 1 NOTE: Maximum image size is 5mb after normalization and padding (if applicable). As well, there is a 6 second download limit from the image host.
googleWebsiteOverride	string <uri> >= 0 characters The URL you would like to submit to Google Business Profile in place of the one given in `websiteUrl` (if applicable). For example, if you want to analyze the traffic driven by your Google listings separately from other traffic, enter the alternate URL that you will use for tracking in this field.
holidayHoursConversationEnabled	boolean Indicates whether holiday-hour confirmation alerts are enabled for the Yext Knowledge Assistant for this entity
	object Contains the daily hours, holiday hours, and reopen date for the Entity. Each day is represented by a sub-field of `hours`. (e.g. `monday`, `tuesday`, etc.) Open times can be specified per day through the `openIntervals` field and the `isClosed` flag. Similarly, holiday hours are represented by the `holidayHours` sub-field. Setting the `reopenDate` sub-field indicates that the business is temporarily closed and will reopen on the specified date. SPECIAL CASES: To indicate that an Entity is open 24 hours on a specific day, set start to 00:00 and end to 23:59 in `openIntervals` for that day. To indicate that an Entity has split hours on a specific day (e.g., open from 9:00 AM to 12:00 PM and again from 1:00 PM to 5:00 PM), supply two or more `openIntervals` values with non-overlapping sets of hours. If you are providing `openIntervals`, you may not set `isClosed` to true for that day.
impressum	string [ 0 .. 2000 ] characters A statement of the ownership and authorship of a document. Individuals or organizations based in many German-speaking countries are required by law to include an Impressum in published media.
isoRegionCode	string >= 0 characters The ISO 3166-2 region code for the entity Yext will determine the entity's code and update `isoRegionCode` with that value. If Yext is unable to determine the code for the entity, the entity'ss ISO 3166-1 alpha-2 country code will be used.
keywords	Array of strings unique [ items [ 0 .. 100 ] characters ] Keywords that describe the entity. All strings must be non-empty when trimmed of whitespace. Array must be ordered. Array may have a maximum of 100 elements. Array item description: Cannot Include: HTML markup
labels	Array of strings[ items >= 0 characters ] The IDs of the entity labels that have been added to this entity. Entity labels help you identify entities that share a certain characteristic; they do not appear on your entity's listings. NOTE: You can only add labels that have already been created via our web interface. Currently, it is not possible to create new labels via the API.
landingPageUrl	string <uri> >= 0 characters The URL of this entity's Landing Page that was created with Yext Pages
localPhone	string >= 0 characters Must be a valid, non-toll-free phone number, based on the country specified in `address.region`. Phone numbers for US entities must contain 10 digits.
locatedIn	string For atms, the external ID of the entity that the atm is installed in. The entity must be in the same business account as the atm.
locationType	string Enum: "LOCATION" "HEALTHCARE_FACILITY" "HEALTHCARE_PROFESSIONAL" "ATM" "RESTAURANT" "HOTEL" Indicates the entity's type, if it is not an event
	object An image of the entity's logo Supported Aspect Ratios: 1 x 1 NOTE: Maximum image size is 5mb after normalization and padding (if applicable). As well, there is a 6 second download limit from the image host.
mainPhone	string >= 0 characters The main phone number of the entity's point of contact Must be a valid phone number. If the phone number's calling code is for a country other than the one given in the entity's `countryCode`, the phone number provided must contain the calling code (e.g., `+44` in `+442038083831`). Otherwise, the calling code is optional.
mobilePhone	string >= 0 characters Must be a valid phone number. If the phone number's calling code is for a country other than the one given in the entity's `countryCode`, the phone number provided must contain the calling code (e.g., `+44` in `+442038083831`). Otherwise, the calling code is optional.
nudgeEnabled	boolean Indicates whether Knowledge Nudge is enabled for the Yext Knowledge Assistant for this entity
	Array of objects NOTE: The list of photos that you send us must be comprehensive. For example, if you send us a list of photos that does not include photos that you sent in your last update, Yext considers the missing photos to be deleted, and we remove them from your listings. Array must be ordered. Array may have a maximum of 500 elements. Array item description: Supported Aspect Ratios: 1 x 1 4 x 3 3 x 2 5 x 3 16 x 9 3 x 1 2 x 3 5 x 7 4 x 5 4 x 1 NOTE: Maximum image size is 5mb after normalization and padding (if applicable). As well, there is a 6 second download limit from the image host.
	object Coordinates of where consumers can be picked up at the entity, as provided by you
priceRange	string Enum: "UNSPECIFIED" "ONE" "TWO" "THREE" "FOUR" he typical price of products sold by this location, on a scale of 1 (low) to 4 (high)
primaryConversationContact	string >= 0 characters ID of the user who is the primary Knowledge Assistant contact for the entity
questionsAndAnswers	boolean Indicates whether Yext Knowledge Assistant question-and-answer conversations are enabled for this entity
	Array of objects unique Information about the competitors whose search performance you would like to compare to your own Array must be ordered. Array may have a maximum of 5 elements.
rankTrackingEnabled	boolean Indicates whether Rank Tracking is enabled
rankTrackingFrequency	string Enum: "WEEKLY" "MONTHLY" "QUARTERLY" How often we send search queries to track your search performance
rankTrackingQueryTemplates	Array of strings unique Items Enum: "KEYWORD" "KEYWORD_ZIP" "KEYWORD_CITY" "KEYWORD_IN_CITY" "KEYWORD_NEAR_ME" "KEYWORD_CITY_STATE" The ways in which your keywords will be arranged in the search queries we use to track your performance Array must have a minimum of 2 elements. Array may have a maximum of 4 elements.
rankTrackingSites	Array of strings unique Items Enum: "GOOGLE_DESKTOP" "GOOGLE_MOBILE" "BING_DESKTOP" "BING_MOBILE" "YAHOO_DESKTOP" "YAHOO_MOBILE" The search engines that we will use to track your performance
reviewResponseConversationEnabled	boolean Indicates whether Yext Knowledge Assistant review-response conversations are enabled for this entity
	object Destination coordinates to use for driving directions to the entity, as provided by you
timezone	string >= 0 characters The timezone of the entity, in the standard `IANA time zone database` format (tz database). e.g. `"America/New_York"`
tollFreePhone	string >= 0 characters Must be a valid phone number. If the phone number's calling code is for a country other than the one given in the entity's `countryCode`, the phone number provided must contain the calling code (e.g., `+44` in `+442038083831`). Otherwise, the calling code is optional.
ttyPhone	string >= 0 characters Must be a valid phone number. If the phone number's calling code is for a country other than the one given in the entity's `countryCode`, the phone number provided must contain the calling code (e.g., `+44` in `+442038083831`). Otherwise, the calling code is optional.
	object Destination coordinates to use for walking directions to the entity, as provided by you
	object Information about the website for this entity

Responses

Request samples

Payload

Content type

application/json

Example

atm

{"EntityType": "atm",
"meta": {"countryCode": "string",
"folderId": "string",
"id": "string",
"labels": ["string"
],
"language": "string"
},
"name": "string",
"address": {"city": "string",
"countryCode": "string",
"extraDescription": "string",
"line1": "string",
"line2": "string",
"postalCode": "string",
"region": "string",
"sublocality": "string"
},
"accessHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"additionalHoursText": "string",
"alternateNames": ["string"
],
"alternatePhone": "string",
"alternateWebsites": ["http://example.com"
],
"appleActionLinks": [{"appName": "string",
"appStoreUrl": "http://example.com",
"category": "BOOK_TRAVEL",
"quickLinkUrl": "http://example.com"
}
],
"appleBusinessDescription": "string",
"appleBusinessId": "string",
"appleCompanyId": "string",
"appleCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"categories": { },
"categoryIds": ["string"
],
"closed": true,
"customKeywords": ["string"
],
"description": "stringstri",
"displayCoordinate": {"latitude": -90,
"longitude": -180
},
"driveThroughHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"dropoffCoordinate": {"latitude": -90,
"longitude": -180
},
"facebookAbout": "string",
"facebookCallToAction": {"type": "NONE",
"value": "string"
},
"facebookCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"facebookDescriptor": "string",
"facebookName": "string",
"facebookOverrideCity": "string",
"facebookPageUrl": "string",
"facebookParentPageId": "string",
"facebookProfilePhoto": {"alternateText": "string",
"url": "http://example.com"
},
"facebookStoreId": "string",
"facebookVanityUrl": "string",
"facebookWebsiteOverride": "http://example.com",
"fax": "string",
"featuredMessage": {"description": "string",
"url": "http://example.com"
},
"frequentlyAskedQuestions": [{"answer": "string",
"question": "string"
}
],
"geomodifier": "string",
"googleAttributes": { },
"googleCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"googleMyBusinessLabels": ["string"
],
"googlePlaceId": "string",
"googleProfilePhoto": {"alternateText": "string",
"url": "http://example.com"
},
"googleWebsiteOverride": "http://example.com",
"holidayHoursConversationEnabled": true,
"hours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"impressum": "string",
"isoRegionCode": "string",
"keywords": ["string"
],
"labels": ["string"
],
"landingPageUrl": "http://example.com",
"localPhone": "string",
"locatedIn": "string",
"locationType": "LOCATION",
"logo": {"clickthroughUrl": "http://example.com",
"description": "string",
"details": "string",
"image": {"alternateText": "string",
"url": "http://example.com"
}
},
"mainPhone": "string",
"mobilePhone": "string",
"nudgeEnabled": true,
"photoGallery": [{"clickthroughUrl": "http://example.com",
"description": "string",
"details": "string",
"image": {"alternateText": "string",
"url": "http://example.com"
}
}
],
"pickupCoordinate": {"latitude": -90,
"longitude": -180
},
"priceRange": "UNSPECIFIED",
"primaryConversationContact": "string",
"questionsAndAnswers": true,
"rankTrackingCompetitors": [{"name": "string",
"website": "http://example.com"
}
],
"rankTrackingEnabled": true,
"rankTrackingFrequency": "WEEKLY",
"rankTrackingQueryTemplates": ["KEYWORD"
],
"rankTrackingSites": ["GOOGLE_DESKTOP"
],
"reviewResponseConversationEnabled": true,
"routableCoordinate": {"latitude": -90,
"longitude": -180
},
"timezone": "string",
"tollFreePhone": "string",
"ttyPhone": "string",
"walkableCoordinate": {"latitude": -90,
"longitude": -180
},
"websiteUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
}
}

Response samples

Content type

application/json

{"meta": {"uuid": "string"
},
"response": {"meta": {"accountId": "string",
"countryCode": "string",
"createdTimestamp": "string",
"entityType": "string",
"folderId": "string",
"id": "string",
"labels": ["string"
],
"language": "string",
"timestamp": "string",
"uid": "string"
},
"name": "string",
"address": {"city": "string",
"countryCode": "string",
"extraDescription": "string",
"line1": "string",
"line2": "string",
"postalCode": "string",
"region": "string",
"sublocality": "string"
},
"acceptingNewPatients": true,
"acceptsReservations": true,
"accessHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"additionalHoursText": "string",
"additionalPromotingLocations": ["string"
],
"addressHidden": true,
"admittingHospitals": ["string"
],
"adultPool": "YES",
"ageRange": {"maxValue": 0,
"minValue": 0
},
"airportShuttle": "AIRPORT_SHUTTLE_AVAILABLE",
"airportTransfer": "YES",
"allInclusive": "ALL_INCLUSIVE_RATES_AVAILABLE",
"alternateNames": ["string"
],
"alternatePhone": "string",
"alternateWebsites": ["http://example.com"
],
"androidAppUrl": "string",
"answer": "string",
"appleActionLinks": [{"appName": "string",
"appStoreUrl": "http://example.com",
"category": "BOOK_TRAVEL",
"quickLinkUrl": "http://example.com"
}
],
"appleBusinessDescription": "string",
"appleBusinessId": "string",
"appleCompanyId": "string",
"appleCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"applicationUrl": "http://example.com",
"associations": ["string"
],
"attendance": {"attendanceMode": "OFFLINE",
"virtualLocationUrl": "http://example.com"
},
"attire": "UNSPECIFIED",
"babysittingOffered": "YES",
"baggageStorage": "YES",
"bar": "YES",
"beachAccess": "YES",
"beachFrontProperty": "YES",
"bicycles": "BICYCLE_RENTALS",
"bios": {"ids": ["string"
],
"label": "string"
},
"boutiqueStores": "YES",
"brands": ["string"
],
"breakfast": "BREAKFAST_AVAILABLE",
"brunchHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"businessCenter": "YES",
"calendars": {"ids": ["string"
],
"label": "string"
},
"carRental": "YES",
"casino": "YES",
"categories": { },
"categoryIds": ["string"
],
"catsAllowed": "YES",
"certifications": ["string"
],
"checkInTime": "14:15:22Z",
"checkOutTime": "14:15:22Z",
"classificationRating": "string",
"closed": true,
"concierge": "YES",
"conditionsTreated": ["string"
],
"convenienceStore": "YES",
"covidMessaging": "string",
"covidTestAppointmentUrl": "http://example.com",
"covidTestingAppointmentRequired": true,
"covidTestingDriveThroughSite": true,
"covidTestingIsFree": true,
"covidTestingPatientRestrictions": true,
"covidTestingReferralRequired": true,
"covidTestingSiteInstructions": "string",
"covidVaccineAppointmentRequired": true,
"covidVaccineDriveThroughSite": true,
"covidVaccineInformationUrl": "http://example.com",
"covidVaccinePatientRestrictions": true,
"covidVaccineReferralRequired": true,
"covidVaccineSiteInstructions": "string",
"covidVaccinesOffered": ["PFIZER"
],
"currencyExchange": "YES",
"customKeywords": ["string"
],
"datePosted": "2019-08-24",
"degrees": ["ANP"
],
"deliveryHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"description": "stringstri",
"displayCoordinate": {"latitude": -90,
"longitude": -180
},
"doctorOnCall": "YES",
"dogsAllowed": "YES",
"driveThroughHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"dropoffCoordinate": {"latitude": -90,
"longitude": -180
},
"educationList": [{"institutionName": "string",
"type": "FELLOWSHIP",
"yearCompleted": 1900
}
],
"electricChargingStation": "YES",
"elevator": "YES",
"ellipticalMachine": "YES",
"emails": ["user@example.com"
],
"employmentType": "FULL_TIME",
"eventStatus": "SCHEDULED",
"facebookAbout": "string",
"facebookCallToAction": {"type": "NONE",
"value": "string"
},
"facebookCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"facebookDescriptor": "string",
"facebookName": "string",
"facebookOverrideCity": "string",
"facebookPageUrl": "string",
"facebookParentPageId": "string",
"facebookProfilePhoto": {"alternateText": "string",
"url": "http://example.com"
},
"facebookStoreId": "string",
"facebookVanityUrl": "string",
"facebookWebsiteOverride": "http://example.com",
"fax": "string",
"featuredMessage": {"description": "string",
"url": "http://example.com"
},
"firstName": "string",
"firstPartyReviewPage": "string",
"fitnessCenter": "FITNESS_CENTER_AVAILABLE",
"floorCount": 0,
"freeWeights": "YES",
"frequentlyAskedQuestions": [{"answer": "string",
"question": "string"
}
],
"frontDesk": "FRONT_DESK_AVAILABLE",
"fullyVaccinatedStaff": true,
"gameRoom": "YES",
"gender": "UNSPECIFIED",
"geomodifier": "string",
"giftShop": "YES",
"golf": "YES",
"googleAttributes": { },
"googleCoverPhoto": {"alternateText": "string",
"url": "http://example.com"
},
"googleMyBusinessLabels": ["string"
],
"googlePlaceId": "string",
"googleProfilePhoto": {"alternateText": "string",
"url": "http://example.com"
},
"googleWebsiteOverride": "http://example.com",
"happyHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"headshot": {"alternateText": "string",
"url": "http://example.com"
},
"hiringOrganization": "string",
"holidayHoursConversationEnabled": true,
"horsebackRiding": "YES",
"hotTub": "YES",
"hours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"housekeeping": "HOUSEKEEPING_AVAILABLE",
"impressum": "string",
"indoorPoolCount": 0,
"instagramHandle": "string",
"insuranceAccepted": ["string"
],
"iosAppUrl": "string",
"isClusterPrimary": true,
"isFreeEvent": true,
"isoRegionCode": "string",
"keywords": ["string"
],
"kidFriendly": "YES",
"kidsClub": "YES",
"kidsStayFree": "YES",
"kitchenHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"labels": ["string"
],
"landingPageUrl": "http://example.com",
"languages": ["string"
],
"lastName": "string",
"laundry": "FULL_SERVICE",
"lazyRiver": "YES",
"lifeguard": "YES",
"linkedInUrl": "http://example.com",
"linkedLocation": "string",
"localPhone": "string",
"localShuttle": "YES",
"locatedIn": "string",
"location": {"existingLocation": "string",
"externalLocation": "string"
},
"locationType": "LOCATION",
"logo": {"clickthroughUrl": "http://example.com",
"description": "string",
"details": "string",
"image": {"alternateText": "string",
"url": "http://example.com"
}
},
"mainPhone": "string",
"massage": "YES",
"maxAgeOfKidsStayFree": 0,
"maxNumberOfKidsStayFree": 0,
"mealsServed": ["BREAKFAST"
],
"meetingRoomCount": 0,
"menuUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"menus": {"ids": ["string"
],
"label": "string"
},
"middleName": "string",
"mobilePhone": "string",
"mobilityAccessible": "YES",
"nightclub": "YES",
"npi": "string",
"nudgeEnabled": true,
"officeName": "string",
"onlineServiceHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"operatingCountries": ["AD"
],
"orderUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"organizerEmail": "user@example.com",
"organizerName": "string",
"organizerPhone": "string",
"outdoorPoolCount": 0,
"parking": "PARKING_AVAILABLE",
"paymentOptions": ["AFTERPAY"
],
"performers": ["string"
],
"petsAllowed": "PETS_WELCOME",
"photoGallery": [{"clickthroughUrl": "http://example.com",
"description": "string",
"details": "string",
"image": {"alternateText": "string",
"url": "http://example.com"
}
}
],
"pickupCoordinate": {"latitude": -90,
"longitude": -180
},
"pickupHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"pinterestUrl": "http://example.com",
"priceRange": "UNSPECIFIED",
"primaryConversationContact": "string",
"privateBeach": "YES",
"privateCarService": "PRIVATE_CAR_SERVICE",
"productLists": {"ids": ["string"
],
"label": "string"
},
"products": ["string"
],
"questionsAndAnswers": true,
"rankTrackingCompetitors": [{"name": "string",
"website": "http://example.com"
}
],
"rankTrackingEnabled": true,
"rankTrackingFrequency": "WEEKLY",
"rankTrackingQueryTemplates": ["KEYWORD"
],
"rankTrackingSites": ["GOOGLE_DESKTOP"
],
"reservationUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"restaurantCount": 0,
"reviewGenerationUrl": "string",
"reviewResponseConversationEnabled": true,
"roomCount": 0,
"roomService": "ROOM_SERVICE_AVAILABLE",
"routableCoordinate": {"latitude": -90,
"longitude": -180
},
"salon": "YES",
"sauna": "YES",
"scuba": "YES",
"selfParking": "SELF_PARKING_AVAILABLE",
"seniorHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"serviceArea": {"places": ["string"
]
},
"serviceAreaPlaces": [{"name": "string",
"googlePlaceId": "string",
"type": "POSTAL_CODE"
}
],
"services": ["string"
],
"smokeFreeProperty": "YES",
"snorkeling": "YES",
"socialHour": "YES",
"spa": "YES",
"specialities": ["string"
],
"tableService": "YES",
"takeoutHours": {"friday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"holidayHours": [{"date": "2019-08-24",
"isClosed": true,
"isRegularHours": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
],
"monday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"reopenDate": "2019-08-24",
"saturday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"sunday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"thursday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"tuesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
},
"wednesday": {"isClosed": true,
"openIntervals": [{"end": "14:15:22Z",
"start": "14:15:22Z"
}
]
}
},
"tennis": "YES",
"thermalPool": "YES",
"ticketAvailability": "IN_STOCK",
"ticketPriceRange": {"currencyCode": "string",
"maxValue": "string",
"minValue": "string"
},
"ticketSaleDateTime": "2019-08-24T14:15:22Z",
"ticketUrl": "http://example.com",
"tikTokUrl": "http://example.com",
"time": {"end": "2019-08-24T14:15:22Z",
"start": "2019-08-24T14:15:22Z"
},
"timeZoneUtcOffset": "string",
"timezone": "string",
"tollFreePhone": "string",
"treadmill": "YES",
"ttyPhone": "string",
"turndownService": "YES",
"twitterHandle": "string",
"uberLink": {"presentation": "BUTTON",
"text": "string"
},
"uberTripBranding": {"description": "string",
"text": "string",
"url": "http://example.com"
},
"valetParking": "VALET_PARKING_AVAILABLE",
"validThrough": "2019-08-24T14:15:22Z",
"vendingMachine": "YES",
"venueName": "string",
"videos": [{"description": "string",
"video": {"url": "http://example.com"
}
}
],
"wadingPool": "YES",
"wakeUpCalls": "YES",
"walkableCoordinate": {"latitude": -90,
"longitude": -180
},
"waterPark": "YES",
"waterSkiing": "YES",
"watercraft": "WATERCRAFT_RENTALS",
"waterslide": "YES",
"wavePool": "YES",
"websiteUrl": {"displayUrl": "http://example.com",
"preferDisplayUrl": true,
"url": "http://example.com"
},
"weightMachine": "YES",
"wheelchairAccessible": "YES",
"wifiAvailable": "WIFI_AVAILABLE",
"workRemote": true,
"yearEstablished": 1000,
"yearLastRenovated": 1000,
"yextDisplayCoordinate": {"latitude": -90,
"longitude": -180
},
"yextDropoffCoordinate": {"latitude": -90,
"longitude": -180
},
"yextPickupCoordinate": {"latitude": -90,
"longitude": -180
},
"yextRoutableCoordinate": {"latitude": -90,
"longitude": -180
},
"yextWalkableCoordinate": {"latitude": -90,
"longitude": -180
},
"youTubeChannelUrl": "http://example.com"
}
}

Entity Language Profiles: Delete

Delete a language profile

path Parameters

accountId required	string >= 0 characters
entityId required	string >= 0 characters The external ID of the requested Entity
languageCode required	string >= 0 characters The language code corresponding to the language of the profile that the user wishes to delete

query Parameters

required

string >= 0 characters

A date in YYYYMMDD format.

header Parameters

Update-Operation-Id

string >= 0 characters

The ID of the operation. Leave this blank to create a new operation or supply an ID to continue an existing operation

Responses

Response samples

Content type

application/json

{"meta": {"uuid": "string"
},
"response": { }
}