Get Brands

List brands, manage markets (geographic regions), and update aliases (alternate brand names).

Requires authentication

60 req/min

List Brands

GET/get-brands

Returns all brands that your API key has access to. This includes brands you own and brands you've been invited to as a team member.

Query Parameters

brand_idstring

Filter to a single brand by UUID

includestring

Comma-separated: "markets", "aliases"

Without the include parameter, brands are returned with basic fields only. Add include=markets,aliases to embed sub-resources in the response.

Rate limit: 60 requests/minute for GET. Write operations (POST, PUT, DELETE) are limited to 30 requests/minute.

Response Fields

Each brand in the response includes these fields:

Brand Object

idstring

Unique brand identifier (UUID)

namestring

Display name of the brand

websitestring

Brand website URL

activeboolean

Whether the brand is active

rolestring

Your role: "owner", "editor", or "viewer"

locationstring

Primary market ISO-2 country code (e.g. "US", "GB"). Null if the brand is not geo-pinned (global mode).

location_regionstring

Primary market region/state, if set

location_citystring

Primary market city, if set

marketsarray

Markets (only when include=markets). Array of market objects.

aliasesarray

Brand aliases (only when include=aliases). Array of strings.

Using Brand IDs

The id field is a unique identifier that you'll use in other API calls. Use it as the brand_id parameter:

GET /get-scores?brand_id=75ffdeb9-0924-4ff9-8ded-c2470d73d224

Markets

Markets represent geographic regions where your brand is tracked. Each brand has one primary market and can have additional markets depending on your plan.

Market Object

idstring

Market UUID

brand_idstring

Parent brand UUID

locationstring

ISO-2 country code (e.g. "US", "GB", "DE")

is_primaryboolean

Whether this is the primary market

activeboolean

Whether the market is active

created_atstring

ISO 8601 creation timestamp

Add Market

POST/get-brands/markets

Body Parameters

brand_idstringrequired

Brand UUID

locationstringrequired

ISO-2 country code (e.g. "US", "GB", "DE")

market_namestring

Optional display name for the market

The first market added to a brand automatically becomes the primary market. Use standard ISO-2 country codes (US, GB, DE, FR, JP, etc.).

Remove Market

DELETE/get-brands/markets

Query Parameters

brand_idstringrequired

Brand UUID

market_idstringrequired

Market UUID to remove

You cannot remove the primary market. Change the primary market in your brand settings first.

Market Examples

Add Market

1curl -X POST 'https://api.trakkr.ai/get-brands/markets' \
2  -H 'Authorization: Bearer $TRAKKR_API_KEY' \
3  -H 'Content-Type: application/json' \
4  -d '{"brand_id": "75ffdeb9-0924-4ff9-8ded-c2470d73d224", "location": "GB"}'

1{
2  "id": "m9a8b7c6-d5e4-3210-abcd-ef0987654321",
3  "brand_id": "75ffdeb9-0924-4ff9-8ded-c2470d73d224",
4  "location": "GB",
5  "is_primary": false,
6  "active": true,
7  "created_at": "2026-03-07T10:00:00Z"
8}

Primary Location

Set a brand's primary market in one call. This pins the brand's home country (and optionally a region/city) so competitor analysis and AI search results are measured against the right market. A brand with no location runs in global mode, which can skew its competitor set toward US results.

PUT/get-brands/location

Body Parameters

brand_idstringrequired

Brand UUID

countrystringrequired

ISO-2 country code (e.g. "GB", "US", "DE"). The alias "UK" and full country names are also accepted.

location_regionstring

Optional region/state to narrow the market

location_citystring

Optional city to narrow the market further

location_dataseo_codenumber

Optional DataForSEO location code for precise sub-country targeting

Use standard ISO-2 country codes (US, GB, DE, FR, JP, etc.). The common aliasUK and full country names likeUnited Kingdom are also accepted. Updating the primary location reuses the brand's existing primary market — it does not consume an extra-market add-on.

Set Primary Location

1curl -X PUT 'https://api.trakkr.ai/get-brands/location' \
2  -H 'Authorization: Bearer $TRAKKR_API_KEY' \
3  -H 'Content-Type: application/json' \
4  -d '{"brand_id": "75ffdeb9-0924-4ff9-8ded-c2470d73d224", "country": "GB"}'

