list_amazon_brands

Amazon Ads Read

List the Brand Registry entities for an Amazon profile and return each brand's brandEntityId

Endpoint

POST https://api.adspirer.ai/api/v1/tools/list_amazon_brands/execute

Headers

Authorization: Bearer sk_live_... — your Adspirer API key (required)
Content-Type: application/json (required)
Idempotency-Key: <uuid> — recommended for write operations to make retries safe

Description

List the Brand Registry entities for an Amazon profile and return each brand's brandEntityId. SELLERS must pass this brandEntityId when creating Sponsored Brands campaigns (including SB video) — Amazon requires it and it cannot be obtained any other way. Call this first if a Sponsored Brands create asks for brand_entity_id. Each profile/marketplace has its own value.

Request body

All tool arguments are wrapped in an arguments object.

Field	Type	Description
`profile_id`	`string` optional	Amazon Ads profile ID (advertiser account). Omit to use the user's selected account. Find IDs with list_amazon_profiles.
`brand_type_filter`	`string` optional	Optional: 'brandRegistry' or 'bookAuthor' (comma-separated). Omit to return all brands for the profile.

Example request

{
  "arguments": {
    "profile_id": "string",
    "brand_type_filter": "string"
  }
}

Example responses

200 — Success

{
  "success": true,
  "data": {
    "text": "(tool-specific textual output for list_amazon_brands)",
    "quota": {
      "used": 42,
      "limit": 150,
      "tier": "plus",
      "period_end": "2026-05-01"
    }
  },
  "tool": "list_amazon_brands"
}

400 — Tool-level error (bad arguments / multi-account selection)

{
  "success": false,
  "error": "You have 25 meta_ads accounts connected. Please specify which account to use by passing the ad_account_id parameter:\n  - Acme Holdings (ad_account_id=\"act_123456789\")\n  - Acme EU (ad_account_id=\"act_987654321\")",
  "is_error": true,
  "tool": "list_amazon_brands"
}

402 — Quota exhausted

{
  "success": false,
  "error": "\ud83d\udea8 Monthly limit reached (150/150 tool calls on Plus tier).\nUpgrade to Pro at https://adspirer.ai to keep building.",
  "is_error": true,
  "tool": "list_amazon_brands",
  "quota": {
    "used": 150,
    "limit": 150,
    "tier": "plus",
    "period_end": "2026-05-01",
    "upgrade_url": "https://adspirer.ai"
  }
}

Try it live

Interactive: Swagger UI

Machine-readable: OpenAPI 3.1 spec · llms-full.txt

More tools: Amazon Ads · All tools

Adspirer REST API — get an API key at adspirer.ai/keys · adspirer.ai