uberall

uberall API Endpoints

Before diving into the endpoints below, its generally useful to read our Overview to understand high-level concepts and use cases.

Base URLs

  • https://uberall.com/api/ - base url for the live system
  • https://sandbox.uberall.com/api/ - base url for the sandbox environment ( testing purposes )

Auto Response

GET /api/auto-response/rules List Auto Response Rules with filters
POST /api/auto-response/rules Create an Auto Response Rule
GET /api/auto-response/rules/$id Get an Auto Response Rule
PATCH /api/auto-response/rules/$id Edit an Auto Response Rule
DELETE /api/auto-response/rules/$id Delete an Auto Response Rule
POST /api/auto-response/rules/check-conflict Check for Auto Response Rule conflicts
GET
/api/auto-response/rules
https://uberall.com/api/auto-response/rules
List Auto Response Rules with filters
List Auto Response Rules with filters
Query Parameters
businesses
Only return Auto Response Rules identified by the business ids listed in businesses
direction
Direction to sort the results in, use asc for ascending sort or desc for descending sort
excludedLocations
List of location ids that should be excluded from the result
locations
Only return Auto Response Rules identified by the location ids listed in locations
page
Used for pagination. Default: 0
size
Used for pagination. Default: 10
sort
Field to sort the results in, use created_by, date_created or id
POST
/api/auto-response/rules
https://uberall.com/api/auto-response/rules
Create an Auto Response Rule
Create an Auto Response Rule
Body Parameters
businesses
Required - Identify this Auto Response Rule with a list of business ids
String
excludedLocations
Required - Exclude a list of location ids from this Auto Response Rule
String
locations
Required - Identify this Auto Response Rule with a list of location ids
String
name
Required - Name for this Auto Response Rule, must not be longer than 255 characters
String
responses
Required - Possible responses for this Auto Response Rule. At least 3 non-empty responses must be provided
String
status
Required - Status for this Auto Response Rule, either ACTIVE or INACTIVE if present, default is ACTIVE
String
triggers
Required - Triggers for this Auto Response Rule, use ONE_STAR, TWO_STAR, THREE_STAR, FOUR_STAR and/or FIVE_STAR
String
GET
/api/auto-response/rules/$id
https://uberall.com/api/auto-response/rules/$id
Get an Auto Response Rule
Get an Auto Response Rule
Path parameters
id
id of Auto Response Rule
PATCH
/api/auto-response/rules/$id
https://uberall.com/api/auto-response/rules/$id
Edit an Auto Response Rule
Edit an Auto Response Rule. The current user can edit this rule when they have access to all businesses and locations that identify this rule.
Path parameters
id
id of Auto Response Rule to be edited
Body Parameters
businesses
Required - Identify this Auto Response Rule with a list of business ids
String
excludedLocations
Required - Exclude a list of location ids from this Auto Response Rule
String
locations
Required - Identify this Auto Response Rule with a list of location ids
String
name
Required - Name for this Auto Response Rule, must not be longer than 255 characters
String
responses
Required - Possible responses for this Auto Response Rule. At least 3 non-empty responses must be provided, if this field is edited.
String
status
Required - Status for this Auto Response Rule, either ACTIVE or INACTIVE if present
String
triggers
Required - Triggers for this Auto Response Rule, use ONE_STAR, TWO_STAR, THREE_STAR, FOUR_STAR and/or FIVE_STAR
String
DELETE
/api/auto-response/rules/$id
https://uberall.com/api/auto-response/rules/$id
Delete an Auto Response Rule
Delete an Auto Response Rule. Only rules that can be edited by the current user can be deleted
Path parameters
id
id of the Auto Response Rule to be deleted
POST
/api/auto-response/rules/check-conflict
https://uberall.com/api/auto-response/rules/check-conflict
Check for Auto Response Rule conflicts
Check if there are any other Auto Response Rules that have status ACTIVE, apply to at least one of the businesses or locations in this request, and share at least one of the triggers in this request. When editing an existing Auto Response Rule, its id should be passed in ignoreRule so that it is not returned as a false positive.
Body Parameters
businesses
Required - Only check Auto Response Rules identified by the business ids listed in businesses
String
excludedLocations
Required - List of location ids that should be excluded from the check
String
ignoreRule
Required - When editing an Auto Response Rule, send the id from the rule being edited in this field
String
locations
Required - Only check Auto Response Rules identified by the location ids listed in locations
String
triggers
Required - Only check Auto Response Rules that also apply to these triggers, use ONE_STAR, TWO_STAR, THREE_STAR, FOUR_STAR and/or FIVE_STAR
String

Batch endpoints

GET /api/batch Get all Location Imports
POST /api/batch Creates a new location import
GET /api/batch/$id Get information about a particular location import
POST /api/batch/$id Starts a location import
PATCH /api/batch/$id Send Location Data
GET /api/batch/$id/error-report Get Excel document with Location errors
POST /api/batch/check Get information about an import
GET
/api/batch
https://uberall.com/api/batch
Get all Location Imports
Returns a list of all existing location imports for the current user
Query Parameters
max
Used for pagination. Maximum number of results per page. Default: 10
offset
Offset used for pagination. Default: 0
order
use asc for ascending sort or desc for descending sort
POST
/api/batch
https://uberall.com/api/batch
Creates a new location import
Creates a new location import. Make sure for each location to define their "row" (integer) in the body of your request. The location import has no data associated yet, use PATCH /api/batch/$id to add data to it. After that, the location import can be started with POST /api/batch/$id.
GET
/api/batch/$id
https://uberall.com/api/batch/$id
Get information about a particular location import
Get information about a particular location import
Path parameters
id
The uberall unique id of the location import
POST
/api/batch/$id
https://uberall.com/api/batch/$id
Starts a location import
Starts the location import. All uploaded chunks will be processed. A location import can only be started once.
Path parameters
id
The uberall unique id of the location import
PATCH
/api/batch/$id
https://uberall.com/api/batch/$id
Send Location Data
Uploads location data to a location import
Path parameters
id
Id of the location import
Query Parameters
locations
list of locations that should be created or updated
GET
/api/batch/$id/error-report
https://uberall.com/api/batch/$id/error-report
Get Excel document with Location errors
After a file import, a results report is created with all location failures. This endpoints allows downloading only the locations with errors.
Path parameters
id
The uberall unique id of the location import
POST
/api/batch/check
https://uberall.com/api/batch/check
Get information about an import
Get information about an import (how many locations/businesses would be created/updated)
Query Parameters
locations
list of locations that should be created or updated

Business level connection

POST /api/business-connections/$directoryType/connect/$businessId Connect a business
PUT /api/business-connections/$directoryType/disconnect/$businessId Disconnect a business
GET /api/business-connections/$directoryType/sales-partner/$salesPartnerId/count Count of connections
GET /api/business-connections/$directoryType/sales-partner/$salesPartnerId/list List of business connections
GET /api/business-connections/$directoryType/sales-partner/$salesPartnerId/pages List of external entities
POST
/api/business-connections/$directoryType/connect/$businessId
https://uberall.com/api/business-connections/$directoryType/connect/$businessId
Connect a business
Creates a business connection between the business and the external entity on directory (e.g. brand page for FB)
Path parameters
businessId
The uberall unique id of the business
directoryType
The type of directory
Body Parameters
accountId
Required - Directory account which will be used for establishing connection
String
connectionId
Additional id that represents the connection, E.G brand pages for Facebook
String
PUT
/api/business-connections/$directoryType/disconnect/$businessId
https://uberall.com/api/business-connections/$directoryType/disconnect/$businessId
Disconnect a business
Deletes or disconnects the current business connection
Path parameters
businessId
The uberall unique id of the business
directoryType
The type of directory
Body Parameters
connectionId
Connection id that must be passed for directories like Twitter
String
deep
Boolean flag indicating whether disconnect should remove all created connections originated from business connect (only applies for Facebook)
String
GET
/api/business-connections/$directoryType/sales-partner/$salesPartnerId/count
https://uberall.com/api/business-connections/$directoryType/sales-partner/$salesPartnerId/count
Count of connections
Get number of all business connections created under given salesPartner
Path parameters
directoryType
The type of directory. e.g. facebook
salesPartnerId
ID of the SalesPartner
Query Parameters
name
filters results by performing search with given value
status
Filter by status
GET
/api/business-connections/$directoryType/sales-partner/$salesPartnerId/list
https://uberall.com/api/business-connections/$directoryType/sales-partner/$salesPartnerId/list
List of business connections
Get detailed list of business connections created under given salesPartner
Path parameters
directoryType
Type of directory. e.g. facebook
salesPartnerId
ID of the SalesPartner
Query Parameters
max
Maximum number of items to return
name
filters results by performing search with given value
offset
Offset used for pagination. Default: 0
status
Required - Filter by status
GET
/api/business-connections/$directoryType/sales-partner/$salesPartnerId/pages
https://uberall.com/api/business-connections/$directoryType/sales-partner/$salesPartnerId/pages
List of external entities
Get list of all the external entities on directories that correspond to all connected accounts on given salesPartner (e.g. brand pages list for FB of all the accounts that have been authenticated under sp)
Path parameters
directoryType
Type of directory
salesPartnerId
ID of Sales Partner
Query Parameters
max
Maximum number of items to return
offset
Offset used for pagination. Default: 0

Business Endpoints

