Facets

List public category facets

Returns Google taxonomy category IDs currently available for public API category filters across shops, ads, emails, and advertisers.

get/v1/facets/categories

Request

  • Base URL: https://api.trendtrack.io (the document declares no server; this is the origin it was published from)
  • URL: https://api.trendtrack.io/v1/facets/categories
  • Auth: HTTP bearer

Query parameters

searchstring

Case-insensitive substring search over the facet label fields.

limitinteger
offsetinteger

Response

Category facet values with pagination and filter usage metadata. The response also includes the X-Request-Id header.

requestIdstring required

Request identifier mirrored in the X-Request-Id response header.

Example response

{
  "pagination": {
    "limit": 100,
    "total": 325
  },
  "meta": {
    "valueType": "number",
    "filterUsage": [
      {
        "resource": "shops",
        "fields": [
          "categoryIds"
        ],
        "valueField": "id"
      }
    ]
  },
  "data": [
    {
      "id": 287,
      "name": "Beauty",
      "path": "Health & Beauty > Beauty",
      "parentId": 42,
      "usageCount": 1842
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.