Browse the documentation
List YouTube Summaries
Cited YouTube videos this brand has already paid to summarize. With no dates, every summary the brand owns is listed.
GET
/youtube/summaries
Query parameters
| Name | Type | Description |
|---|---|---|
| brand required | string | Tracked brand name, exactly as returned by listTrackedBrands. |
| start_date | string | ISO start date (YYYY-MM-DD): only summaries completed on or after this day. Omit for no lower bound; with neither date, every summary the brand owns is listed. No maximum span. |
| end_date | string | ISO end date (YYYY-MM-DD): only summaries completed on or before this day. Omit for no upper bound. |
| search | string | Substring match on video or channel title. |
| limit |
integer
default 20 |
Rows per page. A value over the maximum reads as the maximum and sets filters_applied.limit_clamped. Allowed: 1–100. |
| offset |
integer
default 0 |
Rows to skip — the cursor for reading past `limit`. Default 0. While `has_more` is true, repeat with offset advanced by `returned_count`. Allowed: 0 or more. |
Example request
curl -H "Authorization: Bearer $MENTIONBIRD_API_KEY" \
"https://api.mentionbird.ai/api/v1/youtube/summaries?brand=Acme"
Example response
Recorded from a live call against a demo workspace, so the shape is exactly what the endpoint returns.
{
"date_range": {
"days": null,
"end": null,
"start": null
},
"filters_applied": {
"brand": "Acme",
"end_date": null,
"limit": 20,
"offset": 0,
"search": null,
"start_date": null
},
"has_more": false,
"items": [
{
"channel_title": "Acme",
"credits_charged": 5,
"domain": "youtube.com",
"key_points": [
"Start from the sales process"
],
"summarized_at": "2026-11-18T08:49:45.554264+00:00",
"summary_excerpt": "A buyer's walkthrough of CRM selection criteria.",
"topics": [
"crm"
],
"url": "https://youtube.com/watch?v=aqz-KE-bpKQ",
"video_duration_s": 612,
"video_title": "How to Choose a CRM"
}
],
"returned_count": 1,
"total_count": 1
}
Responses
- 200
- YouTube summaries.
- 400
- Validation error — check the message in `error.message`.
- 401
- Unauthorized — missing, invalid or revoked bearer token.
- 403
- Forbidden — the plan lacks API access, the key is read-only, or addTrackedBrand would pass the tracked-brand limit.
- 404
- Not found — the brand, prompt or resource does not exist.
- 405
- Method not allowed.
- 429
- Too many requests — over the key's per-minute or per-day limit. Wait the seconds in the `Retry-After` header, then retry.
- 500
- Internal error — logged; retry is safe for reads.