Reference Data

Static lookup endpoints for country and language identifiers used in project metadata, and for resolving user objects returned by the API.

---

Countries

GET /countries

Returns all countries available as SEO project targets.

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://admin.trakk.ai/api/v1/countries

{ "data": [ { "id": 1, "label": "Sweden" }, { "id": 2, "label": "Norway" } ] }

GET /countries/

Path parameters

Parameter	Type	Description
country	integer	Country ID - the same id returned by GET /countries. No slugs or ISO codes are accepted.

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://admin.trakk.ai/api/v1/countries/1

{ "data": { "id": 1, "label": "Sweden" } }

Returns 404 if the country ID does not exist or is not applicable for SEO projects.

Field	Type	Description
id	integer	Country ID - use this in other API calls
label	string	Display name

---

Languages

GET /languages

Returns all languages available for generated content and reports.

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://admin.trakk.ai/api/v1/languages

{ "data": [ { "id": 3, "label": "Swedish" }, { "id": 4, "label": "English" } ] }

GET /languages/

Path parameters

Parameter	Type	Description
language	integer	Language ID - the same id returned by GET /languages. No locale codes (e.g. en, sv) are accepted.

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://admin.trakk.ai/api/v1/languages/3

{ "data": { "id": 3, "label": "Swedish" } }

Returns 404 if the language ID does not exist.

Field	Type	Description
id	integer	Language ID - use this in other API calls
label	string	Display name

---

Users

GET /users

Lists users visible to your token (your agency's users). Each user is returned in the same compact shape as user objects embedded in project and report responses - useful for resolving approved_by, managed_by, and similar fields.

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://admin.trakk.ai/api/v1/users

{
  "data": [
    {
      "id": 7,
      "name": "Jane Smith",
      "role": "Account Manager",
      "agency": { "id": 12, "name": "Digipartner Agency" }
    }
  ]
}

GET /users/

Path parameters

Parameter	Type	Description
user	integer	User ID - the same id returned by GET /users and the value found in embedded user objects (e.g. managing_user.id, created_by.id).

curl -H "Authorization: Bearer YOUR_API_TOKEN" \
  https://admin.trakk.ai/api/v1/users/7

Returns 404 if the user does not exist or is not visible to your token.

Field	Type	Nullable	Description
id	integer	No	User ID
name	string	No	Full name
role	string	Yes	Role display name
agency	{id, name}	Yes	The user's agency, or null if none