List YouTube Summaries — MentionBird.ai API

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). Defaults to 30 days ago.
end_date	string	ISO end date (YYYY-MM-DD). Defaults to today.
search	string	Substring match on video or channel title.
limit	integer default 20	Max rows (default 20, max 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 `limit`.

Example request

curl -H "Authorization: Bearer $MENTIONBIRD_API_KEY" \
  "https://app.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": 30,
    "end": "2026-09-24",
    "start": "2026-08-26"
  },
  "filters_applied": {
    "brand": "Acme",
    "end_date": "2026-09-24",
    "limit": 20,
    "offset": 0,
    "search": null,
    "start_date": "2026-08-26"
  },
  "has_more": false,
  "items": [
    {
      "channel_title": "Acme",
      "credits_charged": 5,
      "domain": "youtube.com",
      "key_points": [
        "Start from the sales process"
      ],
      "summarized_at": "2026-09-24T13:48:51.039063+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 — plan lacks API access, or key is read-only.
404: Not found — the brand, prompt or resource does not exist.
405: Method not allowed.
500: Internal error — logged; retry is safe for reads.