Enhance your application with Uberall's comprehensive API documentation
Uberall API (20250708)
https://uberall.com/api/
https://docs.uberall.com/_mock/apis/swagger/
https://uberall.com/api/locations/directories
- Mock Server
https://docs.uberall.com/_mock/apis/swagger/locations/directories
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
https://uberall.com/api/locations/directories \
-H 'X-API-KEY: YOUR_API_KEY_HERE'
No content
https://uberall.com/api/locations/{id}
- Mock Server
https://docs.uberall.com/_mock/apis/swagger/locations/{id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X GET \
'https://uberall.com/api/locations/{id}' \
-H 'X-API-KEY: YOUR_API_KEY_HERE'
{ "status": "SUCCESS", "message": "string", "warnings": [ "string" ], "response": { "location": { … }, "suggestionsForFields": [ … ], "suggestionsForFieldsAvailable": true } }
Location object
The location's opening hours: e.g.
[ { "dayOfWeek": 1, "closed": false, "from1": "08:00", "to1": "11:00" }, { "dayOfWeek": 2, "closed": false, "from1": "08:00", "to1": "11:00", "from2": "13:00", "to2": "21:00" }, { "dayOfWeek": 3, "closed": true } ]
Please note that having more than 2 time periods for each day is not possible.
The location's special opening hours: e.g.
[ { "date": "2017-06-29", "closed": true }, { "date": "2017-06-30", "from1": "11:00", "to1": "14:00", "from2": 16:00", "to2": "20:00" } ]
Please note that having more than 2 time periods for each day is not possible.
Required for Spain. One of ALAMEDA, AVENIDA, CALLE, CAMINO, CARRER, CARRETERA, GLORIETA, KALEA, PASAJE, PASEO, PLACA, PLAZA, RAMBLA, RONDA, RUA, SECTOR, TRAVESERA, TRAVESIA, URBANIZACION
A short description - up to 200 characters, all characters must match this regexp:
[0-9\p'{'L'}'()[] ?:;/!\,.-%\&=\r\n\t_*§²`´·"'+¡¿@°€£$]
A long description - up to 1000 characters, all characters must match this regexp:
[0-9\p'{'L'}'()[] ?:;/!\,.-%\&=\r\n\t_*§²³`´·"'+¡¿@°€^£$]
Additional info about opening hours: e.g. 'We never open on bank holidays' - max. 255 characters, all characters must match this regexp:
[0-9\p'{'L'}'()[] ?:;/!\,.-%\&\r\n\t_*§²`´·"'+¡¿@]
Labels grouping similar locations
The payment options accepted at the location (eg. cash, bank transfer, ...)
The language(s) in which customers can interact with the location's staff
Required to start location sync - A list of category IDs describing the location
The status of the location. One of:
- ACTIVE - will be synced and renewed
- INACTIVE - will not be synced anymore, claims of listings will be released where possible
- CANCELLED - will be synced, will not be renewed. Once endDate is reached, location will switch to INACTIVE
- CLOSED - location has shut down, we'll mark listings as permanently closed or remove listings from the internet where permanently closed status is not supported
Output only. Date of the last changes made to the location. Includes updates by users, API, location cleansing, and duplicate checks
When autosync is set to true, information changed for the location in Uberall will automatically be syncronized to all connected listings without the need to explicitly start a sync again after it's been started once.
Add call tracking numbers for distribution to Google, Facebook, and Bing. The call tracking numbers must be different from the location's primary phone number
UTM parameter to be appended to the location's website. Codes can be sent to Google, Facebook, and Bing.
Links that appear on some directories for specific types of customer actions, such as food ordering, appointment setting, and booking reservations. Only available for specific business categories.
Set a location to temporarily closed with the ability to set a re-open date. Temporarily closed is best used if a location will be closed for more than seven days. If less than seven days, use special hours to show the location is closed.
Output only. List of features available to the location
A description of the EV Charging station's location. Used to help customers find the station more easily
An addition to the location's name which gives specific info about the location's address (e.g. Mall level 2 OR Inside Departures). Sent only to FACEBOOK
The content list IDs (EVENTS, PRODUCTS, MENU, PEOPLE) describing the location
Output only. Compile all the fields that are currently missing but mandatory for some directories. They have to be set in the Location object, so that the Listing can be created / updated on the respective platform. List of Strings, e.g. [NAME, ZIP, PHONE]
The profiles of the location on social and professional networks (FACEBOOK, FOURSQUARE, INSTAGRAM, LINKEDIN, PINTEREST, TWITTER, VIMEO, XING, YOUTUBE)
Cleansing comment by user, set only when cleansingStatus is INVALID_DATA. Possible Values (ADDRESS_DETAILS_VERIFIED, NAME_ADDRESS_DETAILS_UPDATED, NON_CLOSURE_CONFIRMATION,)
The location's additional service hours, such as delivery, pickup, happy hours etc. Submitted to Google. e.g.
[{ "type": "ONLINE_SERVICE_HOURS", "hours": [{ "dayOfWeek": 1, "from1": "09:00", "to1": "18:00" }, { "dayOfWeek": 2, "from1": "09:00", "to1": "13:00" }] }, { "type": "ACCESS", "hours": [{ "dayOfWeek": 1, "from1": "06:00", "to1": "20:00" }] }]
A Map for identifying the value input for a specific custom field name on the location. Custom fields are created at the business level.
"customFields": [ '{' "name": "foo", "value": "bar" '}', '{' "name": "baz", "value": "qux" '}' ]
Output only. Number representing completeness of location data, up to 100
Output only. Number of dataPoints (reviews, photos) left by users at this location
Output only. Current cleansing status for the location. Possible values: NOT_CLEANSED, PENDING, CLEANSED, INVALID_DATA
Output only. Invalid Cleansing Reason (eg. INCOMPLETE_ADDRESS,ADDRESS_ IS_PO_BOX,ADDRESS_ DOES_NOT_EXIST, LOCATION_IS_CLOSED, INFORMATION_IS_WRONG, LOCATION_IS_MOVED, NON_LATIN_CHARACTERS_ADDRESS, OTHER). Guide on how to fix invalid data issues - http://ubr.al/fix_invalid_data
ID of the business this location is linked to. Mandatory when creating a location. Sending a different ID than the current businessId when updating will lead to changing the business. This is only possible in case all connected accounts (Facebook, Google, …) are compatible.
Services offered at the location. Do not use if Content Collections is enabled. Instead use the Service Item and Collection endpoints
https://uberall.com/api/locations/{id}
- Mock Server
https://docs.uberall.com/_mock/apis/swagger/locations/{id}
- curl
- JavaScript
- Node.js
- Python
- Java
- C#
- PHP
- Go
- Ruby
- R
- Payload
curl -i -X PATCH \
'https://uberall.com/api/locations/{id}' \
-H 'Content-Type: application/json' \
-H 'X-API-KEY: YOUR_API_KEY_HERE' \
-d '{
"id": 0,
"openingHours": [
{
"dayOfWeek": 1,
"closed": false,
"from1": "08:00",
"to1": "11:00"
},
{
"dayOfWeek": 2,
"closed": false,
"from1": "08:00",
"to1": "11:00",
"from2": "13:00",
"to2": "21:00"
},
{
"dayOfWeek": 3,
"closed": true
}
],
"specialOpeningHours": [
{
"date": "2017-06-29",
"closed": true
},
{
"date": "2017-06-30",
"from1": "11:00",
"to1": "14:00",
"from2": "16:00",
"to2": "20:00"
}
],
"name": "string",
"street": "string",
"streetNo": "string",
"streetType": "ALAMEDA",
"addressExtra": "building, floor, ...",
"zip": "string",
"city": "string",
"province": "string",
"country": "AF",
"lat": 0.1,
"lng": 0.1,
"addressDisplay": true,
"normalizationStatus": "NOT_NORMALIZED",
"phone": "string",
"fax": "string",
"cellphone": "string",
"website": "string",
"email": "string",
"legalIdent": "string",
"taxNumber": "string",
"emailVerification": "UNVERIFIED",
"descriptionShort": "string",
"descriptionLong": "string",
"imprint": "string",
"openingHoursNotes": "We never open on bank holidays",
"keywords": [
"string"
],
"labels": "['\''Campaign2018'\'', '\''EastCoast'\'']",
"brands": [
"string"
],
"paymentOptions": [
"cash",
"credit card",
"invoice"
],
"languages": [
"string"
],
"categories": [
0
],
"status": "CREATED",
"lastSyncStarted": "2019-08-24T14:15:22Z",
"identifier": "string",
"photos": [
{
"description": "string",
"sourceUrl": "string",
"identifier": "string",
"cropOffsetX": 0,
"cropOffsetY": 0,
"cropWidth": 0,
"cropHeight": 0,
"type": "MAIN",
"order": 0,
"dateCreated": "2019-08-24T14:15:22Z",
"lastUpdated": "2019-08-24T14:15:22Z",
"photo": "string",
"locationId": 0
}
],
"endDate": "2019-08-24T14:15:22Z",
"dateCreated": "2019-08-24T14:15:22Z",
"lastUpdated": "2019-08-24T14:15:22Z",
"autoSync": true,
"timezone": "string",
"openingDate": "2019-08-24",
"serviceAreas": [
{
"name": "Berlin, Deutschland",
"placeId": "ChIJAVkDPzdOqEcRcDteW0YgIQQ"
}
],
"callTrackingNumbers": [
{
"number": "string",
"type": "FOURSQUARE"
}
],
"utms": [
{
"parameters": "string",
"type": "FOURSQUARE"
}
],
"transactionLinks": [
{
"directoryType": "FOURSQUARE",
"url": "string",
"type": "APPOINTMENT",
"appStoreUrl": "string",
"isPreferred": true
}
],
"actionLinks": [
{
"directoryType": "FOURSQUARE",
"url": "string",
"type": "APPOINTMENT",
"appStoreUrl": "string",
"isPreferred": true
}
],
"temporarilyClosed": {
"temporarilyClosed": true,
"reopenDate": "string"
},
"features": [
"NEW_PHOTO_TYPES"
],
"needsReview": [
{
"description": "string",
"field": "NAME",
"type": "CANNOT_START_SYNC",
"id": 0
}
],
"evData": {
"type": "ON_STREET",
"owner": "string",
"operator": "string",
"subOperator": "string",
"timezone": "string",
"isChargingClosed": true,
"updateTime": "2019-08-24T14:15:22Z",
"supplyEquipments": [
{
"uid": "string",
"evseId": "string",
"physicalReference": "string",
"updateTime": "2019-08-24T14:15:22Z",
"connectors": [
{
"identifier": "string",
"standard": "CHADEMO",
"format": "CABLE",
"powerType": "AC_1_PHASE",
"voltage": 0,
"amperage": 0,
"updateTime": "2019-08-24T14:15:22Z"
}
],
"parkingRestrictions": [
"CUSTOMERS"
]
}
]
},
"doctorComData": {
"npi": "string",
"hospitals": [
{
"hospitalName": "string",
"hospitalCity": "string",
"hospitalState": "string"
}
],
"educations": [
{
"educationName": "string",
"educationType": "string",
"startedYear": 0,
"graduationYear": 0
}
],
"insurances": [
{
"companyName": "string",
"insurancePlan": "string"
}
],
"credentials": "string",
"university": "string",
"hospitalAffiliations": "string",
"insurancesAccepted": "string",
"isProvider": true,
"practiceName": "string",
"providerTitle": "string",
"providerFirstname": "string",
"providerMiddlename": "string",
"providerSurname": "string",
"doctorCategories": [
0
]
},
"socialPostId": 0,
"businessName": "string",
"nameDescriptor": "string",
"contentLists": [
0
],
"missingMandatoryFields": [
"NAME"
],
"mainPhoto": {
"description": "string",
"sourceUrl": "string",
"identifier": "string",
"cropOffsetX": 0,
"cropOffsetY": 0,
"cropWidth": 0,
"cropHeight": 0,
"type": "MAIN",
"order": 0,
"dateCreated": "2019-08-24T14:15:22Z",
"lastUpdated": "2019-08-24T14:15:22Z",
"photo": "string",
"locationId": 0
},
"socialProfiles": [
{
"url": "string",
"type": "FACEBOOK"
}
],
"linkedToLocationGroups": [
{
"id": 0,
"lastUpdated": "2019-08-24T14:15:22Z",
"name": "string",
"status": "ACTIVE",
"users": [
{
"id": 1,
"email": "jan.didschuneit@uberall.com",
"firstName": "Jan",
"lastName": "Didschuneit",
"role": "ADMIN",
"status": "VERIFIED"
}
],
"creator": 0,
"salesPartner": 0,
"locationsCount": 0,
"locations": [
{
"id": 1,
"name": "Location 1",
"status": "ACTIVE"
}
]
}
],
"cleansingComment": "ADDRESS_DETAILS_VERIFIED",
"moreHours": [
{
"type": {
"id": 0
},
"hours": [
{
"dayOfWeek": 1,
"from": "08:00",
"to": "18:00"
}
]
}
],
"publishedListingsCount": 0,
"locationNeedsReview": [
{
"description": "string",
"field": "NAME",
"type": "CANNOT_START_SYNC",
"id": 0
}
],
"locationSyncable": true,
"customFields": [
{
"name": "foo",
"value": "bar"
}
],
"averageRating": 0.1,
"videos": [
{
"id": 0,
"url": "string",
"description": "string",
"type": "YOUTUBE"
}
],
"skipFacebookPicturesUpdate": true,
"businessCountry": "AF",
"profileCompleteness": 0,
"businessSyncable": true,
"dataPoints": 0,
"listingsBeingUpdated": 0,
"activeListingsCount": 0,
"activeDirectoriesCount": 0,
"cleansingStatus": "NOT_CLEANSED",
"cleansingInvalidDataReason": "string",
"directoriesMissingConnect": [
"FOURSQUARE"
],
"listingsInSync": 0,
"suggestionsForFieldsAvailable": true,
"businessType": "SMB",
"contentCollections": {
"id": 0,
"identifier": "string",
"name": "string",
"description": "string",
"type": "MENU",
"contentLists": [
{
"id": 0,
"title": "Lunch Menu",
"type": "MENU",
"description": "string",
"translations": {
"hu": {
"title": "Magyar"
},
"fr": {
"title": "Titre Français"
}
},
"items": [
{
"title": "string",
"description": "string",
"identifier": "string",
"listName": "string",
"id": 0,
"price": 0,
"currency": "EUR",
"category": "Starters, Drinks, Desert, etc.",
"image": {
"id": 0,
"url": "string",
"type": "LOGO",
"description": "string",
"uid": "string"
},
"url": "string",
"priceMax": 0,
"caloriesLow": 0,
"caloriesHigh": 0,
"allergens": "Eggs, Dairy, Wheat, etc.",
"dietaryRestrictions": "Vegetarian, Halal, etc."
}
]
}
],
"locationIds": [
0
],
"isReadOnly": false,
"cuisineType": "AMERICAN",
"url": "string"
},
"directoriesPublishingStatus": [
"string"
],
"businessId": 1234,
"attributes": [
{
"externalId": "string",
"value": "string",
"displayName": "string",
"groupDisplayName": "string",
"valueMetadata": [
{
"value": "string",
"displayName": "string"
}
],
"valueType": "BOOL, URL, ENUM, REPEATED_ENUM"
}
],
"services": [
{
"title": "string",
"description": "string",
"identifier": "string",
"listName": "string",
"price": 0,
"currency": {},
"googleService": "string",
"category": 0,
"country": "string"
}
],
"visibilityIndex": 0
}'
{ "status": "SUCCESS", "message": "string", "warnings": [ "string" ], "response": { "location": { … } } }
Social PostingCopy for LLM Copy page as Markdown for LLMs View as Markdown Open this page as Markdown Open in ChatGPT Get insights from ChatGPT Open in Claude Get insights from Claude
Products - Social Posting