Trendtrack
Trendtrack
DashboardGet API keyIntroduction
API Reference
Ads
Advertisers
Brandtrackers
Discovery
Emails
Facets
List public category facetsList public Shopify app facetsList public technology facetsList public pixel facets
Favorites
Identity
Shops
System
Usage
Workspace
ReferenceAPI

Facets

List public category facets

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

Authorization

publicApiBearer
AuthorizationBearer <token>

Provide a Trendtrack Public API key using Authorization: Bearer <api_key>.

In: header

Query Parameters

search?string

Case-insensitive substring search over the facet label fields.

limit?integer
Default100
Range1 <= value <= 500
offset?integer
Default0
Range0 <= value

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.trendtrack.io/v1/facets/categories"
{
  "requestId": "string",
  "pagination": {
    "limit": 100,
    "offset": 0,
    "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
    }
  ]
}
{
  "error": {
    "code": "missing_api_key",
    "message": "Provide an API key using Authorization: Bearer <api_key>.",
    "requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc",
    "details": {
      "validationErrors": [
        {
          "field": "query-string.limit",
          "location": "query-string",
          "expected": [
            "limit must not be greater than 100"
          ]
        }
      ]
    }
  }
}
{
  "error": {
    "code": "missing_api_key",
    "message": "Provide an API key using Authorization: Bearer <api_key>.",
    "requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc",
    "details": {
      "validationErrors": [
        {
          "field": "query-string.limit",
          "location": "query-string",
          "expected": [
            "limit must not be greater than 100"
          ]
        }
      ]
    }
  }
}
{
  "error": {
    "code": "missing_api_key",
    "message": "Provide an API key using Authorization: Bearer <api_key>.",
    "requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc",
    "details": {
      "validationErrors": [
        {
          "field": "query-string.limit",
          "location": "query-string",
          "expected": [
            "limit must not be greater than 100"
          ]
        }
      ]
    }
  }
}
{
  "error": {
    "code": "missing_api_key",
    "message": "Provide an API key using Authorization: Bearer <api_key>.",
    "requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc",
    "details": {
      "validationErrors": [
        {
          "field": "query-string.limit",
          "location": "query-string",
          "expected": [
            "limit must not be greater than 100"
          ]
        }
      ]
    }
  }
}

List public Shopify app facets

Returns grouped Shopify app IDs currently available for public API Shopify app filters on shops and ads.

Authorization

publicApiBearer
AuthorizationBearer <token>

Provide a Trendtrack Public API key using Authorization: Bearer <api_key>.

In: header

Query Parameters

search?string

Case-insensitive substring search over the facet label fields.

limit?integer
Default100
Range1 <= value <= 500
offset?integer
Default0
Range0 <= value

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.trendtrack.io/v1/facets/shopify-apps"
{
  "requestId": "string",
  "pagination": {
    "limit": 100,
    "offset": 0,
    "total": 325
  },
  "meta": {
    "valueType": "number",
    "filterUsage": [
      {
        "resource": "shops",
        "fields": [
          "categoryIds"
        ],
        "valueField": "id"
      }
    ]
  },
  "data": [
    {
      "id": 123,
      "label": "Klaviyo",
      "iconUrl": "https://cdn.shopify.com/app-store/listing_images/example/icon.png",
      "shopifyUrl": "https://apps.shopify.com/klaviyo-email-marketing",
      "usageCount": 9281
    }
  ]
}
{
  "error": {
    "code": "missing_api_key",
    "message": "Provide an API key using Authorization: Bearer <api_key>.",
    "requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc",
    "details": {
      "validationErrors": [
        {
          "field": "query-string.limit",
          "location": "query-string",
          "expected": [
            "limit must not be greater than 100"
          ]
        }
      ]
    }
  }
}
{
  "error": {
    "code": "missing_api_key",
    "message": "Provide an API key using Authorization: Bearer <api_key>.",
    "requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc",
    "details": {
      "validationErrors": [
        {
          "field": "query-string.limit",
          "location": "query-string",
          "expected": [
            "limit must not be greater than 100"
          ]
        }
      ]
    }
  }
}
{
  "error": {
    "code": "missing_api_key",
    "message": "Provide an API key using Authorization: Bearer <api_key>.",
    "requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc",
    "details": {
      "validationErrors": [
        {
          "field": "query-string.limit",
          "location": "query-string",
          "expected": [
            "limit must not be greater than 100"
          ]
        }
      ]
    }
  }
}
{
  "error": {
    "code": "missing_api_key",
    "message": "Provide an API key using Authorization: Bearer <api_key>.",
    "requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc",
    "details": {
      "validationErrors": [
        {
          "field": "query-string.limit",
          "location": "query-string",
          "expected": [
            "limit must not be greater than 100"
          ]
        }
      ]
    }
  }
}

List public technology facets

Returns supported technology slugs accepted by public API technology filters, enriched with metadata when available.

Authorization

publicApiBearer
AuthorizationBearer <token>

