Get All or Several Categories

Request

Get a list of all available location categories, or specific location categories based on the following parameters

Security

X-API-KEY or Authorization

Query

categoriesinteger, (int64)

The uberall unique id of the category you want to get

qstring

Filter categories by a search query

Example:q=Auto

rootsboolean

Set to 'true' to show root categories as well (i.e., show all categories)

languagestringrequired

Show categories in the specified language. One of de, en, es, fr

maxinteger, (int64)

Used for pagination. Maximum number of results per page. Default: 10

Example:max=10

offsetinteger, (int64)

Offset used for pagination. Default: 0

Example:offset=0

curl -i -X GET \
  'https://uberall.com/api/categories?categories=0&q=Auto&roots=true&language=string&max=10&offset=0' \
  -H 'X-API-KEY: YOUR_API_KEY_HERE'

Responses

Successfully retrieved categories

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": {
    "max": 1,
    "offset": 0,
    "count": 1,
    "results": { … },
    "suggestionResults": { … }
  }
}