Brands

Retrieves brands available to the user for monitoring brand-related scans. Supports filtering by visibility level and searching by name.

GET /v1/brands

Brands

cURL

curl --request GET \
  --url https://api.urldna.io/v1/brands \
  --header 'authorization: <authorization>'

200

[
  {
    "id": "<string>",
    "name": "<string>",
    "private_brand": true,
    "category": "<string>"
  }
]

Headers

authorization · string · required

Query Parameters

query · string | null

Search query to filter brands.

max_results · integer · default: 20

Maximun number of brands retreived per page

Required range: 1 <= x <= 20

page · integer · default: 1

Page number for pagination (1-indexed).

Required range: x >= 1

Response

200

application/json

Successful Response

id · string · required

Unique brand identifier.

name · string · required

The official name of the brand.

private_brand · boolean · required

When true, brand is visible only to the creating user.

visibility · enum<string> · required

Defines the access level of the brand data. 'PREMIUM' brands require a subscription to access full intelligence, while 'FREE' brands are publicly available.

Available options: PREMIUM, FREE

category · string | null

The industry sector or vertical the brand belongs to. This is a generic classification such as 'Retail & E-commerce', 'FinTech, Crypto & Blockchain', or 'Technology & Telecom'.