GET /api/businesses Get a List of Businesses
POST /api/businesses Create a Business
POST /api/businesses/$businessId/locations/sync Sync All Business's Locations
GET /api/businesses/$id Get a Business
PATCH /api/businesses/$id Update a Business
DELETE /api/businesses/$id Delete a Business
GET /api/businesses/$id/business-connect/facebook/$facebookAccountId/brand-page-list Returns only the Facebook brand pages for the given Facebook account
POST /api/businesses/$id/migrate Migrate the Business to a new SalesPartner
GET /api/businesses/statistics Get Businesses' Statistics
GET
/api/businesses
https://uberall.com/api/businesses
[ Business ,...]
Get a List of Businesses
Get a list of businesses managed by the current user.
Query Parameters
businessIds
Only return businesses identified by ids listed in businessIds
fieldMask
Possible fieldMask options ('id', 'identifier', 'name', 'type', 'streetAndNo', 'addressLine2', 'province', 'zip', 'city','phone', 'country', 'status', 'canSync', 'dateCreated', 'defaultPrice','defaultOriginalPrice', 'defaultPriceSetup', 'productPlan', 'nextProductPlan', 'numOfLocations') eg: fieldMask=type&fieldMask=city
identifier
Only return one business based on your internal identification system
max
Used for pagination. Maximum number of results per page. Default: 10
maxLocations
Only returns businesses with at most maxLocations locations
minLocations
Only return businesses with at least minLocations locations
offset
Offset used for pagination. Default: 0
query
Filter by name
queryFields
uberDoc.resource.api.businesses.GET.queryParam.queryFields.description
sort
The business property to sort by (ascending). One of name, streetAndNo, city, zip, phone
status
Filter by business status. One of ACTIVE, INACTIVE
POST
/api/businesses
https://uberall.com/api/businesses
Create a Business
Create a Business belonging to the SalesPartner of the current User. User needs UserRole ADMIN or ACCOUNT_MANAGER.
Body Parameters
addressLine2
Address extra, e.g. "Suite 123, Third Floor".
String
city
City, where the business is located, e.g. "Berlin".
String
country
Country, where the business is located, e.g. "DE". The country has to be supported by the chosen ProductPlan.
Country
identifier
The business identifier based on your internal identification system, has to be unique inside the SalesPartner. Default value is NULL.
String
name
Required - The name of the business, e.g. "uberall GmbH".
String
phone
Contact phone number, e.g. "+49 (0)30 208 479 320".
String
productPlan
Id of the product plan. Default value is the defaultPlan of the current users SalesPartner.
Integer
province
Province, where the business is located, e.g. "Nordrhein-Westfalen".
String
streetAndNo
Street and street number of the business address, e.g. "Oranienburger Str. 66".
String
type
Business type. One of SMB or ENTERPRISE
Type
zip
Zip code of the business address, e.g. "10117".
String
POST
/api/businesses/$businessId/locations/sync
https://uberall.com/api/businesses/$businessId/locations/sync
Sync All Business's Locations
Start a sync on all directories for all locations in the business with the given id. Current user needs UserRole ADMIN, ACCOUNT_MANAGER or BUSINESS_MANAGER.
Path parameters
businessId
The uberall unique id of the business
GET
/api/businesses/$id
https://uberall.com/api/businesses/$id
Get a Business
Get information about the business with the given id. Current user needs UserRole ADMIN, ACCOUNT_MANAGER or BUSINESS_MANAGER.
Path parameters
id
The uberall unique id for the business
PATCH
/api/businesses/$id
https://uberall.com/api/businesses/$id
Update a Business
Edit information of the business with the given id. Current user needs UserRole ADMIN, ACCOUNT_MANAGER or BUSINESS_MANAGER.
Path parameters
id
The uberall unique id of the business you want to edit
Body Parameters
addressLine2
Address extra, e.g. "Suite 123, Third Floor".
String
city
City, where the business is located, e.g. "Berlin".
String
country
Country, where the business is located, e.g. "DE". The country has to be supported by the chosen ProductPlan.
Country
effectiveDate
Date from when the business changes its product plan for the next ProductPlanID (mandatory : set up the next ProductPlanId simultaneously)
String
identifier
The business identifier based on your internal identification system, has to be unique inside the SalesPartner.
String
name
The name of the business, e.g. "uberall GmbH".
String
phone
Contact phone number, e.g. "+49 (0)30 208 479 320".
String
productPlan
The id of the product plan.
Integer
productPlanId
ID of the next product plan applied for the business on the defined effectiveDate (mandatory : set up the effectiveDate simultaneously)
Integer
province
Province, where the business is located, e.g. "Nordrhein-Westfalen".
String
streetAndNo
Street and street number of the business address, e.g. "Oranienburger Str. 66".
String
type
Business type. One of SMB or ENTERPRISE
Type
zip
Zip code of the business address, e.g. "10117".
String
DELETE
/api/businesses/$id
https://uberall.com/api/businesses/$id
Delete a Business
Delete the business with the given id. Current user needs UserRole ADMIN, ACCOUNT_MANAGER or BUSINESS_MANAGER. Locations within the businesses need to be deleted separately.
Path parameters
id
The uberall unique id for the business you want to the delete
GET
/api/businesses/$id/business-connect/facebook/$facebookAccountId/brand-page-list
https://uberall.com/api/businesses/$id/business-connect/facebook/$facebookAccountId/brand-page-list
Returns only the Facebook brand pages for the given Facebook account
Returns only the Facebook brand pages
Path parameters
facebookAccountId
Unique facebook account id which will be used for locating brand pages
id
Id of the business that will be used for the search
POST
/api/businesses/$id/migrate
https://uberall.com/api/businesses/$id/migrate
Migrate the Business to a new SalesPartner
Migration is only possible from parent sales partner to child sales partner or between children sales partners.
Path parameters
id
The uberall unique id of the business you want to migrate
Query Parameters
targetSalesPartnerId
Required - ID of the sales partner where the business should be migrated
targetWhiteLabelIdentifier
If the target sales partner has more then one whitelabel, please specify which one has to be chosen
GET
/api/businesses/statistics
https://uberall.com/api/businesses/statistics
Get Businesses' Statistics
Get statistics about the businesses the current user is managing: total and breakdown by status

Category Endpoints

GET /api/categories Get All or Several Categories
GET /api/categories/$id/attribute-recommendations Get the recommended attributes for a category
GET /api/categories/$id/attributes Get Attributes for a specific Category
GET /api/categories/$id/available-photo-types Available photo types by business category.
GET /api/categories/$id/google-services Available Google structured services for the location's business category
GET /api/categories/$id/more-hours-types Get the supported More Hours for a specific Category
GET
/api/categories
https://uberall.com/api/categories
Get All or Several Categories
Get a list of all available location categories, or specific location categories based on the following parameters
Query Parameters
categories
The uberall unique id of the category you want to get
language
Required - Show categories in the specified language. One of de, en, es, fr
max
Used for pagination. Maximum number of results per page. Default: 10
offset
Offset used for pagination. Default: 0
q
Filter categories by a search query: e.g. Auto
roots
Set to 'true' to show root categories as well (i.e., show all categories)
GET
/api/categories/$id/attribute-recommendations
https://uberall.com/api/categories/$id/attribute-recommendations
[ String ,...]
Get the recommended attributes for a category
Get all Recommended attributes for the Category, Country excluding (already applied attributes on location/payment related attributes) Notes: - Sent to Google and Apple maps - Only the non payment related attributes available and not applied to the location for the primary category of the location can be selected and setup
Path parameters
id
The Category id
Query Parameters
country
Required - The country to retrieve the attribute recommendations for
keywords
Keywords to look for which are associated with attributes
locationId
Location id to exclude already applied attributes on the provided location
GET
/api/categories/$id/attributes
https://uberall.com/api/categories/$id/attributes
Get Attributes for a specific Category
Get all Attributes for the Category, Country and Language

Notes:
- Sent to Google and Apple maps
- Only the attributes available for the primary category of the location can be selected and setup

Path parameters
id
The Category id
Query Parameters
country
Required - The country to retrieve the attributes for
language
The language to show the attributes in, this affects only the name of the results
GET
/api/categories/$id/available-photo-types
https://uberall.com/api/categories/$id/available-photo-types
[ String ,...]
Available photo types by business category.
Google limits photo types for each business category. GET a list of available photo types for a category.
Path parameters
id
Photo types for the location id
GET
/api/categories/$id/google-services
https://uberall.com/api/categories/$id/google-services
[ Map ,...]
Available Google structured services for the location's business category
GET the list of Google's structured services for a location's business category. Google does not have structured services for all business categories.
Path parameters
id
Category ID for retrieving services
Query Parameters
country
Required - Available structured services vary by country, so a country is needed to provide the available structured services from Google.
language
The language the structured services should be returned in.
GET
/api/categories/$id/more-hours-types
https://uberall.com/api/categories/$id/more-hours-types
[ Map ,...]
Get the supported More Hours for a specific Category
Get all supported More Hours types for a specific Category. Optionally specify language, otherwise default sales partner language is returned
Path parameters
id
The Category id
Query Parameters
language
The language to show the values in, e.g. 'en' or 'de'.

Collections Endpoints

GET /api/collections Get all collections
POST /api/collections Create a collection
GET /api/collections/$id Get a Collection
PATCH /api/collections/$id Update a Collection
GET
/api/collections
https://uberall.com/api/collections
Get all collections
Get all the collections managed by the current API user.
POST
/api/collections
https://uberall.com/api/collections
Create a collection
Create a new collection managed by the current API user. If the user specifies a set of locations for the collections, users managing the whole set of locations can also manage the collection.
Body Parameters
A [ ContentCollection ] object.
GET
/api/collections/$id
https://uberall.com/api/collections/$id
Get a Collection
Retrieve a specific Collection by id
Path parameters
id
The uberall unique id of the Collection to retrieve
PATCH
/api/collections/$id
https://uberall.com/api/collections/$id
Update a Collection
Update a specific Collection by id
Path parameters
id
The uberall unique id of the Collection to update.
Body Parameters
A [ ContentCollection ] object.

Content list Endpoints

GET /api/content-lists Get All Content Lists
POST /api/content-lists Create a Content List
GET /api/content-lists/$id Get a Content List
PATCH /api/content-lists/$id Update a Content List
DELETE /api/content-lists/$id Delete a Content List
GET
/api/content-lists
https://uberall.com/api/content-lists
Get All Content Lists
Get all content lists managed by the current API user
POST
/api/content-lists
https://uberall.com/api/content-lists
Create a Content List
Create a content list
Body Parameters
A [ ContentList ] object.
GET
/api/content-lists/$id
https://uberall.com/api/content-lists/$id
Get a Content List
Get a content list identified by its uberall unique id
Path parameters
id
The uberall unique id of the content list
PATCH
/api/content-lists/$id
https://uberall.com/api/content-lists/$id
Update a Content List
Update a content list
Path parameters
id
The uberall unique id for the content list you want to update
Body Parameters
A [ ContentList ] object.
DELETE
/api/content-lists/$id
https://uberall.com/api/content-lists/$id
Delete a Content List
Delete a content list
Path parameters
id
The uberall unique id of the content list you want to delete

Custom Item Endpoints