Provide a Trendtrack Public API key using Authorization: Bearer <api_key>.

In: header

Query Parameters

search?string

Case-insensitive substring search over the facet label fields.

limit?integer
Default100
Range1 <= value <= 500
offset?integer
Default0
Range0 <= value

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.trendtrack.io/v1/facets/technologies"
{
  "requestId": "string",
  "pagination": {
    "limit": 100,
    "offset": 0,
    "total": 325
  },
  "meta": {
    "valueType": "number",
    "filterUsage": [
      {
        "resource": "shops",
        "fields": [
          "categoryIds"
        ],
        "valueField": "id"
      }
    ]
  },
  "data": [
    {
      "slug": "shopify",
      "id": "04504d0b-df46-4f62-98b6-d4d9e14a2282",
      "name": "Shopify",
      "iconUrl": "shopify.svg",
      "categories": [
        "Ecommerce"
      ],
      "usageCount": 12042
    }
  ]
}
{
  "error": {
    "code": "missing_api_key",
    "message": "Provide an API key using Authorization: Bearer <api_key>.",
    "requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc",
    "details": {
      "validationErrors": [
        {
          "field": "query-string.limit",
          "location": "query-string",
          "expected": [
            "limit must not be greater than 100"
          ]
        }
      ]
    }
  }
}
{
  "error": {
    "code": "missing_api_key",
    "message": "Provide an API key using Authorization: Bearer <api_key>.",
    "requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc",
    "details": {
      "validationErrors": [
        {
          "field": "query-string.limit",
          "location": "query-string",
          "expected": [
            "limit must not be greater than 100"
          ]
        }
      ]
    }
  }
}
{
  "error": {
    "code": "missing_api_key",
    "message": "Provide an API key using Authorization: Bearer <api_key>.",
    "requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc",
    "details": {
      "validationErrors": [
        {
          "field": "query-string.limit",
          "location": "query-string",
          "expected": [
            "limit must not be greater than 100"
          ]
        }
      ]
    }
  }
}
{
  "error": {
    "code": "missing_api_key",
    "message": "Provide an API key using Authorization: Bearer <api_key>.",
    "requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc",
    "details": {
      "validationErrors": [
        {
          "field": "query-string.limit",
          "location": "query-string",
          "expected": [
            "limit must not be greater than 100"
          ]
        }
      ]
    }
  }
}

List public pixel facets

Returns pixel technology UUIDs currently available for public API pixel filters on shops and ads.

Authorization

publicApiBearer
AuthorizationBearer <token>

Provide a Trendtrack Public API key using Authorization: Bearer <api_key>.

In: header

Query Parameters

search?string

Case-insensitive substring search over the facet label fields.

limit?integer
Default100
Range1 <= value <= 500
offset?integer
Default0
Range0 <= value

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.trendtrack.io/v1/facets/pixels"
{
  "requestId": "string",
  "pagination": {
    "limit": 100,
    "offset": 0,
    "total": 325
  },
  "meta": {
    "valueType": "number",
    "filterUsage": [
      {
        "resource": "shops",
        "fields": [
          "categoryIds"
        ],
        "valueField": "id"
      }
    ]
  },
  "data": [
    {
      "id": "915edbd5-d4be-46da-9c35-da4519de040b",
      "slug": "facebook-pixel",
      "name": "Facebook Pixel",
      "iconUrl": "facebook.svg",
      "categories": [
        "Analytics"
      ],
      "usageCount": 6824
    }
  ]
}
{
  "error": {
    "code": "missing_api_key",
    "message": "Provide an API key using Authorization: Bearer <api_key>.",
    "requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc",
    "details": {
      "validationErrors": [
        {
          "field": "query-string.limit",
          "location": "query-string",
          "expected": [
            "limit must not be greater than 100"
          ]
        }
      ]
    }
  }
}
{
  "error": {
    "code": "missing_api_key",
    "message": "Provide an API key using Authorization: Bearer <api_key>.",
    "requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc",
    "details": {
      "validationErrors": [
        {
          "field": "query-string.limit",
          "location": "query-string",
          "expected": [
            "limit must not be greater than 100"
          ]
        }
      ]
    }
  }
}
{
  "error": {
    "code": "missing_api_key",
    "message": "Provide an API key using Authorization: Bearer <api_key>.",
    "requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc",
    "details": {
      "validationErrors": [
        {
          "field": "query-string.limit",
          "location": "query-string",
          "expected": [
            "limit must not be greater than 100"
          ]
        }
      ]
    }
  }
}
{
  "error": {
    "code": "missing_api_key",
    "message": "Provide an API key using Authorization: Bearer <api_key>.",
    "requestId": "5d93d8de-0f6d-46a4-bd10-2e519b7e96bc",
    "details": {
      "validationErrors": [
        {
          "field": "query-string.limit",
          "location": "query-string",
          "expected": [
            "limit must not be greater than 100"
          ]
        }
      ]
    }
  }
}

Get shop email stats

Previous Page

List public category facets

Next Page