Skip to content
API Reference/
/
Get All Data Points

Get All Data Points

Request

Get all data points, potentially filtered by directory, business, rating...

Security
X-API-KEY or Authorization
Query
maxinteger, (int64)

Used for pagination. Maximum number of results per page

pageinteger, (int64)

The page number for pagination

labelsArray of strings

Filter by location labels

countriesArray of strings

The countries you want data points for. ISO 3166-1 alpha-2 codes

businessIdsArray of strings

Ids of businesses you want data points for

locationIdsArray of strings

The ids of the locations you want data points for

zipstring

Only return inbox items for locations where zip starts with given parameter

dataPointTypesArray of strings

Types of datapoints you want inbox items for

Example:dataPointTypes=[PHOTO, REVIEW, CHECKIN]
directoryTypesArray of strings

Directories you want inbox items for

ratingsArray of strings

Only return inbox items with a rating included in ratings

readboolean

Only return data points that are read (true) or unread (false). If omitted, returns all.

repliedboolean

Only show elements you have/you have not replied to

textboolean

Only return data points with text or without

querystring

Filter by name

minActionDatestring

The min publication date of the DataPoint as unix timestamp in milliseconds. The publication date (actionDate) is the date the content was published on the directory; for directories that report edits (e.g. Google) it moves to the most recent edit by the author. For API versions before 20210215 this parameter is interpreted as minThreadActionDate for backward compatibility

Example:minActionDate=1514764800000
maxActionDatestring

The max publication date of the DataPoint as unix timestamp in milliseconds. The publication date (actionDate) is the date the content was published on the directory; for directories that report edits (e.g. Google) it moves to the most recent edit by the author. For API versions before 20210215 this parameter is interpreted as maxThreadActionDate for backward compatibility

Example:maxActionDate=1514764800000
minThreadActionDatestring

The min date of the latest consumer activity on the DataPoint as unix timestamp in milliseconds. Consumer activity includes the original publication, edits by the author and new consumer comments; replies by the location owner do not update this date. To also match data points by owner-reply activity, combine with includeRepliedInDateRange

Example:minThreadActionDate=1514764800000
maxThreadActionDatestring

The max date of the latest consumer activity on the DataPoint as unix timestamp in milliseconds. Consumer activity includes the original publication, edits by the author and new consumer comments; replies by the location owner do not update this date. To also match data points by owner-reply activity, combine with includeRepliedInDateRange

Example:maxThreadActionDate=1514764800000
includeRepliedInDateRangeboolean

When true, also returns data points whose owner reply was created or updated within the given date range, even if the data point itself falls outside it. Has an effect only when at least one date filter is supplied and the feature is enabled for your sales partner; contact support to enable it. Intended for incremental synchronization over bounded date ranges.

fieldMaskstring

The fields you want to include in the response

curl -i -X GET \
  'https://uberall.com/api/data-points?max=0&page=0&labels=string&countries=string&businessIds=string&locationIds=string&zip=string&dataPointTypes=%5BPHOTO%2C%20REVIEW%2C%20CHECKIN%5D&directoryTypes=string&ratings=string&read=true&replied=true&text=true&query=string&minActionDate=1514764800000&maxActionDate=1514764800000&minThreadActionDate=1514764800000&maxThreadActionDate=1514764800000&includeRepliedInDateRange=true&fieldMask=string' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

Success

Bodyapplication/json
statusstringrequired
Enum:"SUCCESS""PENDING""QUOTA_LIMIT_EXCEED""NOT_AUTHORIZED""FORBIDDEN""BAD_ACCESS_TOKEN""BAD_PRIVATE_KEY""BAD_PUBLIC_KEY""MISSING_PARAMETER""INVALID_PARAMETER"
messagestring

(optional) Holds further information about the response

warningsArray of strings

(optional) Holds further warnings

responseobjectrequired

The actual response object of the response

Response
{
  "status": "SUCCESS",
  "message": "string",
  "warnings": [
    "string"
  ],
  "response": {
    "inbox": { … }
  }
}