GET /api/custom-items Get all Custom Items
POST /api/custom-items Create a Custom Item
PATCH /api/custom-items Update a Custom Item using identifier
DELETE /api/custom-items Delete a Custom Item using identifier
GET /api/custom-items/$id Get a Custom Item
PATCH /api/custom-items/$id Update a Custom Item
DELETE /api/custom-items/$id Delete a Custom Item
GET
/api/custom-items
https://uberall.com/api/custom-items
[ CustomItem ,...]
Get all Custom Items
Get all custom items the current API user can manage.
To specify products with identifier please provide ?identifier= in the url param
By default, 50 are returned, you can use up to max=10000 param
POST
/api/custom-items
https://uberall.com/api/custom-items
Create a Custom Item
Create a custom item. It can be added to a content list later
Body Parameters
A [ CustomItem ] object.
PATCH
/api/custom-items
https://uberall.com/api/custom-items
Update a Custom Item using identifier
Make changes to a custom item, always use ?identifier= in url param to identify the custom item uniquely Any blank parameter deletes an old value, any unspecified parameter does nothing
Body Parameters
A [ CustomItem ] object.
DELETE
/api/custom-items
https://uberall.com/api/custom-items
Delete a Custom Item using identifier
Delete a custom item identified by identifier in the url param
GET
/api/custom-items/$id
https://uberall.com/api/custom-items/$id
Get a Custom Item
Get a single custom item
Path parameters
id
The uberall unique id for the custom item
PATCH
/api/custom-items/$id
https://uberall.com/api/custom-items/$id
Update a Custom Item
Make changes to a custom item. Any blank parameter deletes an old value, any unspecified parameter does nothing
Path parameters
id
The uberall unique id of the custom item you want to update
Body Parameters
A [ CustomItem ] object.
DELETE
/api/custom-items/$id
https://uberall.com/api/custom-items/$id
Delete a Custom Item
Delete a custom item
Path parameters
id
The uberall unique id for the custom item you want to delete

Dashboard Export

GET /api/dashboard-exports Get a list of dashboard exports
POST /api/dashboard-exports Invoke a creation of a dashboard export
GET /api/dashboard-exports/$id Get details of a dashboard export by ID
GET /api/dashboard-exports/$id/download Download the result of a dashboard export (a PDF file)
GET
/api/dashboard-exports
https://uberall.com/api/dashboard-exports
Get a list of dashboard exports
Get a list of dashboard exports.
Query Parameters
locationIds
List of location IDs to filter by
max
Maximum number of items to return
offset
Offset used for pagination. Default: 0
POST
/api/dashboard-exports
https://uberall.com/api/dashboard-exports
Invoke a creation of a dashboard export
Invoke creation of a dashboard export (in PDF format) asynchronously.
Query Parameters
end
Required - End date of export, in yyyy-MM-dd format
group
Required - Grouping of the historical data
language
Required - Language identifier (i.e. 'fr', 'de')
locationIds
Required - List of location IDs
start
Required - Start date of export, in yyyy-MM-dd format
whitelabelIdentifier
Required - Whitelabel identifier string
GET
/api/dashboard-exports/$id
https://uberall.com/api/dashboard-exports/$id
Get details of a dashboard export by ID
Get details of dashboard export by ID.
Path parameters
id
DashboardExportData Id
GET
/api/dashboard-exports/$id/download
https://uberall.com/api/dashboard-exports/$id/download
Download the result of a dashboard export (a PDF file)
Download the result of a dashboard export (a PDF file).
Path parameters
id
DashboardExportData Id

Dashboard

GET /api/dashboard/customer-feedback Get Customer Feedback
GET /api/dashboard/customer-feedback-by-period Get Customer Feedback by Period
GET /api/dashboard/customer-feedback-keywords Get Customer Feedback Keywords.
GET /api/dashboard/export-insights-data Get Insights Export Data
GET /api/dashboard/export-insights-data-with-threshold Get Insights Export Data with threshold
GET /api/dashboard/feed Get Feed
GET /api/dashboard/insights-data Get Insights Data
GET /api/dashboard/insights-data/warnings Get Insights Warnings
GET /api/dashboard/listing-health/$id? Get Listing Health
GET /api/dashboard/managers-count/$id Get Managers Count
GET /api/dashboard/next-best-actions/$id Get Next Best Actions
GET /api/dashboard/profile-completeness Get Profile Completeness
GET /api/dashboard/suppressed-duplicates Get Suppressed Duplicates
GET /api/dashboard/visibility-index/$id Get Visibility Index
GET
/api/dashboard/customer-feedback
https://uberall.com/api/dashboard/customer-feedback
Get Customer Feedback
Get the Customer Feedback of the user managed locations filtered by the given ids
Query Parameters
businessIds
The ids of the businesses you want customer feedback for
endDate
The end date
locationIds
The ids of the locations you want customer feedback for
startDate
The start date
textFilter
Filter locations to get customer feedback for by name, zip, street, city, label: e.g. "Berlin"
type
The directory you want customer feedback data for
GET
/api/dashboard/customer-feedback-by-period
https://uberall.com/api/dashboard/customer-feedback-by-period
Get Customer Feedback by Period
Get the Customer Feedback of the user managed locations filtered by the given ids grouped by period
Query Parameters
businessIds
The ids of the businesses you want customer feedback by perdiod for
endDate
The end date
group
How to group the results, one of: DAY, WEEK, MONTH, YEAR
locationIds
The ids of the locations you want customer feedback by period for
startDate
The start date
textFilter
Filter locations to get customer feedback by period for by name, zip, street, city, label: e.g. "Berlin"
type
The directory you want customer feedback by period for
GET
/api/dashboard/customer-feedback-keywords
https://uberall.com/api/dashboard/customer-feedback-keywords
Get Customer Feedback Keywords.
Returns the 100 most mentioned Keywords and the average Rating of the Reviews where they appeared.
Query Parameters
businessIds
The ids of the businesses you want to analyze the customer feedback for.
endDate
The end date
locationIds
The ids of the locations you want to analyze the customer feedback for.
startDate
The start date
textFilter
Filter locations to analyze the customer feedback for by name, zip, street, city, label: e.g. "Berlin"
GET
/api/dashboard/export-insights-data
https://uberall.com/api/dashboard/export-insights-data
Get Insights Export Data
Get the exported insights data
Query Parameters
businessIds
The ids of the businesses you want to export insights for
endDate
The end date
locationIds
The ids of the locations you want to export insights data for
startDate
The start date
textFilter
Filter locations to export insights for by name, zip, street, city, label: e.g. "Berlin"
GET
/api/dashboard/export-insights-data-with-threshold
https://uberall.com/api/dashboard/export-insights-data-with-threshold
Get Insights Export Data with threshold
Gets all insights data for the locations. When the request takes too much time, the user will receive the link to the file in an email.
Query Parameters
businessIds
Filter export data by these businessIds
endDate
Filter export data until this date
locationIds
Filter export data by these locationIds
startDate
Filter export data from this date
textFilter
Filter export data by this query. It is applied across these location properties: name, street, streetNo, zip, city, country, identifier, labels
GET
/api/dashboard/feed
https://uberall.com/api/dashboard/feed
[ FeedItem ,...]
Get Feed
Get the Feed of latest activities related to the managed locations
Query Parameters
businessIds
The ids of the businesses you want feed for
dateOffset
Returns data up to this date , default is now
locationIds
The ids of the locations you want feed for
maxItems
Maximum number of items to return
textFilter
Filter locations to get feed for by name, zip, street, city, label: e.g. "Berlin"
GET
/api/dashboard/insights-data
https://uberall.com/api/dashboard/insights-data
[ Insights ,...]
Get Insights Data
Get Insights Data
Query Parameters
businessIds
The ids of the businesses you want insights data for
endDate
The end date
group
How to group the results, one of: HOUR (only for ACTIONS_PHONE), DAY, WEEK, MONTH or YEAR
locationIds
The ids of the locations you want insights data for
metrics
The types of metrics you want to get. For Google: QUERIES_DIRECT, QUERIES_INDIRECT, VIEWS_MAPS, VIEWS_SEARCH, ACTIONS_WEBSITE, ACTIONS_PHONE, ACTIONS_DRIVING_DIRECTIONS, PHOTOS_VIEWS_MERCHANT, PHOTOS_VIEWS_CUSTOMERS, LOCAL_POST_VIEWS_SEARCH, LOCAL_POST_ACTIONS_CALL_TO_ACTION / For Facebook: PAGE_IMPRESSIONS, PAGE_CONSUMPTIONS / For Bing: CLICKS_DESKTOP_CORTANA_CALL, CLICKS_DESKTOP_CORTANA_DIRECTIONS, CLICKS_DESKTOP_CORTANA_PHOTOS, CLICKS_DESKTOP_CORTANA_WEBSITE, CLICKS_DESKTOP_MAPS_CALL, CLICKS_DESKTOP_MAPS_DIRECTIONS, CLICKS_DESKTOP_MAPS_PHOTOS, CLICKS_DESKTOP_MAPS_WEBSITE, CLICKS_DESKTOP_SEARCH_PAGE_CALL, CLICKS_DESKTOP_SEARCH_PAGE_DIRECTIONS, CLICKS_DESKTOP_SEARCH_PAGE_PHOTOS, CLICKS_DESKTOP_SEARCH_PAGE_WEBSITE, CLICKS_MOBILE_CORTANA_CALL, CLICKS_MOBILE_CORTANA_DIRECTIONS, CLICKS_MOBILE_CORTANA_PHOTOS, CLICKS_MOBILE_CORTANA_WEBSITE, CLICKS_MOBILE_MAPS_CALL, CLICKS_MOBILE_MAPS_DIRECTIONS, CLICKS_MOBILE_MAPS_PHOTOS, CLICKS_MOBILE_MAPS_WEBSITE, CLICKS_MOBILE_SEARCH_PAGE_CALL, CLICKS_MOBILE_SEARCH_PAGE_DIRECTIONS, CLICKS_MOBILE_SEARCH_PAGE_PHOTOS, CLICKS_MOBILE_SEARCH_PAGE_WEBSITE, IMPRESSIONS_DESKTOP_CORTANA, IMPRESSIONS_DESKTOP_MAPS, IMPRESSIONS_DESKTOP_SEARCH_PAGE, IMPRESSIONS_MOBILE_CORTANA, IMPRESSIONS_MOBILE_MAPS, IMPRESSIONS_MOBILE_SEARCH_PAGE / For Yelp: NUM_CALLS, NUM_DIRECTIONS_AND_MAP_VIEWS, NUM_PAGE_VIEWS, URL_CLICKS
startDate
The start date
textFilter
Filter locations to get insights for by name, zip, street, city, label: e.g. "Berlin"
type
Required. The directory you want insights for. Can be GOOGLE, FACEBOOK, BING or YELP_API
GET
/api/dashboard/insights-data/warnings
https://uberall.com/api/dashboard/insights-data/warnings
Get Insights Warnings
Get the Insights warnings. The list of locations/accounts connected/unconnected, which need a user action to be able collecting insights for.
Query Parameters
businessIds
The ids of the businesses you want insights warnings for
locationIds
The ids of the locations you want insights warnings for
max
Used for pagination. Maximum number of results per page
offset
Offset used for pagination. Default: 0
textFilter
Filter locations to get insights warnings for by name, zip, street, city, label: e.g. "Berlin"
type
The directory you want insights warnings for
GET
/api/dashboard/listing-health/$id?
https://uberall.com/api/dashboard/listing-health/$id?
Get Listing Health
Get the Listing Health for the locations managed by the current user
Path parameters
id
The id of the location you want the listing health for
Query Parameters
businessIds
The ids of the businesses you want listing health for
locationIds
The ids of the locations you want listing health data for
type
The directory you want listing health data for
GET
/api/dashboard/managers-count/$id
https://uberall.com/api/dashboard/managers-count/$id
Get Managers Count
Get the Managers Count
Path parameters
id
The id of the location you want the managers count for
GET
/api/dashboard/next-best-actions/$id
https://uberall.com/api/dashboard/next-best-actions/$id
Get Next Best Actions
Get the Next Best Actions recommended to the current user
Path parameters
id
The id of the location you want the next best actions for
GET
/api/dashboard/profile-completeness
https://uberall.com/api/dashboard/profile-completeness
Get Profile Completeness
Get the profile completeness of the locations managed by the current user
Query Parameters
businessIds
The ids of the businesses you want profile compliteness data for
locationIds
The ids of the locations you want profile completeness data for
GET
/api/dashboard/suppressed-duplicates
https://uberall.com/api/dashboard/suppressed-duplicates
Get Suppressed Duplicates
Get the suppressed duplicates info
Query Parameters
businessIds
The ids of the businesses you want suppressed duplicates data for
endDate
The end date YYYY-MM-DD
locationIds
The ids of the locations you want suppressed duplicates data for
startDate
The start date YYYY-MM-DD
type
The directory you want suppressed duplicates data for
GET
/api/dashboard/visibility-index/$id
https://uberall.com/api/dashboard/visibility-index/$id
Get Visibility Index
Get the Visibility Index of the locations managed by the current user
Path parameters
id
The id of the location you want the visibility index for

