---
title: "Takes on one topic"
method: GET
path: "/public/creators/{slug}/topics/{topic_id}/takes.json"
---

# Takes on one topic

`GET /public/creators/{slug}/topics/{topic_id}/takes.json`

## Request

- Base URL: `https://api.agentcdn.com`
- URL: `https://api.agentcdn.com/public/creators/{slug}/topics/{topic_id}/takes.json`
- Auth: none declared

Each take is one speaker's point on the topic, anchored by video id and a time range, in play order across episodes. By default a point one speaker made in several episodes appears once.

## Path parameters

- `slug` string, required
- `topic_id` string, required

## Query parameters

- `repeats` 'one_per_repeat_group' | 'all'

## Response `200`

The topic and its takes (topic-map/1).

- TopicTakesResponse
  - `schema_version` 'topic-map/1', required
  - `creator_slug` string, required
  - `topic` object, required
    - `topic_id` string, required
    - `label` string, required
    - `description` string, required
    - `aliases` string[], required
    - `rank` integer, required
    - `moment_count` integer, required
    - `video_count` integer, required
    - `speaker_count` integer, required
    - `repeat_group_count` integer, required
    - `total_duration_ms` integer, required
  - `repeat_filter` 'one_per_repeat_group' | 'all', required
  - `omitted_repeat_count` integer, required
  - `takes` object[], required
    - `take_id` string, required
    - `topic_id` string, required
    - `video_id` string, required
    - `youtube_video_id` string, nullable, required
    - `video_title` string, required
    - `speaker_label` string, required
    - `speaker_name` string, nullable, required
    - `start_ms` integer, required
    - `end_ms` integer, required
    - `take` string, required
    - `angle` string, required
    - `stance` 'for' | 'against' | 'nuanced' | 'explains', required
    - `repeat_group_id` string, nullable, required
    - `repeat_group_size` integer, required
    - `is_representative` boolean, required

## Other responses

- `400`: The repeats value was not recognized. Error codes: invalid_query_parameter.
- `404`: Unknown creator, or no such topic for this creator. Error codes: creator_not_found, topic_not_found.
- `429`: Rate limited. Retry after the retry-after header (seconds). Error codes: agent_rate_limited.

---

[API](https://skmtc.dev/agentcdn/apis/agentcdn-public-arv-api.md) · [All operations](https://skmtc.dev/agentcdn/apis/agentcdn-public-arv-api/llms.txt) · [OpenAPI document](https://skmtc.dev/agentcdn/apis/agentcdn-public-arv-api/revisions/f70f6777f2e5?raw)