---
title: "List Embed Session Countries"
method: GET
path: "/embed/sessions/{embedId}/countries"
tags: ["Media Embed"]
---

# List Embed Session Countries

`GET /embed/sessions/{embedId}/countries`

## Request

- Base URL: `https://api.speakai.co/v1`
- URL: `https://api.speakai.co/v1/embed/sessions/{embedId}/countries`
- Auth: API key in header `x-speakai-key` and API key in header `x-access-token`

Count sessions by country for one embed, most sessions first. Sessions with no known country are left out. Use a returned `country` value as the `country` filter on the session list. Members without access to all folders only see embeds for media and folders they can open. Any other embed, or an embed that is deleted or in another workspace, returns 404.

## Path parameters

- `embedId` string, required

## Query parameters

- `from` string, date-time
- `to` string, date-time
- `traffic` 'all' | 'people' | 'bots'
- `includeOwner` boolean
- `includeLegacy` boolean

## Response `200`

OK

- object
  - `status` 'success'
  - `data` object
    - `countries` object[]
      - `country` string: Country name.
      - `sessions` integer

## Other responses

- `400`: A query parameter failed validation
- `404`: Embed not found

## Changes

- **2026-10-19** `52d777e6d46e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/speakai/apis/speak-ai-api/changes/embed/sessions/:embedId/countries/get.md)

---

[API](https://skmtc.dev/speakai/apis/speak-ai-api.md) · [All operations](https://skmtc.dev/speakai/apis/speak-ai-api/llms.txt) · [OpenAPI document](https://skmtc.dev/speakai/apis/speak-ai-api/revisions/52d777e6d46e?raw)