Data Point Endpoints

GET /api/data-points Get All Data Points
GET /api/data-points/$id Get a Data Point
POST /api/data-points/$id/flag Report a Data Point
POST /api/data-points/$id/like Like a Data Point
DELETE /api/data-points/$id/like Unlike a Data Point
POST /api/data-points/$id/moderate Moderate a Data Point
PATCH /api/data-points/$id/reply Reply to a Data Point
POST /api/data-points/$id/reply/$replyId/approval Approve reply to a Data Point
PUT /api/data-points/$id/reply/$replyId/approval Edit reply to a Data Point
DELETE /api/data-points/$id/reply/$replyId/approval Reject a reply to a Data Point
GET /api/data-points/filters Get available filters for filtering data points
POST /api/data-points/filters Create a new saved datapoint's filter
GET /api/data-points/filters/$id Get a saved datapoint's filter
PATCH /api/data-points/filters/$id Update a saved datapoint's filter
DELETE /api/data-points/filters/$id Delete a saved datapoint's filter
POST /api/data-points/filters/$id/subscription Subscribe to a saved datapoint's filter
DELETE /api/data-points/filters/$id/subscription Unsubscribe from a saved datapoint's filter
GET /api/data-points/filters/list List all saved datapoint's filters the user has access
POST /api/data-points/read Mark as Read
DELETE /api/data-points/read Mark as Unread
GET /api/data-points/statistics Get Data Points' Statistics
GET /api/data-points/timeseries Get Data Points time series
GET
/api/data-points
https://uberall.com/api/data-points
Get All Data Points
Get all data points, potentially filtered by directory, business, rating...
Query Parameters
businessIds
The ids of the businesses you want data points for
countries
The countries you want data points for. ISO 3166-1 alpha-2 codes
dataPointTypes
The types of data points you want to get: e.g. [PHOTO, REVIEW, CHECKIN]
directoryTypes
The directories you want data points for
labels
Filter by location labels
locationIds
The ids of the locations you want data points for
max
Used for pagination. Maximum number of results per page
maxActionDate
The max date of the DataPoint as unix timestamp in milliseconds, e.g. 1514764800000
maxThreadActionDate
The max date of the last interaction with a DataPoint as unix timestamp in milliseconds, e.g. 1514764800000
minActionDate
The min date of the DataPoint as unix timestamp in milliseconds, e.g. 1514764800000
minThreadActionDate
The min date of the last interaction with a DataPoint as unix timestamp in milliseconds, e.g. 1514764800000
page
The page number for pagination
query
Filter by name
ratings
Only return inbox items with a rating included in ratings
read
Only show read/not read elements
replied
Only show elements you have/you have not replied to
text
Only return data points with text or without (Boolean)
zip
Only return inbox items for locations where zip starts with given parameter
GET
/api/data-points/$id
https://uberall.com/api/data-points/$id
Get a Data Point
Get information about a single Data Point
Path parameters
id
The uberall unique id of the data point you want to get
POST
/api/data-points/$id/flag
https://uberall.com/api/data-points/$id/flag
Report a Data Point
Flag a data point on the directory
Path parameters
id
The uberall unique id of the data point you want to report
Query Parameters
flagType
Required - The flag type supported by the data point's directory. e.g.: [OFFENSIVE, SPAM, NOLONGERRELEVANT, EXTERNAL_URL]
POST
/api/data-points/$id/like
https://uberall.com/api/data-points/$id/like
Like a Data Point
LIke a review (Facebook, Foursquare, ...)
Path parameters
id
The data point id you want to like
DELETE
/api/data-points/$id/like
https://uberall.com/api/data-points/$id/like
Unlike a Data Point
Unlike a review (Facebook, Foursquare, ...)
Path parameters
id
The uberall unique id of the data point you want to unlike
POST
/api/data-points/$id/moderate
https://uberall.com/api/data-points/$id/moderate
Moderate a Data Point
Moderate a Data Point. Only Data Points that belong to a WEBSITE_WIDGETS directory can be moderated.
Path parameters
id
The uberall unique id of the data point you want to moderate
Query Parameters
operation
Required - One of APPROVE or REJECT.
PATCH
/api/data-points/$id/reply
https://uberall.com/api/data-points/$id/reply
Reply to a Data Point
Reply with a text to a Data Point, e.g. a review
Path parameters
id
The uberall unique id of the data point you want to reply to
Query Parameters
reply
Required - The text you want to reply, on most directories this will be published and can be read by the author of the original data point
POST
/api/data-points/$id/reply/$replyId/approval
https://uberall.com/api/data-points/$id/reply/$replyId/approval
Approve reply to a Data Point
Approves a reply to a data point.
Path parameters
id
The id of the root data point.
replyId
The id of the replying data point.
PUT
/api/data-points/$id/reply/$replyId/approval
https://uberall.com/api/data-points/$id/reply/$replyId/approval
Edit reply to a Data Point
Editing an existing reply that needs approval to a Data Point
Path parameters
id
The id of the root data point.
replyId
The id of the replying data point.
replyText
The edited text of the reply.
DELETE
/api/data-points/$id/reply/$replyId/approval
https://uberall.com/api/data-points/$id/reply/$replyId/approval
Reject a reply to a Data Point
Deletes a reply to a data point that needs approval.
Path parameters
id
The id of the root data point.
replyId
The id of the replying data point.
GET
/api/data-points/filters
https://uberall.com/api/data-points/filters
Get available filters for filtering data points
Get available filters for filtering data points, which the current api user has access to.
Query Parameters
locationIds
Applies a filter of locationIds
userId
Shows the filters of the user with this id
POST
/api/data-points/filters
https://uberall.com/api/data-points/filters
Create a new saved datapoint's filter
Creates a new DataPointFilter
Body Parameters
businessIds
List of businessIds to filter the data points by
Set
countries
The list of countries for which the dataPoints should be filtered
Set
dataPointTypes
The list of data point types (REVIEW or PHOTO) for which the dataPoints should be filtered
Set
dateEnd
The maximum date for which the dataPoints should be filtered
DateTime
dateStart
The minimum date for which the dataPoints should be filtered
DateTime
directories
The list of directories for which the dataPoints should be filtered
Set
hasReply
Only include dataPoints you have/you have not replied to
Boolean
hasText
Only include dataPoints which have text
Boolean
isRead
Only include read/not read dataPoints
Boolean
labels
The list of labels for which the dataPoints should be filtered
Set
name
Required - Name of the DataPointFilter
String
query
Any combination of words that should be checked in the dataPoints text, reply messages and author
String
ratings
The list of ratings (1, 2, 3, 4 or 5) for which the dataPoints should be filtered
Set
shared
Defines if the filter is shared or not
Boolean
subscriberIds
The list of businesses IDs for which the dataPoints should be filtered
Set
timeSpan
Predefined time range for filter
DataPointFilterTimeSpan
userId
Required - The user that will be the owner of the filter. Required when request is done as API_ADMIN
Number
GET
/api/data-points/filters/$id
https://uberall.com/api/data-points/filters/$id
Get a saved datapoint's filter
The Uberall locationId
Path parameters
id
ID of a DataPointFilter
Body Parameters
A [ DataPointFilter ] object.
PATCH
/api/data-points/filters/$id
https://uberall.com/api/data-points/filters/$id
Update a saved datapoint's filter
Changes a specific DataPointFilter
Path parameters
id
ID of a DataPointFilter
Body Parameters
A [ DataPointFilter ] object.
DELETE
/api/data-points/filters/$id
https://uberall.com/api/data-points/filters/$id
Delete a saved datapoint's filter
Deletes a specific DataPointFilter
Path parameters
id
ID of a DataPointFilter
Query Parameters
userId
The user that is the owner of the filter. Required when request is done as API_ADMIN
POST
/api/data-points/filters/$id/subscription
https://uberall.com/api/data-points/filters/$id/subscription
Subscribe to a saved datapoint's filter
Subscribe to a specific DataPointFilter
Path parameters
id
ID of a DataPointFilter
Query Parameters
userId
ID of a user that should be subscribed to the filter
DELETE
/api/data-points/filters/$id/subscription
https://uberall.com/api/data-points/filters/$id/subscription
Unsubscribe from a saved datapoint's filter
Unsubscribe from a specific DataPointFilter
Path parameters
id
ID of a DataPointFilter
Query Parameters
userId
ID of a user that should be unsubscribed from the filter
GET
/api/data-points/filters/list
https://uberall.com/api/data-points/filters/list
List all saved datapoint's filters the user has access
Shows owned or subscribed DataPointFilters
Query Parameters
userId
Shows the filters of the user with this id
POST
/api/data-points/read
https://uberall.com/api/data-points/read
Mark as Read
Mark one or several inbox items as read
Query Parameters
businessIds
Filter by business ids
countries
Filter by countries. ISO 3166-1 alpha-2 codes
dataPointTypes
Filter by type of datapoints. e.g. [PHOTO, REVIEW, CHECKIN]
directoryTypes
Filter by directories
excludeIds
If selectAll is set to true this parameter can contain a list of data point ids that should not be marked as read
ids
The uberall unique ids for the inbox items you want to mark as read
query
Filter by name
ratings
Only change inbox items with a rating included in ratings
replied
Only change elements you have/you have not replied to
selectAll
Required - If all data points matching the current filter settings should be marked as read
zip
Only change inbox items for locations where zip starts with given parameter
DELETE
/api/data-points/read
https://uberall.com/api/data-points/read
Mark as Unread
Mark one or several inbox items as unread
Query Parameters
businessIds
Filter by business ids
countries
Filter by countries. ISO 3166-1 alpha-2 codes
dataPointTypes
Filter by type of datapoints. e.g. [PHOTO, REVIEW, CHECKIN]
directoryTypes
Filter by directories
excludeIds
If selectAll is set to true this parameter can contain a list of data point ids that should not be marked as unread
ids
The uberall unique ids for the inbox items you want to mark as unread
query
Filter by name
ratings
Only change inbox items with a rating included in ratings
replied
Only change elements you have/you have not replied to
selectAll
If all data points matching the current filter settings should be marked as unread
zip
Only change inbox items for locations where zip starts with given parameter
GET
/api/data-points/statistics
https://uberall.com/api/data-points/statistics
Get Data Points' Statistics
Returns statistics about the locations inbox.
Query Parameters
businessIds
Ids of businesses you want inbox statistics for
countries
The countries you want data points' statistics for. ISO 3166-1 alpha-2 codes
dataPointTypes
Types of datapoints you want inbox statistics for. e.g. [PHOTO, REVIEW, CHECKIN]
directoryTypes
Directories you want inbox statistics for
locationIds
Only consider data points belonging to any of these locationIds
maxActionDate
Only consider data points created before that date
maxThreadActionDate
The max date of the last interaction with a DataPoint as unix timestamp in milliseconds, e.g. 1514764800000
minActionDate
Only consider data points created after that date
minThreadActionDate
The min date of the last interaction with a DataPoint as unix timestamp in milliseconds, e.g. 1514764800000
query
Filter by name
ratings
Ratings of datapoints you want inbox statistics for.
read
(Boolean) Only consider data points that the current user has already read
replied
(Boolean) only consider data points that are either replied or not replied
GET
/api/data-points/timeseries
https://uberall.com/api/data-points/timeseries
Get Data Points time series
Returns time series of Data Points
Query Parameters
businessIds
The ids of the businesses you want Data Pointss time series for
countries
The countries you want Data Points time series for. ISO 3166-1 alpha-2 codes
dataPointTypes
Types of datapoints you want Data Points time series for. e.g. [PHOTO, REVIEW, CHECKIN]
directoryTypes
The directories you want Data Points time series for
ratings
Only return time series of the Data Points with a rating included in ratings
read
Only include read/not read elements
replied
Only include elements you have/you have not replied to
zip
Only return Data Points time series for locations where zip starts with given parameter

