Skip to content
/
Brands

Brands

Request

Returns brands that can be used in the brands filter on the Discovery API, to find creators who have worked with a brand or mentioned it in their content. Each entry has the brand's username, display name (full_name) and a normalised name (cleaned).

What you get

  • Results come in pages, not a complete list. Add your limit to offset for the next page — the full limit, even if fewer come back, or you will get repeats. Short pages are normal, because duplicates and brands with a social network in the name are dropped after paging, so keep going until you get an empty response.
  • Pass the username value into the brands filter on the Discovery API. The filter matches against username, so sending a display name returns a 400.

Searching

  • By default, search matches a brand's username exactly. Use it to confirm a username before filtering on it.
  • Add exact=false to match part of a brand's cleaned name instead — the normalised value returned with each entry, not full_name. For example, ?search=kfc&exact=false returns "KFC UK & Ireland", which ?search=kfc on its own does not.
  • cleaned drops accents, punctuation and emoji, transliterates non-Latin scripts, and is often shorter than the display name: "L'Oréal Professionnel Paris" is Loreal, "Walt Disney World" is Disney. Match against the cleaned values you get back, not the display name.
  • search is matched case-insensitively, and the wildcard characters *, ? and \ are ignored.

Credits

  • 0 credits. This endpoint does not deduct credits.
Security
Bearer
Query
searchstring

The brand's username. Must match exactly unless you set exact=false.

Default:""
offsetinteger, >= 0

Where to start in the results. Add your limit for the next page.

Default:0
limitinteger, [ 1 .. 100 ]

How many brands to return per page.

Default:50
exactboolean

When true (the default), search must match a brand's username exactly. Set to false to match part of the brand's normalised cleaned name instead, which is not the same as its display name.

Default:true
GET
/public/v1/discovery/classifier/brands/
curl -i -X GET \
  'https://api-dashboard.influencers.club/public/v1/discovery/classifier/brands/?search=&offset=0&limit=50&exact=true' \
  -H 'Authorization: Bearer <YOUR_API_KEY_HERE>'

Responses

Bodyapplication/json
Array [
full_namestringrequired

Display name, e.g. "L'Oréal Professionnel Paris".

cleanedstringrequired

Normalised name, without accents, punctuation or emoji and often shorter than the display name, e.g. "Loreal". This is what exact=false searches.

usernamestringrequired

The value to use in the brands filter on the Discovery API.

]
Response
[
  {
    "full_name": "string",
    "cleaned": "string",
    "username": "string"
  }
]