{
"opencollection": "1.0.0",
"info": {
"name": "Yext Admin Account Settings Live API API",
"version": "2.0"
},
"request": {
"auth": {
"type": "apikey",
"key": "api_key",
"value": "{{api_key}}",
"placement": "query"
}
},
"items": [
{
"info": {
"name": "Live API",
"type": "folder"
},
"items": [
{
"info": {
"name": "Entities: List",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.yextapis.com/v2/accounts/:accountId/entities",
"params": [
{
"name": "accountId",
"value": "",
"type": "path"
},
{
"name": "v",
"value": "",
"type": "query",
"description": "A date in `YYYYMMDD` format."
},
{
"name": "convertMarkdownToHTML",
"value": "",
"type": "query",
"description": "Optional parameter to return fields of type **Markdown** as HTML.\n - `false`: **Markdown** fields will be returned as JSON\n - `true`: **Markdown** fields will be returned as HTML\n"
},
{
"name": "convertRichTextToHTML",
"value": "",
"type": "query",
"description": "Optional parameter to return fields of type **Rich Text** as HTML.\n - `false`: **Rich Text** fields will be returned as JSON\n - `true`: **Rich Text** fields will be returned as HTML\n"
},
{
"name": "entityTypes",
"value": "",
"type": "query",
"description": "Comma-separated list of Entity types to filter on. Example: `\"location,event\"`\n\nShould be from the following types:\n * `atm`\n * `event`\n * `faq`\n * `financialProfessional`\n * `healthcareFacility`\n * `healthcareProfessional`\n * `hotel`\n * `hotelRoomType`\n * `job`\n * `location`\n * `organization`\n * `product`\n * `restaurant`\n\nOR the API name of a custom entity type.\n"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "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."
},
{
"name": "filter",
"value": "",
"type": "query",
"description": "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.\n\nFor 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`\n\n**Basic Filter Structure**\n\nThe filter object at its core consists of a *matcher*, a *field*, and an *argument*.\n\nFor example, in the following filter JSON:\n\n```\n{\n \"name\":{\n \"$eq\":\"John\"\n }\n}\n```\n\n`$eq` is the *matcher*, or filtering operation (equals, in this example),\n\n`name` is the *field* being filtered by, and\n\n`John` is *value* to be matched against.\n\n**Combining Multiple Filters**\n\nMultiple 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.\n```\n{\n \"$and\":[\n {\n \"firstName\":{\n \"$eq\":\"John\"\n }\n },\n {\n \"countryCode\":{\n \"$in\":[\n \"US\",\n \"GB\"\n ]\n }\n }\n ]\n}\n```\n\n**Filter Negation**\n\nCertain filter types may be negated. For example:\n\n```\n{\n \"$not\": {\n \"name\": {\n \"$eq\": \"John\"\n }\n }\n}\n```\n\nThis can also be written more simply with a `!` in the `$eq` parameter. The following filter would have the same effect:\n\n```\n{\n \"name\":{\n \"!$eq\":\"John\"\n }\n}\n```\n\n**Filter Complement**\n\nYou 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.\n\n```\n{\n \"$complement\":{\n \"description\":{\n \"$contains\":\"hello\"\n }\n }\n}\n```\n\n**Addressing Subfields**\n\nSubfields of fields can be addressed using the \"dot\" notation while filtering. For example, if you have a custom field called **`c_myCustomField`**:\n\n```\n{\n \"c_myCustomField\":{\n \"age\": 30,\n \"name\": \"Jim\",\n }\n}\n```\n\nWhile filtering, subfields may be addressed using the \"dot\" notation.\n\n```\n{\n \"c_myCustomField.name\":{\n \"!$eq\":\"John\"\n }\n}\n```\n\nFields 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`**.\n\n**Field Support**\n\nEntity 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).\n\n**TEXT**\n\nThe `TEXT` filter type is supported for text fields. (e.g., **`name`**, **`countryCode`**)\n\n
\n \n | Filter Type | \n Syntax | \n Description | \n
\n \n | Full | \n fieldName: {contains: $search} | \n $search is the search string | \n
\n \n | Text | \n fieldName: {$type: [$search,...]} | \n $type is one of [contains,doesNotContain,startsWith,equalTo], $search is an array of search strings, combined with OR | \n
\n \n | Text | \n fieldName: $type | \n $type is one of [empty,notEmpty] | \n
\n \n | Number | \n fieldName: {$type: $value} | \n $type is one of [eq,lt,gt,le,ge], $value is the numeric value | \n
\n \n | Number | \n fieldName: {$type: [$value1, $value2]} | \n $type is one of [between], $value1 and $value2 are numeric values | \n
\n \n | Date | \n fieldName: {$type: $value} | \n $type is one of [eq,lt,gt,le,ge], $value is a string of \"YYYY-MM-DD\" formatted date | \n
\n \n | Date | \n fieldName: $type | \n $type is one of [empty,notEmpty] | \n
\n \n | Date | \n fieldName: {$type: [$value1, $value2]} | \n $type is one of [between], $value1 and $value2 are strings of \"YYYY-MM-DD\" formatted date | \n
\n \n | Categories | \n fieldName: {$type: [$id,...]} | \n $type is one of [includes,notIncludes], $id is an array of numeric category IDs, combined with OR | \n
\n \n | Categories | \n fieldName: $type | \n $type is one of [none] | \n
\n \n | Assets | \n fieldName: {$type: [$id,...]} | \n $type is one of [includes,notIncludes], $id is an array of numeric category IDs, combined with OR | \n
\n \n | Assets | \n fieldName: $type | \n $type is one of [none] | \n
\n \n | Country | \n fieldName: {$type: [$country,...]} | \n $type is one of [includes,notIncludes], $country is an array of country code strings, combined with OR | \n
\n \n | PrimaryLanguage | \n fieldName: {$type: [$language,...]} | \n $type is one of [is,isNot], $language is an array of language code strings, combined with OR | \n
\n \n | AlternateLanguage | \n fieldName: {$type: [$language,...]} | \n $type is one of [includes, notIncludes], $language is an array of language code strings, combined with OR | \n
\n \n | StringSingle | \n fieldName: {$type: [$string,...]} | \n $type is one of [is,isNot], $string is an array of strings, combined with OR | \n
\n \n | StringList | \n fieldName: {$type: [$string,...]} | \n $type is one of [includes,notIncludes], $string is an array of strings, combined with OR | \n
\n \n | LocationType | \n fieldName: {$type: [$id,...]} | \n $type is one of [is,isNot], $id is an array of location type IDs, combined with OR | \n
\n \n | Bool | \n fieldName: $type | \n $type is one of [true,false] | \n
\n \n | Option | \n fieldName: {$type: $id} | \n $type is one of [is,isNot], $id is an option ID (For single option custom fields) | \n
\n \n | Option | \n fieldName: {$type: [$id,...]} | \n $type is one of [includes,notIncludes], $id is an array of option IDs, combined with OR (For multi option custom fields) | \n
\n \n | Folder | \n fieldName: [$id,...] | \n $id is a numeric folder ID | \n
\n \n | Folder | \n fieldName: $id | \n $id is a numeric folder ID | \n
\n \n | Folder | \n fieldName: {$type: [$id,...]} | \n $id is a numeric folder ID, $type is one of ['isIn', 'isNotIn'] | \n
\n \n | Labels | \n fieldName: {$type: [$id,...]} | \n $type is one of [includes,notIncludes], $id is an array of label IDs, combined with OR | \n
\n
\n\nThe following fields can be specified in the request (Field name/Filter Type/Example(s)):\n\n\n \n | Field Name | \n Filter Type | \n Example(s) | \n
\n \n | location | \n Full | \n \"location\": {\"contains\": \"Atlanta\"} | \n
\n \n | name | \n Text | \n \"name\": {\"startsWith\": [\"Guitar\"]}, \"name\": {\"contains\": [\"A\",\"B\"]} | \n
\n \n | address | \n Text | \n \"address\": {\"startsWith\": [\"South\"]} | \n
\n \n | address2 | \n Text | \n \"address2\": {\"contains\": [\"Suite\"]} | \n
\n \n | city | \n Text | \n \"city\": {\"contains\": [\"Atlanta\"]} | \n
\n \n | state | \n Text | \n \"state\": {\"contains\": [\"AK\",\"VA\"]} | \n
\n \n | zip | \n Text | \n \"zip\": {\"contains\": [\"M5K 7QB\"]} | \n
\n \n | phones | \n Text | \n \"phones\": {\"startsWith\": [\"703\",\"571\"]} | \n
\n \n | specialOffer | \n Text | \n \"specialOffer\": \"notEmpty\" | \n
\n \n | emails | \n Text | \n \"emails\": {\"doesNotContain\": [\"@yext.com\"]} | \n
\n \n | website | \n Text | \n \"website\": {\"equalTo\": [\"https://www.yext.com/\"]} | \n
\n \n | categories | \n Categories | \n \"categories\": {\"includes\": [23,755,34]} | \n
\n \n | closed | \n Bool | \n \"closed\": true | \n
\n \n | storeId | \n Text | \n \"storeId\": {\"equalTo\": [\"MCD0001\"]} | \n
\n \n | countryCode | \n Country | \n \"countryCode\": {\"notIncludes\": [\"US\"]} | \n
\n \n | products | \n Text | \n \"products\": {\"startsWith\": [\"Burger\",\"Fries\"]} | \n
\n \n | services | \n Text | \n \"services\": {\"contains\": [\"Manicures\"]} | \n
\n \n | specialities | \n Text | \n \"services\": \"notEmpty\" | \n
\n \n | associations | \n Text | \n \"associations\": \"empty\" | \n
\n \n | brands | \n Text | \n \"brands\": {\"equalTo\": [\"North Face\"]} | \n
\n \n | languages | \n Text | \n \"languages\": {\"equalTo\": [\"English\",\"Spanish\"]} | \n
\n \n | keywords | \n Text | \n \"keywords\": {\"startsWith\": [\"Franchise\"]} | \n
\n \n | menuIds | \n IdList | \n \"menuIds\": {\"includes\": [\"m-23\",\"755\",\"menu34\"]} | \n
\n \n | productListIds | \n IdList | \n \"productListIds\": {\"notIncludes\": [\"pl-2\"]} | \n
\n \n | calendarIds | \n IdList | \n \"calendarIds\": {\"notIncludes\": [\"cal34\"]} | \n
\n \n | bioIds | \n IdList | \n \"bioIds\": {\"includes\": [\"b23\",\"34\"]} | \n
\n \n | custom### | \n Text (for Multiline Text, URL, Text List, and Text Custom Fields), Number, Date, Bool, or Option | \n \"custom123\": {\"equalTo\": [\"asdf\"]} | \n
\n \n | folder | \n Folder | \n \"folder\": 123, \"folder\": [123,456] | \n
\n \n | primary_language | \n PrimaryLanguage | \n \"primary_language\": {\"is\": \"fr_CA\"} | \n
\n \n | alternateProfileLanguage | \n AlternateLanguage | \n \"alternateProfileLanguage\": {\"includes\": [\"en\", \"fr\"]} | \n
\n \n | npi | \n StringSingle | \n \"npi\": {\"is\": [\"1234567890\", \"1111111111\"]} | \n
\n \n | conditionsTreated | \n Text | \n \"conditionsTreated\": {\"startsWith\": [\"Influenza\"]}, \"conditionsTreated\": {\"contains\": [\"A\",\"B\"]} | \n
\n \n | lastUpdated | \n Date | \n \"lastUpdated\": {\"eq\": \"2018-01-01\"}, \"lastUpdated\": {\"between\": [\"2017-01-01\", \"2018-01-01\"]} | \n
\n \n | fieldsWithData | \n Fields | \n \"fieldsWithData\": [\"email\", \"hours\"] | \n
\n \n | fieldsWithoutData | \n Fields | \n \"fieldsWithoutData\": [\"logo\", \"video\"] | \n
\n \n | reviewCount | \n Number | \n \"review_count\": {\"gt\": 1}, \"review_count \": {\"lt\": 10} | \n
\n \n | averageRating | \n Number | \n \"averageRating\": {\"lt\": 3} | \n
\n \n | locationType | \n LocationType | \n \"locationType\": {\"is\": [1]}, \"locationType\": {\"isNot\": [123]} | \n
\n \n | gender | \n StringSingle | \n \"gender\": {\"is\": [\"FEMALE\"]}, \"gender\": {\"isNot\": [\"MALE\"]} | \n
\n \n | degrees | \n StringList | \n \"degrees\": {\"includes\": [\"MD\"]}, \"degrees\": {\"notIncludes\": [\"PHD\"]} | \n
\n \n | experiences | \n StringList | \n \"experiences\": {\"includes\": [\"FELLOWSHIP\"]}, \"experiences\": {\"notIncludes\":[\"INTERNSHIP\"]} | \n
\n \n | yearCompleted | \n Number | \n \"yearCompleted\": {\"gt\": 2000}, \"yearCompleted\": {\"lt\": 2015} | \n
\n \n | acceptingNewPatients | \n Bool | \n \"acceptingNewPatients\": true | \n
\n \n | firstName | \n Text | \n \"firstName\": {\"startsWith\": [\"David\"]}, \"firstName\": {\"contains\": [\"A\",\"B\"]} | \n
\n \n | middleName | \n Text | \n \"middleName\": {\"startsWith\": [\"P\"]}, \"middleName\": {\"contains\": [\"N\",\"E\"]} | \n
\n \n | lastName | \n Text | \n \"lastName\": {\"startsWith\": [\"Sm\"]}, \"lastName\": {\"contains\": [\"Y\",\"Z\"]} | \n
\n \n | officeName | \n Text | \n \"officeName\": {\"startsWith\": [\"Chiropractic\"]}, \"officeName\": {\"contains\":[\"Center\",\"P\"]} | \n
\n \n | certifications | \n Text | \n \"certifications\": {\"contains\": [\"Radiation Oncology\"]} | \n
\n \n | institutionName | \n Text | \n \"institutionName\": {\"startsWith\": [\"New York\"]} | \n
\n \n | insuranceAccepted | \n Text | \n \"insuranceAccepted\": {\"startsWith\": [\"United\"]}, \"insuranceAccepted\":{\"contains\": [\"C\",\"Health\"]} | \n
\n \n | admittingHospitals | \n Text | \n \"admittingHospitals\": {\"startsWith\": [\"Children's\"]}, \"admittingHospitals\":{\"contains\": [\"Medical\",\"University\"]} | \n
\n \n | subscriptions | \n IdList | \n \"subscriptions\": {\"notIncludes\": [\"123\"]} | \n
\n \n | facebookAccounts | \n IdList | \n \"facebookAccounts\": {\"notIncludes\": [\"1111\"]} | \n
\n \n | foursquareAccounts | \n IdList | \n \"foursquareAccounts\": {\"notIncludes\": [\"1111\"]} | \n
\n \n | googleplusAccounts | \n IdList | \n \"googleplusAccounts\": {\"notIncludes\": [\"1111\"]} | \n
\n \n | labels | \n Labels | \n \"labels\": {\"includes\": [1, 100]} | \n
\n
\n"
},
{
"name": "v",
"value": "",
"type": "query",
"description": "A date in `YYYYMMDD` format."
},
{
"name": "sortBy",
"value": "",
"type": "query",
"description": "Specifies the fields and direction by which the output should be sorted. Should be provided as a URL-encoded string containing a JSON array of `sortDefinition` objects. A `sortDefinition` object consists of a `sortField` and a `sortDirection` field. The `sortField` is the name of the field you are sorting by (e.g., `firstName` or `custom###` for a custom field, where \"###\" is the custom field’s **`id`**). The `sortDirection` indicates whether the sort is ascending (`ASCENDING`) or descending (`DESCENDING`).\n\nFor example, to sort by last name ascending and first name descending, this parameter would be `[{\"sortField\":\"lastName\",\"sortDirection\":\"ASCENDING\"},{\"sortField\":\"firstName\", \"sortDirection\":\"DESCENDING\"}]`, which, when URL-encoded, would be `%5B%7B%22sortField%22%3A%22lastName%22%2C%22sortDirection%22%3A%22ASCENDING%22%7D%2C%7B%22sortField%22%3A%22firstName%22%2C%22sortDirection%22%3A%22DESCENDING%22%7D%5D`.\n\n**NOTE:** Currently, we support sorting by **`firstName`**, **`lastName`**, and text custom fields.\n"
}
]
},
"docs": "Get multiple Locations (primary profile only). Filters are evaluated against all language profiles as well as the primary profile.\n\n**NOTE:** Responses will contain resolved values for embedded fields\n"
},
{
"info": {
"name": "Locations Schema (Legacy): Get",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.yextapis.com/v2/accounts/:accountId/locations/:locationId/schema",
"params": [
{
"name": "accountId",
"value": "",
"type": "path"
},
{
"name": "locationId",
"value": "",
"type": "path"
},
{
"name": "v",
"value": "",
"type": "query",
"description": "A date in `YYYYMMDD` format."
}
]
},
"docs": "Gets the schema.org-compliant schema for the primary profile of a single Location. Schema will vary depending on the primary category of the Location."
},
{
"info": {
"name": "Locations (Legacy): GeoSearch",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.yextapis.com/v2/accounts/:accountId/locations/geosearch",
"params": [
{
"name": "accountId",
"value": "",
"type": "path"
},
{
"name": "limit",
"value": "",
"type": "query",
"description": "Number of results to return."
},
{
"name": "offset",
"value": "",
"type": "query",
"description": "Number of results to skip. Used to move through results"
},
{
"name": "location",
"value": "",
"type": "query",
"description": "\nOnly entities near this position will be returned. The values can be specified in one of two ways:\n\n1) Latitude and Longitude: The latitude and longitude of the point, separated by a comma (e.g.`\"40.740957,-73.987565\"`),\n\n2) Address: A free-form address to geocode into a latitude and longitude (e.g., `\"1 Madison Ave, New York, NY 10010\"` or `\"New York, NY\"`).\n\nNote that providing an address that resolves to an area, like a city or a postal code, does not restrict the search to exactly that area; it simply centers the search circle on a point in that area.\n"
},
{
"name": "radius",
"value": "",
"type": "query",
"description": "\nIndicates the search radius around the provided **`location`** in miles\n"
},
{
"name": "geocoderBias",
"value": "",
"type": "query",
"description": "The latitude, longitude, and approximate radius in miles, separated by commas, where the geocoder should be biased.\n"
},
{
"name": "countryBias",
"value": "",
"type": "query",
"description": "\nThe two-character ISO 3166-1 code of the country where the geocoder should be biased.\n\nThe value of the **`countryBias`** parameter influences the search results, but it does not guarantee that the geocoded location will be in the country provided.\n\nIf both **`countryBias`** and **`geocoderBias`** are provided, **`geocoderBias`** is given priority, but both values are considered in the search.\n"
},
{
"name": "languages",
"value": "",
"type": "query",
"description": "\nComma-separated list of language codes. When present, the system will return Locations with one or more of the provided languages. For each Location, only the first available language from the provided list will be returned. The keyword `\"primary\"` can be used to refer to a Location’s primary profile without providing a specific language code.\n"
},
{
"name": "fields",
"value": "",
"type": "query",
"description": "Comma-separated list of field names from the Location object. When present, only the fields listed will be returned. You can use dot notation to specify substructures (e.g., `\"logo.url\"`). To include a custom field, specify it as `custom###`, where \"###\" is the custom field's **`id`**.\n"
},
{
"name": "filters",
"value": "",
"type": "query",
"description": "A set of filters that is applied to the set of locations that would otherwise be returned. Should be provided as a URL-encoded string containing a JSON array. The array should have one or more filter objects defined. All filter objects will apply as an intersection (i.e., AND). Field names reference Location fields, as well as custom fields using the format `custom###`, where \"###\" is the custom field’s **`id`**.\n\nFor example, to provide a filter that would match location names containing the word \"gourmet\", the filter parameter would be `[{\"name\":{\"contains\":[\"gourmet\"]}}]`, which URL-encoded would be `%5B%7B%22name%22%3A%7B%22contains%22%3A%5B%22gourmet%22%5D%7D%7D%5D`.\n\nNOTE: \"x\", \"xx\", and \"xxx\" are reserved keywords that, when passed in a `contains` matcher for a Full or Text filter, will cause that filter to match on all locations.\n\nThe filter types are the following. Note there may be multiple available specifications for a given filter type:\n\n\n \n | Filter Type | \n Syntax | \n Description | \n
\n \n | Full | \n fieldName: {contains: $search} | \n $search is the search string | \n
\n \n | Text | \n fieldName: {$type: [$search,...]} | \n $type is one of [contains,doesNotContain,startsWith,equalTo], $search is an array of search strings, combined with OR | \n
\n \n | Text | \n fieldName: $type | \n $type is one of [empty,notEmpty] | \n
\n \n | Number | \n fieldName: {$type: $value} | \n $type is one of [eq,lt,gt,le,ge], $value is the numeric value | \n
\n \n | Number | \n fieldName: {$type: [$value1, $value2]} | \n $type is one of [between], $value1 and $value2 are numeric values | \n
\n \n | Date | \n fieldName: {$type: $value} | \n $type is one of [eq,lt,gt,le,ge], $value is a string of \"YYYY-MM-DD\" formatted date | \n
\n \n | Date | \n fieldName: $type | \n $type is one of [empty,notEmpty] | \n
\n \n | Date | \n fieldName: {$type: [$value1, $value2]} | \n $type is one of [between], $value1 and $value2 are strings of \"YYYY-MM-DD\" formatted date | \n
\n \n | Categories | \n fieldName: {$type: [$id,...]} | \n $type is one of [includes,notIncludes], $id is an array of numeric category IDs, combined with OR | \n
\n \n | Categories | \n fieldName: $type | \n $type is one of [none] | \n
\n \n | Assets | \n fieldName: {$type: [$id,...]} | \n $type is one of [includes,notIncludes], $id is an array of numeric category IDs, combined with OR | \n
\n \n | Assets | \n fieldName: $type | \n $type is one of [none] | \n
\n \n | Country | \n fieldName: {$type: [$country,...]} | \n $type is one of [includes,notIncludes], $country is an array of country code strings, combined with OR | \n
\n \n | PrimaryLanguage | \n fieldName: {$type: [$language,...]} | \n $type is one of [is,isNot], $language is an array of language code strings, combined with OR | \n
\n \n | AlternateLanguage | \n fieldName: {$type: [$language,...]} | \n $type is one of [includes, notIncludes], $language is an array of language code strings, combined with OR | \n
\n \n | StringSingle | \n fieldName: {$type: [$string,...]} | \n $type is one of [is,isNot], $string is an array of strings, combined with OR | \n
\n \n | StringList | \n fieldName: {$type: [$string,...]} | \n $type is one of [includes,notIncludes], $string is an array of strings, combined with OR | \n
\n \n | LocationType | \n fieldName: {$type: [$id,...]} | \n $type is one of [is,isNot], $id is an array of location type IDs, combined with OR | \n
\n \n | Bool | \n fieldName: $type | \n $type is one of [true,false] | \n
\n \n | Option | \n fieldName: {$type: $id} | \n $type is one of [is,isNot], $id is an option ID (For single option custom fields) | \n
\n \n | Option | \n fieldName: {$type: [$id,...]} | \n $type is one of [includes,notIncludes], $id is an array of option IDs, combined with OR (For multi option custom fields) | \n
\n \n | Folder | \n fieldName: [$id,...] | \n $id is a numeric folder ID | \n
\n \n | Folder | \n fieldName: $id | \n $id is a numeric folder ID | \n
\n \n | Folder | \n fieldName: {$type: [$id,...]} | \n $id is a numeric folder ID, $type is one of ['isIn', 'isNotIn'] | \n
\n \n | Labels | \n fieldName: {$type: [$id,...]} | \n $type is one of [includes,notIncludes], $id is an array of label IDs, combined with OR | \n
\n
\n\nThe following fields can be specified in the request (Field name/Filter Type/Example(s)):\n\n\n \n | Field Name | \n Filter Type | \n Example(s) | \n
\n \n | location | \n Full | \n \"location\": {\"contains\": \"Atlanta\"} | \n
\n \n | name | \n Text | \n \"name\": {\"startsWith\": [\"Guitar\"]}, \"name\": {\"contains\": [\"A\",\"B\"]} | \n
\n \n | address | \n Text | \n \"address\": {\"startsWith\": [\"South\"]} | \n
\n \n | address2 | \n Text | \n \"address2\": {\"contains\": [\"Suite\"]} | \n
\n \n | city | \n Text | \n \"city\": {\"contains\": [\"Atlanta\"]} | \n
\n \n | state | \n Text | \n \"state\": {\"contains\": [\"AK\",\"VA\"]} | \n
\n \n | zip | \n Text | \n \"zip\": {\"contains\": [\"M5K 7QB\"]} | \n
\n \n | phones | \n Text | \n \"phones\": {\"startsWith\": [\"703\",\"571\"]} | \n
\n \n | specialOffer | \n Text | \n \"specialOffer\": \"notEmpty\" | \n
\n \n | emails | \n Text | \n \"emails\": {\"doesNotContain\": [\"@yext.com\"]} | \n
\n \n | website | \n Text | \n \"website\": {\"equalTo\": [\"https://www.yext.com/\"]} | \n
\n \n | categories | \n Categories | \n \"categories\": {\"includes\": [23,755,34]} | \n
\n \n | closed | \n Bool | \n \"closed\": true | \n
\n \n | storeId | \n Text | \n \"storeId\": {\"equalTo\": [\"MCD0001\"]} | \n
\n \n | countryCode | \n Country | \n \"countryCode\": {\"notIncludes\": [\"US\"]} | \n
\n \n | products | \n Text | \n \"products\": {\"startsWith\": [\"Burger\",\"Fries\"]} | \n
\n \n | services | \n Text | \n \"services\": {\"contains\": [\"Manicures\"]} | \n
\n \n | specialities | \n Text | \n \"services\": \"notEmpty\" | \n
\n \n | associations | \n Text | \n \"associations\": \"empty\" | \n
\n \n | brands | \n Text | \n \"brands\": {\"equalTo\": [\"North Face\"]} | \n
\n \n | languages | \n Text | \n \"languages\": {\"equalTo\": [\"English\",\"Spanish\"]} | \n
\n \n | keywords | \n Text | \n \"keywords\": {\"startsWith\": [\"Franchise\"]} | \n
\n \n | menuIds | \n IdList | \n \"menuIds\": {\"includes\": [\"m-23\",\"755\",\"menu34\"]} | \n
\n \n | productListIds | \n IdList | \n \"productListIds\": {\"notIncludes\": [\"pl-2\"]} | \n
\n \n | calendarIds | \n IdList | \n \"calendarIds\": {\"notIncludes\": [\"cal34\"]} | \n
\n \n | bioIds | \n IdList | \n \"bioIds\": {\"includes\": [\"b23\",\"34\"]} | \n
\n \n | custom### | \n Text (for Multiline Text, URL, Text List, and Text Custom Fields), Number, Date, Bool, or Option | \n \"custom123\": {\"equalTo\": [\"asdf\"]} | \n
\n \n | folder | \n Folder | \n \"folder\": 123, \"folder\": [123,456] | \n
\n \n | primary_language | \n PrimaryLanguage | \n \"primary_language\": {\"is\": \"fr_CA\"} | \n
\n \n | alternateProfileLanguage | \n AlternateLanguage | \n \"alternateProfileLanguage\": {\"includes\": [\"en\", \"fr\"]} | \n
\n \n | npi | \n StringSingle | \n \"npi\": {\"is\": [\"1234567890\", \"1111111111\"]} | \n
\n \n | conditionsTreated | \n Text | \n \"conditionsTreated\": {\"startsWith\": [\"Influenza\"]}, \"conditionsTreated\": {\"contains\": [\"A\",\"B\"]} | \n
\n \n | lastUpdated | \n Date | \n \"lastUpdated\": {\"eq\": \"2018-01-01\"}, \"lastUpdated\": {\"between\": [\"2017-01-01\", \"2018-01-01\"]} | \n
\n \n | fieldsWithData | \n Fields | \n \"fieldsWithData\": [\"email\", \"hours\"] | \n
\n \n | fieldsWithoutData | \n Fields | \n \"fieldsWithoutData\": [\"logo\", \"video\"] | \n
\n \n | reviewCount | \n Number | \n \"review_count\": {\"gt\": 1}, \"review_count \": {\"lt\": 10} | \n
\n \n | averageRating | \n Number | \n \"averageRating\": {\"lt\": 3} | \n
\n \n | locationType | \n LocationType | \n \"locationType\": {\"is\": [1]}, \"locationType\": {\"isNot\": [123]} | \n
\n \n | gender | \n StringSingle | \n \"gender\": {\"is\": [\"FEMALE\"]}, \"gender\": {\"isNot\": [\"MALE\"]} | \n
\n \n | degrees | \n StringList | \n \"degrees\": {\"includes\": [\"MD\"]}, \"degrees\": {\"notIncludes\": [\"PHD\"]} | \n
\n \n | experiences | \n StringList | \n \"experiences\": {\"includes\": [\"FELLOWSHIP\"]}, \"experiences\": {\"notIncludes\":[\"INTERNSHIP\"]} | \n
\n \n | yearCompleted | \n Number | \n \"yearCompleted\": {\"gt\": 2000}, \"yearCompleted\": {\"lt\": 2015} | \n
\n \n | acceptingNewPatients | \n Bool | \n \"acceptingNewPatients\": true | \n
\n \n | firstName | \n Text | \n \"firstName\": {\"startsWith\": [\"David\"]}, \"firstName\": {\"contains\": [\"A\",\"B\"]} | \n
\n \n | middleName | \n Text | \n \"middleName\": {\"startsWith\": [\"P\"]}, \"middleName\": {\"contains\": [\"N\",\"E\"]} | \n
\n \n | lastName | \n Text | \n \"lastName\": {\"startsWith\": [\"Sm\"]}, \"lastName\": {\"contains\": [\"Y\",\"Z\"]} | \n
\n \n | officeName | \n Text | \n \"officeName\": {\"startsWith\": [\"Chiropractic\"]}, \"officeName\": {\"contains\":[\"Center\",\"P\"]} | \n
\n \n | certifications | \n Text | \n \"certifications\": {\"contains\": [\"Radiation Oncology\"]} | \n
\n \n | institutionName | \n Text | \n \"institutionName\": {\"startsWith\": [\"New York\"]} | \n
\n \n | insuranceAccepted | \n Text | \n \"insuranceAccepted\": {\"startsWith\": [\"United\"]}, \"insuranceAccepted\":{\"contains\": [\"C\",\"Health\"]} | \n
\n \n | admittingHospitals | \n Text | \n \"admittingHospitals\": {\"startsWith\": [\"Children's\"]}, \"admittingHospitals\":{\"contains\": [\"Medical\",\"University\"]} | \n
\n \n | subscriptions | \n IdList | \n \"subscriptions\": {\"notIncludes\": [\"123\"]} | \n
\n \n | facebookAccounts | \n IdList | \n \"facebookAccounts\": {\"notIncludes\": [\"1111\"]} | \n
\n \n | foursquareAccounts | \n IdList | \n \"foursquareAccounts\": {\"notIncludes\": [\"1111\"]} | \n
\n \n | googleplusAccounts | \n IdList | \n \"googleplusAccounts\": {\"notIncludes\": [\"1111\"]} | \n
\n \n | labels | \n Labels | \n \"labels\": {\"includes\": [1, 100]} | \n
\n
\n"
},
{
"name": "v",
"value": "",
"type": "query",
"description": "A date in `YYYYMMDD` format."
},
{
"name": "sortBy",
"value": "",
"type": "query",
"description": "Specifies the fields and direction by which the output should be sorted. Should be provided as a URL-encoded string containing a JSON array of `sortDefinition` objects. A `sortDefinition` object consists of a `sortField` and a `sortDirection` field. The `sortField` is the name of the field you are sorting by (e.g., `firstName` or `custom###` for a custom field, where \"###\" is the custom field’s **`id`**). The `sortDirection` indicates whether the sort is ascending (`ASCENDING`) or descending (`DESCENDING`).\n\nFor example, to sort by last name ascending and first name descending, this parameter would be `[{\"sortField\":\"lastName\",\"sortDirection\":\"ASCENDING\"},{\"sortField\":\"firstName\", \"sortDirection\":\"DESCENDING\"}]`, which, when URL-encoded, would be `%5B%7B%22sortField%22%3A%22lastName%22%2C%22sortDirection%22%3A%22ASCENDING%22%7D%2C%7B%22sortField%22%3A%22firstName%22%2C%22sortDirection%22%3A%22DESCENDING%22%7D%5D`.\n\n**NOTE:** Currently, we support sorting by **`firstName`**, **`lastName`**, and text custom fields.\n"
}
]
},
"docs": "Gets multiple Locations (primary profile only) near a given location, ordered by proximity to the location (if no other sort criteria are given) and restricted to a radius. Searches through all language profiles, including the primary profile.\n\n**NOTE:** Responses will contain resolved values for embedded fields\n"
},
{
"info": {
"name": "Question: Create\n",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.yextapis.com/v2/accounts/:accountId/createQuestion",
"params": [
{
"name": "accountId",
"value": "",
"type": "path"
},
{
"name": "v",
"value": "",
"type": "query",
"description": "A date in `YYYYMMDD` format."
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Create a new Question."
},
{
"info": {
"name": "Review: Create\n",
"type": "http"
},
"http": {
"method": "POST",
"url": "https://api.yextapis.com/v2/accounts/:accountId/reviewSubmission",
"params": [
{
"name": "accountId",
"value": "",
"type": "path"
},
{
"name": "v",
"value": "",
"type": "query",
"description": "A date in `YYYYMMDD` format."
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Create a new Review."
},
{
"info": {
"name": "Review: Update\n",
"type": "http"
},
"http": {
"method": "PUT",
"url": "https://api.yextapis.com/v2/accounts/:accountId/reviewSubmission/:apiIdentifier",
"params": [
{
"name": "accountId",
"value": "",
"type": "path"
},
{
"name": "v",
"value": "",
"type": "query",
"description": "A date in `YYYYMMDD` format."
},
{
"name": "apiIdentifier",
"value": "",
"type": "path",
"description": "The unique identifier of this review.\n\nOne of:\n* A UUID generated at the time the Review Creation request is accepted.\n* The invitationUid, if the review is associated with an invitation.\n\nThis ID will be returned in the response to any requests to the Review: Create Live API\nendpoint.\n\nThis ID will also be included in the Reviews Webhook, and the Review: Get/List Knowledge API\nendpoints.\n"
}
],
"body": {
"type": "json",
"data": "{}"
}
},
"docs": "Update a Review."
},
{
"info": {
"name": "Review: Delete\n",
"type": "http"
},
"http": {
"method": "DELETE",
"url": "https://api.yextapis.com/v2/accounts/:accountId/reviewSubmission/:apiIdentifier",
"params": [
{
"name": "accountId",
"value": "",
"type": "path"
},
{
"name": "v",
"value": "",
"type": "query",
"description": "A date in `YYYYMMDD` format."
},
{
"name": "apiIdentifier",
"value": "",
"type": "path",
"description": "The unique identifier of this review.\n\nOne of:\n* A UUID generated at the time the Review Creation request is accepted.\n* The invitationUid, if the review is associated with an invitation.\n\nThis ID will be returned in the response to any requests to the Review: Create Live API\nendpoint.\n\nThis ID will also be included in the Reviews Webhook, and the Review: Get/List Knowledge API\nendpoints.\n"
}
]
},
"docs": "Delete a Review."
}
]
}
],
"bundled": true
}