Event Endpoints

GET /api/events Get All Events
POST /api/events Create an Event
PATCH /api/events Update an Event using identifier
DELETE /api/events Delete an Event using identifier
GET /api/events/$id Get an Event
PATCH /api/events/$id Update an Event
DELETE /api/events/$id Delete an Event
GET
/api/events
https://uberall.com/api/events
[ Event ,...]
Get All Events
Get all events the current API user can manage.
To specify events with identifier please provide ?identifier= in the URL param
By default, 50 are returned, you can use up to max=10000 in the URL param
POST
/api/events
https://uberall.com/api/events
Create an Event
Create a new event. It can be added to a content list later
Body Parameters
A [ Event ] object.
PATCH
/api/events
https://uberall.com/api/events
Update an Event using identifier
Make changes to an event, always use ?identifier= in url param to identify the event uniquely Any blank parameter deletes an old value, any unspecified parameter does nothing
Body Parameters
A [ Event ] object.
DELETE
/api/events
https://uberall.com/api/events
Delete an Event using identifier
Delete an event identified by identifier in the url param
GET
/api/events/$id
https://uberall.com/api/events/$id
Get an Event
Get a single event identified by its uberall unique id
Path parameters
id
The uberall unique id for the event
PATCH
/api/events/$id
https://uberall.com/api/events/$id
Update an Event
Make changes to an event. Any blank parameter deletes an old value, any unspecified parameter does nothing
Path parameters
id
The uberall unique id of the event you want to update
Body Parameters
A [ Event ] object.
DELETE
/api/events/$id
https://uberall.com/api/events/$id
Delete an Event
Delete an event
Path parameters
id
The uberall unique id for the event you want to delete

Features Endpoint

GET /api/features Get user features
GET
/api/features
https://uberall.com/api/features
Get user features
Get user features partitioned by location.

Homepage

GET /api/homepage/campaigns Get Campaign information for all locations.
GET /api/homepage/campaigns/$id Get Campaign information for a single location.
GET /api/homepage/cards Get the Homepage cards for the user
GET /api/homepage/customer-feedback Get Customer Feedback information for all locations.
GET /api/homepage/customer-feedback-keywords Get Customer Feedback Keyword information for all locations
GET /api/homepage/customer-feedback-keywords/$id Get Customer Feedback Keyword information for a single location
GET /api/homepage/customer-feedback/$id Get Customer Feedback information for a single location.
GET /api/homepage/header Get Header information for all locations
GET /api/homepage/header/$id Get Header information for a single location
GET /api/homepage/insights Get Insights information for all locations
GET /api/homepage/insights/$id Get Insights information for a single location
GET /api/homepage/interactions Get Interactions information for all locations
GET /api/homepage/interactions/$id Get Interactions information for a single location
GET /api/homepage/listing-health Get Listing Health information for all locations
GET /api/homepage/listing-health/$id Get Listing Health information for a single location
GET /api/homepage/profile-completeness Get Profile Completeness information for all locations
GET /api/homepage/profile-completeness/$id Get Profile Completeness information for a single location
GET /api/homepage/search-rank Get Search Rank information for all locations
GET /api/homepage/search-rank/$id Get Search Rank information for a single location
GET /api/homepage/social-post-metrics Get Social Post Metrics information for all locations
GET /api/homepage/social-post-metrics/$id Get Social Post Metrics information for a single location
GET /api/homepage/store-locator Get Store Locator information for all locations
GET /api/homepage/store-locator/$id Get Store Locator information for a single location
GET /api/homepage/todos Get Todos for all locations
GET /api/homepage/todos/$id Get Todos for a single location
GET
/api/homepage/campaigns
https://uberall.com/api/homepage/campaigns
Get Campaign information for all locations.
Get Campaign (also called Ads) performance information for all locations. Populates the card 'ads'.
GET
/api/homepage/campaigns/$id
https://uberall.com/api/homepage/campaigns/$id
Get Campaign information for a single location.
Get Campaign (also called Ads) performance information for a single location. Populates the card 'ads'.
Path parameters
id
The Uberall locationId
GET
/api/homepage/cards
https://uberall.com/api/homepage/cards
Get the Homepage cards for the user
Get the Homepage cards a given user has access to
GET
/api/homepage/customer-feedback
https://uberall.com/api/homepage/customer-feedback
Get Customer Feedback information for all locations.
Get Customer Feedback information for all locations. Populates the cards 'average-rating', 'rating-split', 'reply-rate', 'reply-rate-split'.
GET
/api/homepage/customer-feedback-keywords
https://uberall.com/api/homepage/customer-feedback-keywords
Get Customer Feedback Keyword information for all locations
Get Customer Feedback Keywords information for all locations. Populates the card 'review-sentiment'.
GET
/api/homepage/customer-feedback-keywords/$id
https://uberall.com/api/homepage/customer-feedback-keywords/$id
Get Customer Feedback Keyword information for a single location
Get Customer Feedback Keywords information for a single location. Populates the card 'review-sentiment'.
Path parameters
id
The Uberall locationId
GET
/api/homepage/customer-feedback/$id
https://uberall.com/api/homepage/customer-feedback/$id
Get Customer Feedback information for a single location.
The Uberall locationId
Path parameters
id
The Uberall locationId
GET
/api/homepage/header
https://uberall.com/api/homepage/header
Get Header information for all locations
Get Header information for all locations
Query Parameters
language
Language for translations (en, de, fr, it, es, ...)
GET
/api/homepage/header/$id
https://uberall.com/api/homepage/header/$id
Get Header information for a single location
The Uberall locationId
Path parameters
id
The Uberall locationId
GET
/api/homepage/insights
https://uberall.com/api/homepage/insights
Get Insights information for all locations
Get Insights information for all locations. Populates the cards 'google-impressions', 'google-indirect-search-queries', 'google-direct-search-queries', 'google-conversions', 'google-conversions-lowest', 'google-conversions-highest' and 'google-photos'.
Query Parameters
language
Language for translations (en, de, fr, it, es, ...)
GET
/api/homepage/insights/$id
https://uberall.com/api/homepage/insights/$id
Get Insights information for a single location
The Uberall locationId
Path parameters
id
The Uberall locationId
Query Parameters
language
Language for translations (en, de, fr, it, es, ...)
GET
/api/homepage/interactions
https://uberall.com/api/homepage/interactions
Get Interactions information for all locations
Get Interactions information for all locations. Populates the card 'interactions'.
Query Parameters
directoryTypes
Directory types to filter (Google, Facebook)
GET
/api/homepage/interactions/$id
https://uberall.com/api/homepage/interactions/$id
Get Interactions information for a single location
The Uberall locationId
Path parameters
id
The Uberall locationId
Query Parameters
directoryTypes
Directory types to filter (Google, Facebook)
GET
/api/homepage/listing-health
https://uberall.com/api/homepage/listing-health
Get Listing Health information for all locations
Get Listing Health information for all locations. Populates the card 'listings'.
GET
/api/homepage/listing-health/$id
https://uberall.com/api/homepage/listing-health/$id
Get Listing Health information for a single location
The Uberall locationId
Path parameters
id
The Uberall locationId
GET
/api/homepage/profile-completeness
https://uberall.com/api/homepage/profile-completeness
Get Profile Completeness information for all locations
Get Profile Completeness information for all locations. Populates the card 'profile-completeness'.
GET
/api/homepage/profile-completeness/$id
https://uberall.com/api/homepage/profile-completeness/$id
Get Profile Completeness information for a single location
The Uberall locationId
Path parameters
id
The Uberall locationId
GET
/api/homepage/search-rank
https://uberall.com/api/homepage/search-rank
Get Search Rank information for all locations
Get Search Rank information for all locations. Populates the cards 'google-direct-search-rank' and 'google-discovery-search-rank'.
GET
/api/homepage/search-rank/$id
https://uberall.com/api/homepage/search-rank/$id
Get Search Rank information for a single location
The Uberall locationId
Path parameters
id
The Uberall locationId
GET
/api/homepage/social-post-metrics
https://uberall.com/api/homepage/social-post-metrics
Get Social Post Metrics information for all locations
Get Social Post Metrics information for all locations. Populates the card 'facebook-posts'.
Query Parameters
directoryTypes
Directory types to filter (Google, Facebook)
GET
/api/homepage/social-post-metrics/$id
https://uberall.com/api/homepage/social-post-metrics/$id
Get Social Post Metrics information for a single location
The Uberall locationId
Path parameters
id
The Uberall locationId
Query Parameters
directoryTypes
Directory types to filter (Google, Facebook)
GET
/api/homepage/store-locator
https://uberall.com/api/homepage/store-locator
Get Store Locator information for all locations
Get Store Locator information for all locations. Populates the card 'storelocator'.
GET
/api/homepage/store-locator/$id
https://uberall.com/api/homepage/store-locator/$id
Get Store Locator information for a single location
The Uberall locationId
Path parameters
id
The Uberall locationId
GET
/api/homepage/todos
https://uberall.com/api/homepage/todos
Get Todos for all locations
Get Todos information (recommended actions to the user) for all locations
GET
/api/homepage/todos/$id
https://uberall.com/api/homepage/todos/$id
Get Todos for a single location
The Uberall locationId
Path parameters
id
The Uberall locationId