1{
2  "brand_id": "75ffdeb9-0924-4ff9-8ded-c2470d73d224",
3  "location": "GB",
4  "location_region": null,
5  "location_city": null,
6  "location_dataseo_code": null,
7  "primary_market": {
8    "id": "m1a2b3c4-d5e6-7890-abcd-ef1234567890",
9    "brand_id": "75ffdeb9-0924-4ff9-8ded-c2470d73d224",
10    "location": "GB",
11    "is_primary": true,
12    "active": true,
13    "created_at": "2026-05-28T10:00:00Z"
14  }
15}

Aliases

Aliases are alternate names for your brand that get aggregated into your visibility score. For example, "Nike" might also appear as "Nike Inc", "Nike.com", or "Nike Running" in AI responses.

PUT/get-brands/aliases

Body Parameters

brand_idstringrequired

Brand UUID

aliasesstring[]required

Array of alias strings

This replaces all existing aliases. To add an alias, include the existing aliases plus the new one. Duplicates are automatically removed.

Aliases Examples

Update Aliases

1curl -X PUT 'https://api.trakkr.ai/get-brands/aliases' \
2  -H 'Authorization: Bearer $TRAKKR_API_KEY' \
3  -H 'Content-Type: application/json' \
4  -d '{"brand_id": "75ffdeb9-0924-4ff9-8ded-c2470d73d224", "aliases": ["Nike Inc", "Nike.com", "Nike Running"]}'

1{
2  "success": true,
3  "brand_id": "75ffdeb9-0924-4ff9-8ded-c2470d73d224",
4  "aliases": ["Nike Inc", "Nike.com", "Nike Running"]
5}

Next Steps

After getting your brand IDs, you can:

Get visibility scores - See your brand's AI visibility metrics
Competitor analysis - Compare against competitors
Get citations - See which URLs are cited
Crawler analytics - See which AI crawlers visit your site

Code example

List Brands

1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-brands?include=markets,aliases'

1{
2  "brands": [
3    {
4      "id": "75ffdeb9-0924-4ff9-8ded-c2470d73d224",
5      "name": "Nike",
6      "website": "https://nike.com",
7      "active": true,
8      "role": "owner",
9      "aliases": ["Nike Inc", "Nike.com", "Nike Running"],
10      "markets": [
11        {
12          "id": "m1a2b3c4-d5e6-7890-abcd-ef1234567890",
13          "brand_id": "75ffdeb9-0924-4ff9-8ded-c2470d73d224",
14          "location": "US",
15          "is_primary": true,
16          "active": true,
17          "created_at": "2026-01-15T10:00:00Z"
18        },
19        {
20          "id": "m9a8b7c6-d5e4-3210-abcd-ef0987654321",
21          "brand_id": "75ffdeb9-0924-4ff9-8ded-c2470d73d224",
22          "location": "GB",
23          "is_primary": false,
24          "active": true,
25          "created_at": "2026-02-20T14:30:00Z"
26        }
27      ]
28    }
29  ]
30}

List Brands

1curl -H 'Authorization: Bearer $TRAKKR_API_KEY' \
2  'https://api.trakkr.ai/get-brands?include=markets,aliases'

1{
2  "brands": [
3    {
4      "id": "75ffdeb9-0924-4ff9-8ded-c2470d73d224",
5      "name": "Nike",
6      "website": "https://nike.com",
7      "active": true,
8      "role": "owner",
9      "aliases": ["Nike Inc", "Nike.com", "Nike Running"],
10      "markets": [
11        {
12          "id": "m1a2b3c4-d5e6-7890-abcd-ef1234567890",
13          "brand_id": "75ffdeb9-0924-4ff9-8ded-c2470d73d224",
14          "location": "US",
15          "is_primary": true,
16          "active": true,
17          "created_at": "2026-01-15T10:00:00Z"
18        },
19        {
20          "id": "m9a8b7c6-d5e4-3210-abcd-ef0987654321",
21          "brand_id": "75ffdeb9-0924-4ff9-8ded-c2470d73d224",
22          "location": "GB",
23          "is_primary": false,
24          "active": true,
25          "created_at": "2026-02-20T14:30:00Z"
26        }
27      ]
28    }
29  ]
30}