Skip to content
MentionBird.ai
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.