Labels Endpoints

GET /api/labels Get All Labels
GET
/api/labels
https://uberall.com/api/labels
[ Label ,...]
Get All Labels
Get all labels associated to locations of the user

Listing Endpoints

PATCH /api/listings/$id Edit Listing
PUT /api/listings/$id/flag Flag a Listing
PATCH
/api/listings/$id
https://uberall.com/api/listings/$id
Edit Listing
Used for MANUALLY_CREATED listings to update listingUrl and syncStatus
Path parameters
id
The Id of the MANUALLY_CREATED listing to be updated
PUT
/api/listings/$id/flag
https://uberall.com/api/listings/$id/flag
Flag a Listing
Flag a listing if it is not corresponding to the right location
Path parameters
id
The uberall unique id for the listing you want to flag

Location Endpoints

GET /api/locations Get Several Locations
POST /api/locations Create a Location
PATCH /api/locations Update Several Locations
DELETE /api/locations Delete Several Locations
GET /api/locations/$id Get a Location
PATCH /api/locations/$id Update a Location
GET /api/locations/$id/dashboard Get a Location's Dashboard
GET /api/locations/$id/datapoints Get Location's Data Points
GET /api/locations/$id/datapoints/statistics Get Location's Data Point Statistics
GET /api/locations/$id/facebook/page Get Location's Facebook Page
POST /api/locations/$id/facebook/page DEPRECATED - Connect Facebook Page
DELETE /api/locations/$id/facebook/page Disconnect Location's Facebook Page
GET /api/locations/$id/google/page Get information about the connected Google Page of the specified location
DELETE /api/locations/$id/google/page Disconnect Google Page
GET /api/locations/$id/logging-events Get Logging Events
GET /api/locations/$id/suggestions Get suggestions
PUT /api/locations/$id/suggestions Update suggestions
POST /api/locations/$id/sync Sync a Location
GET /api/locations/$id/visibility-indexes Get Location's Visibility Index
GET /api/locations/$id/visibility-indexes/interesting Get Historical Visibility Index
GET /api/locations/$locationId/profile-completeness Get Location's Profile Completeness
GET /api/locations/(*)/download-photos uberDoc.api.locations.UNDEFINED_PARAMETER.download-photos.GET.title
GET /api/locations/cities Get the location's city.
GET /api/locations/countries Get the location's country
GET /api/locations/directories Get the location's directories
GET /api/locations/keywords Get the location's keywords
GET /api/locations/labels Get the location's labels
GET /api/locations/postcodes Get the location's post / zip code
GET /api/locations/provinces Get the location's province / state
GET /api/locations/statistics Get Locations' Statistics
GET /api/locations/suggestions Get Location Suggestions
POST /api/locations/sync Sync Several Locations
GET /api/locations/tracking-events Get Tracking Events
GET
/api/locations
https://uberall.com/api/locations
Get Several Locations
Get locations managed by the current API user. Some fields are omitted (such as paymentOptions and services). For a full list use the GET/api/locations/$id endpoint.
Query Parameters
businessId
Only return locations in the business identified by businessId. Allowed multiple businessIds such as /api/locations?businessId=123&businessId=456
businessIds
uberDoc.resource.api.locations.GET.queryParam.businessIds.description
cities
Get locations in the requested cities
classification
Possible values: REQUIRED, BASIC, ADVANCED, BONUS and COMPLETE
countries
Get locations in the requested country
endDateMax
Only locations with an endDate less than or equal to endDateMax will be returned. e.g. 2020-02-05T12:18:12.000+01:00
endDateMin
Only locations with an endDate greater than or equal to endDateMin will be returned. e.g. 2018-02-05T12:18:12.000+01:00
excludedLocationIds
List of locationIds that should be excluded from the result. eg: excludedLocationIds=20&excludedLocationIds=21 for multiple locations
facebookStatus
Possible values: CONNECTED, NOT_CONNECTED
fieldMask
Possible fieldMask options ( 'id', 'name', 'identifier', 'street', 'streetNo', 'streetAndNumber', 'addressExtra', 'zip', 'city', 'province', 'lat', 'lng', 'addressDisplay', 'phone', 'fax', 'cellPhone', 'website', 'email', 'legalIdent', 'taxNumber', 'descriptionShort', 'descriptionLong', 'imprint', 'openingHoursNotes', 'status','firstSyncStarted', 'lastSyncStarted', 'autoSync', 'locationSyncable', 'businessId', 'googleInsights', 'labels') eg: fieldMask=city&fieldMask=zip
googleStatus
Possible values: VERIFIED (the Google listing is verified and fully managed by us), VERIFICATION_STARTED (a verification pin has been requested for the Google listing), VERIFICATION_NOT_STARTED (the verification process has not been start for the Google listing), NOT_CONNECTED (there is no Google account connected for the listing), VERIFIED_BY_THIRD_PARTY (there is a verified listing on Google but we do not manage it)
identifier
Only return one location (per business) based on your internal identification system
labels
Only return locations that contain at least one of the given labels
locationIds
Only return locations identified by ids listed in locationIds, eg: ?locationIds=20&locationIds=22 for multiple locations
max
Used for pagination. Maximum number of results per page. Default: 50
missingDirectoryField
Only return locations that have no value for the given field
needsReview
If set to true, only return locations with faulty data in need of review. Default: false.
offset
Offset used for pagination. Default: 0
order
use asc for ascending sort or desc for descending sort
postcodes
Get locations in the requested post / zip codes
provinces
Get locations in the requested province / state
query
Filter by name, zip, street, city, label: e.g. "Berlin"
queryFields
uberDoc.resource.api.locations.GET.queryParam.queryFields.description
selectAll
Setting selectAll to true allows finding ALL locations for any given businessId, locationIds and labels. In other words these fields are OR joined.
sort
The location property to sort by (ascending unless order is specified). One of name, street, streetNo, zip, city, phone, cellphone, fax, website, email, lastSyncStarted, country
status
Filter by locations status. One of ACTIVE, INACTIVE, CANCELLED
syncNeeded
If set to true, filter locations that have been updated but did not start a sync yet
syncStarted
If set to true, filter locations that started a sync. If set to false, filter locations that never synced
POST
/api/locations
https://uberall.com/api/locations
Create a Location
Create a location and add it to an existing business
Body Parameters
A [ Location ] object.
PATCH
/api/locations
https://uberall.com/api/locations
Update Several Locations
Make changes to a list of locations. Any blank parameter deletes an old value, any unspecified parameter does nothing
Body Parameters
locations
Required - List of Maps with both location id and params to update : [{id: 123, status: CANCELLED}, ...]
List
DELETE
/api/locations
https://uberall.com/api/locations
Delete Several Locations
Delete several locations identified by their uberall unique ids. Locations can be deleted only if they are inactivated (status = INACTIVE) and are no longer billed (endDate < now).
Query Parameters
locations
Required - The uberall unique ids for the locations you want to delete
GET
/api/locations/$id
https://uberall.com/api/locations/$id
Get a Location
Get all information about a specific location, including listing statuses
Path parameters
id
The uberall unique id of the location
PATCH
/api/locations/$id
https://uberall.com/api/locations/$id
Update a Location
Make changes to a location. Any blank parameter deletes an old value, any unspecified parameter does nothing
Path parameters
id
The uberall unique id for the location you want to update
Body Parameters
A [ Location ] object.
GET
/api/locations/$id/dashboard
https://uberall.com/api/locations/$id/dashboard
Get a Location's Dashboard
Get all necessary information to build a location's dashboard
Path parameters
id
The uberall unique id of the location you want a dashboard for
GET
/api/locations/$id/datapoints
https://uberall.com/api/locations/$id/datapoints
Get Location's Data Points
Get location's inbox items: reviews, checkins and photos
Path parameters
id
The uberall unique id of the location you want inbox items for
GET
/api/locations/$id/datapoints/statistics
https://uberall.com/api/locations/$id/datapoints/statistics
Get Location's Data Point Statistics
Returns statistics about the locations inbox.
Path parameters
id
The uberall unique id of the location.
Query Parameters
dataPointTypes
Types of datapoints you want inbox statistics for. e.g. [PHOTO, REVIEW, CHECKIN]
directoryTypes
Directories you want inbox statistics for.
maxActionDate
Only consider data points created before that date
maxThreadActionDate
The max date of the last interaction with a DataPoint as unix timestamp in milliseconds, e.g. 1514764800000
minActionDate
Only consider data points created after that date
minThreadActionDate
The min date of the last interaction with a DataPoint as unix timestamp in milliseconds, e.g. 1514764800000
ratings
Ratings of datapoints you want inbox statistics for.
GET
/api/locations/$id/facebook/page
https://uberall.com/api/locations/$id/facebook/page
Get Location's Facebook Page
Get the Facebook page connected to a specific location
Path parameters
id
The uberall unique id of the location you want the Facebook page for
POST
/api/locations/$id/facebook/page
https://uberall.com/api/locations/$id/facebook/page
DEPRECATED - Connect Facebook Page
Connect a Facebook page to the location
Path parameters
id
The uberall unique id for the location
Query Parameters
fb_access_token
A Facebook API access token with "manage_pages", "publish_actions" and "read_page_mailboxes" permissions
pageId
The Facebook unique id of the page you want to connect
DELETE
/api/locations/$id/facebook/page
https://uberall.com/api/locations/$id/facebook/page
Disconnect Location's Facebook Page
Disconnect the Facebook page connected to a specific location
Path parameters
id
The uberall unique id of the location
GET
/api/locations/$id/google/page
https://uberall.com/api/locations/$id/google/page
Get information about the connected Google Page of the specified location
Get information such as Google place id, write review URL, etc.
Path parameters
id
The uberall unique id of the location
DELETE
/api/locations/$id/google/page
https://uberall.com/api/locations/$id/google/page
Disconnect Google Page
Disconnect the Google Page connected to the specified location
Path parameters
id
The uberall unique id of the location
GET
/api/locations/$id/logging-events
https://uberall.com/api/locations/$id/logging-events
Get Logging Events
Get logging events (e.g. sync, changes, normalization...) for a specific location
Path parameters
id
The uberall unique id for the location
Query Parameters
from
The start of the time range to retrieve logging events for. Unix timestamp in milliseconds
to
The end of the time range to retrieve logging events for. Unix timestamp in milliseconds
GET
/api/locations/$id/suggestions
https://uberall.com/api/locations/$id/suggestions
Get suggestions
Get location suggestions given a search data
Path parameters
id
The uberall unique id for the location
Query Parameters
directoryTypes
Filter suggestions by directories
language
Filter suggestion attributes by language
PUT
/api/locations/$id/suggestions
https://uberall.com/api/locations/$id/suggestions
[ Suggestion ,...]
Update suggestions
Update the given suggestion object, used to track the status of incoming suggestions. Note that rejecting a suggestion does not delete it, and accepting the suggestion won't automatically apply it to the location.
Path parameters
id
The uberall unique id for the suggestion
Body Parameters
suggestions
Required - List of Maps with both an id and a status key: [[id: 123, status: ACCEPTED], ...]
List
POST
/api/locations/$id/sync
https://uberall.com/api/locations/$id/sync
Sync a Location
Start a sync on all directories for a specific location
Path parameters
id
The uberall unique id for the location you want to sync
GET
/api/locations/$id/visibility-indexes
https://uberall.com/api/locations/$id/visibility-indexes
Get Location's Visibility Index
Get the latest location's visibility index
Path parameters
id
The uberall unique id for the location
Query Parameters
days
Use days to get the visibility index from as many days ago
GET
/api/locations/$id/visibility-indexes/interesting
https://uberall.com/api/locations/$id/visibility-indexes/interesting
Get Historical Visibility Index
Get a Visibility Index time series. Only days where the Visibility Index changed will be returned
Path parameters
id
The uberall unique id of the location you want the Visibility Index for
Query Parameters
endDate
endDate in YYYY-MM-dd
startDate
startDate in YYYY-MM-dd
GET
/api/locations/$locationId/profile-completeness
https://uberall.com/api/locations/$locationId/profile-completeness
Get Location's Profile Completeness
Get the current classification and information for each field if it is filled out. Classification can be one of 'Required', 'Bonus', 'Advanced', 'Bonus' or 'Complete'.
Path parameters
locationId
The uberall unique id for the location
GET
/api/locations/(*)/download-photos
https://uberall.com/api/locations/(*)/download-photos
uberDoc.api.locations.UNDEFINED_PARAMETER.download-photos.GET.title
uberDoc.resource.api.locations.UNDEFINED_PARAMETER.download-photos.GET.description
Query Parameters
type
Required - uberDoc.resource.api.locations.UNDEFINED_PARAMETER.download-photos.GET.queryParam.type.description
GET
/api/locations/cities
https://uberall.com/api/locations/cities
Get the location's city.
Get the location's city
Query Parameters
businessIds
Get the cities for locations by business id
countries
Get the cities for locations by country
max
Maximum number of items to return
offset
Offset used for pagination. Default: 0
provinces
Get the cities for locations by province / state
query
uberDoc.resource.api.locations.cities.GET.queryParam.query.description
GET
/api/locations/countries
https://uberall.com/api/locations/countries
Get the location's country
uberDoc.resource.api.locations.countries.GET.description
Query Parameters
businessIds
uberDoc.resource.api.locations.countries.GET.queryParam.businessIds.description
max
Maximum number of items to return
offset
Offset used for pagination. Default: 0
GET
/api/locations/directories
https://uberall.com/api/locations/directories
Get the location's directories
Get the directories for a location
GET
/api/locations/keywords
https://uberall.com/api/locations/keywords
Get the location's keywords
Get the keywords for locations
Body Parameters
businessIds
Required - The business ids for the locations that should be returned
List
locationIds
Required - The location ids that should have keywords returned
List
GET
/api/locations/labels
https://uberall.com/api/locations/labels
Get the location's labels
Get the labels assigned to a location
GET
/api/locations/postcodes
https://uberall.com/api/locations/postcodes
Get the location's post / zip code
Get the post / zip code assigned to a location
Query Parameters
businessIds
Get the post / zip codes for locations assigned to a business id
cities
Get the post / zip codes for locations within a city
countries
Get the post / zip codes for locations within a country
max
Maximum number of items to return
offset
Offset used for pagination. Default: 0
provinces
Get the post / zip codes for locations within a province / state
query
uberDoc.resource.api.locations.postcodes.GET.queryParam.query.description
GET
/api/locations/provinces
https://uberall.com/api/locations/provinces
Get the location's province / state
Get the provinces / states for locations
Query Parameters
businessIds
Get the provinces / states of locations associated with specific Business Id(s)
countries
Get provinces / states for locations in a country
max
Maximum number of items to return
offset
Offset used for pagination. Default: 0
query
uberDoc.resource.api.locations.provinces.GET.queryParam.query.description
GET
/api/locations/statistics
https://uberall.com/api/locations/statistics
Get Locations' Statistics
Get statistics about the locations the current user is managing: total and breakdown by status
GET
/api/locations/suggestions
https://uberall.com/api/locations/suggestions
Get Location Suggestions
Get a list of suggestions for all locations managed by the logged user
Query Parameters
businessId
The ids of the businesses you want suggestions for
identifier
The location identifier, based on your internal identification system, you want the suggestions for.
locationIds
The ids of the locations you want suggestions for.
max
Used for pagination. Maximum number of results per page.
offset
Offset used for pagination. Default: 0
order
use asc for ascending sort or desc for descending sort
query
Filter by name, zip, street, city, label: e.g. "Berlin"
sort
The location property to sort by (ascending unless order is specified). One of name, street, streetNo, zip, city, phone, cellphone, fax, website, email, lastSyncStarted, country
POST
/api/locations/sync
https://uberall.com/api/locations/sync
Sync Several Locations
Start a sync on all directories for several locations identified by their unique uberall id
Query Parameters
locationIds
Required - The uberall unique ids for the locations you want to sync
GET
/api/locations/tracking-events
https://uberall.com/api/locations/tracking-events
Get Tracking Events
Returns a list of tracking events for all locations managed by the logged user
Query Parameters
max
Used for pagination. Maximum number of results per page. Default: 10
offset
Offset used for pagination. Default: 0
GET /api/menu-items Get All Menu Items
POST /api/menu-items Create a Menu Item
PATCH /api/menu-items Update a Menu Item using identifier
DELETE /api/menu-items Delete a Menu Item using identifier
GET /api/menu-items/$id Get a Menu Item
PATCH /api/menu-items/$id Update a Menu Item
DELETE /api/menu-items/$id Delete a Menu Item
GET /api/menu-items/accepted-extra-fields uberDoc.api.menu-items.accepted-extra-fields.GET.title
GET
/api/menu-items
https://uberall.com/api/menu-items
[ MenuItem ,...]
Get All Menu Items
Get all menu items the current API user can manage.
To specify products with identifier please provide ?identifier= in the URL param
By default, 50 are returned, you can use up to max=10000 in the URL param
POST
/api/menu-items
https://uberall.com/api/menu-items
Create a Menu Item
Create a menu item. It can be added to a content list later
Body Parameters
A [ MenuItem ] object.
PATCH
/api/menu-items
https://uberall.com/api/menu-items
Update a Menu Item using identifier
Make changes to a menu item, always use ?identifier= in url param to identify the menu item uniquely Any blank parameter deletes an old value, any unspecified parameter does nothing
Body Parameters
A [ MenuItem ] object.
DELETE
/api/menu-items
https://uberall.com/api/menu-items
Delete a Menu Item using identifier
Delete a menu item identified by identifier in the url param
GET
/api/menu-items/$id
https://uberall.com/api/menu-items/$id
Get a Menu Item
Get a sigle menu item
Path parameters
id
The uberall unique id for the menu item
PATCH
/api/menu-items/$id
https://uberall.com/api/menu-items/$id
Update a Menu Item
Make changes to a menu item. Any blank parameter deletes an old value, any unspecified parameter does nothing
Path parameters
id
The uberall unique id of the menu item you want to update
Body Parameters
A [ MenuItem ] object.
DELETE
/api/menu-items/$id
https://uberall.com/api/menu-items/$id
Delete a Menu Item
Delete a menu item
Path parameters
id
The uberall unique id for the menu item you want to delete
GET
/api/menu-items/accepted-extra-fields
https://uberall.com/api/menu-items/accepted-extra-fields
uberDoc.api.menu-items.accepted-extra-fields.GET.title
uberDoc.resource.api.menu-items.accepted-extra-fields.GET.description

