Skip to main content
GET
/
v1
/
brands
Brands
curl --request GET \
  --url https://api.urldna.io/v1/brands \
  --header 'authorization: <authorization>'
[
  {
    "id": "<string>",
    "name": "<string>",
    "private_brand": true,
    "visibility": "PREMIUM",
    "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

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'.