v1

latestOpenAPI 3.1.0© Copyright Partoo2026-07-26163503484.0 KB
Categories

List Partoo categories

This endpoint lets you read and filter through Partoo categories.

get/categories

Query parameters

countrystring

Filters categories available for businesses in given country.

If no country is given, then the endpoint returns the list of all existing available categories.

Use country ISO 3166 alpha2 code.

lang'fr' | 'en' | 'es' | 'it' | 'pt-br' | 'de' | 'ar' | 'nl' | 'pl' | 'cs' | 'ca' | 'sk' | 'pt' | 'lv' | 'ro' | 'bg' | 'hu'

Available language in the application

Example:fr

Language to get the category name. If not given, the user's language is used.

state'OK' | 'DEPRECATED'
block_push_long_description_on_gmbboolean

Filter on block_push_long_description_on_gmb param (boolean indicating if the business long description can be pushed to Google when the business belongs to this category)

search_querystring

Fuzzy search on gmb_id and names translations

order_by'gmb_id' | '-gmb_id' | 'impacted_businesses' | '-impacted_businesses'

Order results by colum. Add "-" before for ordering by descending order.

live__isnullboolean

Filter on live_id parameter value

  • True: Recover categories which live_id is null
  • False: Recover categories which live_id is not null

Null: Do not filter on live_id

pageinteger

Page number. Starts at 1. Any value lower than 1 will be considered as 1. For the number of items per page, see the per_page query parameter.

per_pageinteger

Number of items to return per page. Currently limited to 100.

with_namesboolean

Returns an object representing the list of translations in the available languages for the requested category. See example on the right.

If with_names is true, the translations will appear in the field names

with_countriesboolean

Returns an array of strings representing the list of country codes in which the requested category is available.

If with_countries is true, the country list will appear in the field countries

Response

OK

pageinteger

Current page number

max_pageinteger

Last page number

countinteger

Number of resources complying with filters

Example response

{
  "page": 1,
  "max_page": 10,
  "count": 287,
  "categories": [
    {
      "id": 42,
      "gmb_id": "gcid:climbing_gym",
      "name": "Cabinet d'expertise comptable",
      "names": [
        {
          "name": "salle d'escalade",
          "lang": "FR"
        }
      ],
      "state": "OK",
      "countries": [
        "FR",
        "GB",
        "IT",
        "ES"
      ],
      "live_id": "gcid:sport_club"
    }
  ]
}