API Status Endpoints

GET /api/monitoring/ping Get API Status
GET
/api/monitoring/ping
https://uberall.com/api/monitoring/ping
Get API Status
Get the current status of uberall API

Person Endpoints

GET /api/persons Get All Persons
POST /api/persons Create a Person
PATCH /api/persons Update a Person using identifier
DELETE /api/persons Delete a Person using identifier
GET /api/persons/$id Get a Person
PATCH /api/persons/$id Update a Person
DELETE /api/persons/$id Delete a Person
GET
/api/persons
https://uberall.com/api/persons
[ Person ,...]
Get All Persons
Get all persons the current API user can manage.
To specify products with identifier please provide ?identifier= in the URL param
By default, 50 are returned, you can use up to max=10000 URL param
POST
/api/persons
https://uberall.com/api/persons
Create a Person
Create a person. It can be added to a content list later
Body Parameters
A [ Person ] object.
PATCH
/api/persons
https://uberall.com/api/persons
Update a Person using identifier
Make changes to a person, always use ?identifier= in url param to identify the person uniquely Any blank parameter deletes an old value, any unspecified parameter does nothing
Body Parameters
A [ Person ] object.
DELETE
/api/persons
https://uberall.com/api/persons
Delete a Person using identifier
Delete a person identified by identifier in the url param
GET
/api/persons/$id
https://uberall.com/api/persons/$id
Get a Person
Get a person identified by its uberall unique id
Path parameters
id
The uberall unique id of the person you want to get
PATCH
/api/persons/$id
https://uberall.com/api/persons/$id
Update a Person
Make changes to a person. Any blank parameter deletes an old value, any unspecified parameter does nothing
Path parameters
id
The uberall unique id of the person you want to update
Body Parameters
A [ Person ] object.
DELETE
/api/persons/$id
https://uberall.com/api/persons/$id
Delete a Person
Delete a person
Path parameters
id
The uberall unique id of the person you want to delete

