AdnovaDocs
Inspiration

Search brands

Discover brands in the Adnova inspiration index by name. Returns the matching brands — brandId, name, logo, platform, and ad count — which you can pass as filter.brandId to Discover ads.

POST
/discover/brands

Authentication

authentication
api-key<token>

Create an API key from the Adnova dashboard (Account integrations). Pass the key value in the api-key request header on every call.

In: header

Header Parameters

x-org-id*string

Organization ULID that scopes the request.

x-workspace-id*string

Workspace ULID that scopes the request.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.adnova.ai/inspiration/v1/discover/brands" \  -H "x-org-id: 01K8Z23F1QQ1ZA93B8WYBS40GH" \  -H "x-workspace-id: 01KJ7S42FHQTCTKD6KKFJKTZBC" \  -H "Content-Type: application/json" \  -d '{    "brandName": "dell"  }'
{
  "data": [
    {
      "brandId": "01HMY2SGGD5ZCEMWN94N6HMMGB",
      "brand": "Dell Technologies",
      "logo": "string",
      "platform": "facebook",
      "adsCount": 4146,
      "source": "autocomplete"
    }
  ]
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}
{
  "error": {
    "code": "RATE_LIMIT_EXCEEDED",
    "message": "Too many requests."
  }
}
{
  "error": {
    "code": "string",
    "message": "string"
  }
}