Photo Endpoints

POST /api/photos Upload a Photo
GET /api/photos/$id Get a Photo
PATCH /api/photos/$id Update a Photo
DELETE /api/photos/$id Delete a Photo
POST
/api/photos
https://uberall.com/api/photos
Upload a Photo
Upload a photo
Body Parameters
description
A description for the photo
String
identifier
The photo identifier based on your internal identification system
String
locationId
Required - The uberall unique id of this photo's location
Long
photo
Required - The photo as a file or a base64
MultipartRequest
type
Required - One of: <br> MAIN <br> LOGO <br> SQUARED_LOGO <br> LANDSCAPE - Updates Google Cover Photo<br> PHOTO <br> STOREFINDER_COVER - Only for Uberall locator product<br> FACEBOOK_LANDSCAPE - Facebook Cover Photo <br> EXTERIOR - Google's Exterior Photo tag - availability dependent on a location's business category <br> INTERIOR - Google's Interior Photo tag - availability dependent on a location's business category <br> FOOD_AND_DRINK - Google's Food and Drink Photo tag - availability dependent on a location's business category <br> MENU - Google's Menu Photo tag, which should only be photos of the menu - availability dependent on a location's business category <br> PRODUCT - Google's Product Photo tag - availability dependent on a location's business category <br> TEAMS - Google's Teams Photo tag - availability dependent on a location's business category <br> AT_WORK - Google's At Work Photo tag - availability dependent on a location's business category <br> COMMON_AREA - Google's Common Area Photo tag - availability dependent on a location's business category <br> ROOMS - Google's Rooms Photo tag - availability dependent on a location's business category
String
GET
/api/photos/$id
https://uberall.com/api/photos/$id
Get a Photo
Get a photo identified by its uberall unique id
Path parameters
id
The uberall unique id for the photo you want to get
PATCH
/api/photos/$id
https://uberall.com/api/photos/$id
Update a Photo
Edit a photo
Path parameters
id
The uberall unique id for the photo you want to delete
Body Parameters
description
Required - A description for the photo
String
type
Required - One of: <br> MAIN <br> LOGO <br> SQUARED_LOGO <br> LANDSCAPE - Updates Google Cover Photo<br> PHOTO <br> STOREFINDER_COVER - Only for Uberall locator product<br> FACEBOOK_LANDSCAPE - Facebook Cover Photo <br> EXTERIOR - Google's Exterior Photo tag - availability dependent on a location's business category <br> INTERIOR - Google's Interior Photo tag - availability dependent on a location's business category <br> FOOD_AND_DRINK - Google's Food and Drink Photo tag - availability dependent on a location's business category <br> MENU - Google's Menu Photo tag, which should only be photos of the menu - availability dependent on a location's business category <br> PRODUCT - Google's Product Photo tag - availability dependent on a location's business category <br> TEAMS - Google's Teams Photo tag - availability dependent on a location's business category <br> AT_WORK - Google's At Work Photo tag - availability dependent on a location's business category <br> COMMON_AREA - Google's Common Area Photo tag - availability dependent on a location's business category <br> ROOMS - Google's Rooms Photo tag - availability dependent on a location's business category
String
DELETE
/api/photos/$id
https://uberall.com/api/photos/$id
Delete a Photo
Delete a photo identified by its uberall unique id
Path parameters
id
The uberall unique id for the photo you want to the delete

Product Plan Endpoints

GET /api/product-plans Get All Product Plans
POST /api/product-plans Create a Product Plan
PATCH /api/product-plans/$id Update a Product Plan
GET
/api/product-plans
https://uberall.com/api/product-plans
Get All Product Plans
Get all product plans available to the current API user
Query Parameters
country
Optional parameter to retrieve plans and supported directories for a specific country
POST
/api/product-plans
https://uberall.com/api/product-plans
Create a Product Plan
Create a new Product Plan. The new Product Plan will be always created into PENDING_APPROVAL status.
Body Parameters
ProductPlan
Required - A Product Plan object
ProductPlan
PATCH
/api/product-plans/$id
https://uberall.com/api/product-plans/$id
Update a Product Plan
Update an existing Product Plan. Only defaultPlan, description, identifier, name and status are updatable via API.
Path parameters
id
The uberall unique id of the Product Plan
Body Parameters
defaultPlan
True, if this is the default ProductPlan. A new created business will get this product plan, if not declared differently.
Boolean
description
Description of the plan
String
identifier
The Product Plan identifier based on your internal identification system
String
name
The name of the Product Plan
String
status
Status of the Product Plan. Is possible to change an ACTIVE Product Plan to INACTIVE and vice versa.
ProductPlanStatus

Product Endpoints

GET /api/products Get All Products
POST /api/products Create a Product
PATCH /api/products Update a Product using identifier
DELETE /api/products Delete a Product using identifier
GET /api/products/$id Get a Product
PATCH /api/products/$id Update a Product
DELETE /api/products/$id Delete a Product
GET
/api/products
https://uberall.com/api/products
[ Product ,...]
Get All Products
Get all products the current API user can manage.
To specify products with identifier please provide ?identifier= in the URL param
By default, 50 are returned, you can use up to max=10000 URL param
POST
/api/products
https://uberall.com/api/products
Create a Product
Create a product. It can be added to a content list later
Body Parameters
A [ Product ] object.
PATCH
/api/products
https://uberall.com/api/products
Update a Product using identifier
Make changes to a product, always use ?identifier= in url param to identify the product uniquely Any blank parameter deletes an old value, any unspecified parameter does nothing
Body Parameters
A [ Product ] object.
DELETE
/api/products
https://uberall.com/api/products
Delete a Product using identifier
Delete a product identified by identifier in the url param
GET
/api/products/$id
https://uberall.com/api/products/$id
Get a Product
Get a product identified by its uberall unique id
Path parameters
id
The uberall unique id for the product you want to get
PATCH
/api/products/$id
https://uberall.com/api/products/$id
Update a Product
Make changes to a product. Any blank parameter deletes an old value, any unspecified parameter does nothing
Path parameters
id
The uberall unique id for the product you want to update
Body Parameters
A [ Product ] object.
DELETE
/api/products/$id
https://uberall.com/api/products/$id
Delete a Product
Delete a product identified by its uberall unique id
Path parameters
id
The uberall unique id for the product

SalesPartners

GET /api/sales-partners Search among child SalesPartners
POST /api/sales-partners Create child SalesPartner
GET /api/sales-partners/$id Get a single SalesPartner
PUT /api/sales-partners/$id Update a single SalesPartner
GET /api/sales-partners/subscribable-event-types Get all subscribable event types
GET
/api/sales-partners
https://uberall.com/api/sales-partners
Search among child SalesPartners
Can be used for searching through all children SalesPartner for the given parent SalesPartner
Query Parameters
id
Filter by specific uberall SalesPartner id
max
Used for pagination. Maximum number of results per page. Default: 1000
offset
Offset used for pagination. Default: 0
order
Order used for pagination. Default: 'asc'
query
Filter by name or identifier
sort
SalesPartner property used for pagination. Default: 'id'
status
Filter by status
POST