Skip to content

List followed videos

The newest library videos from the creators the workspace follows, newest to join the library first, with the creators followed (handle, platform, app page). Page with offset and next_offset. A workspace that follows nobody answers no videos and a note saying how to follow one. Covers the creators' videos in this library, not a live feed of their accounts. Same answer as the MCP tool list_followed_videos. Each request counts against the team's call allowance, shared with MCP; past it, a 402.

get/api/v1/following/videos

Authentication

OAuth token, API key or signed-in session, sent as Authorization: Bearer <token> (a session rides on its cookie). An OAuth token needs mcp:read. See authentication.

Query parameters

  • limitinteger

    How many, 1 to 50. Default 20.

  • offsetinteger

    The previous page's next_offset; null there means there is no further page. Default 0.

  • workspacestring

    Optional: the workspace's id or exact name, from List workspaces. Without it, the current workspace (the one the account last opened in the app). Every answer names the workspace it acted in. 1 to 120 characters.

Response fields

  • videosarray of VideoCard

    Each with id, hook, description, platform, language, hook_tactic, tone, visual_formats, creator, niche, formats, views, viral_factor, engagement_rate, posted_at, cover, url, original_url.

  • next_offsetinteger or null

    Pass as offset for the next page; null when there is none.

  • creatorsarray of object

    The creators the workspace follows.

  • notestring

    When the workspace follows nobody, how to follow a creator.

  • urlstring (uri)

    The app's Track page.

  • workspaceobject

    The workspace the request read or changed.

Responses

  • 200

    New videos from the creators a workspace follows. Body: FollowedVideoList.

  • 400

    A parameter is malformed or not supported, or workspace is empty, repeated or too long. Body: Problem.

  • 401

    No account: send an API key, an OAuth access token or a session cookie. WWW-Authenticate names the protected-resource metadata. Body: Problem.

  • 402

    The team's call allowance is used up (quota_exceeded), or the account has no plan and so no calls (no_plan), or an account with no plan asked past a list's first page (plan_limit); resolution says what to do and links the plans page. Body: Problem.

  • 403

    The token lacks mcp:read. workspace_locked: the workspace is past the plan's workspaces, so nothing was read or changed; use an open one (List workspaces marks the locked ones). Body: Problem.

  • 404

    No such niche, format, brand, creator, page or endpoint. workspace_not_found: the organization has no workspace with that id or name (List workspaces lists them). Body: Problem.

  • 429

    Rate limit exceeded; wait Retry-After seconds. Body: Problem.

  • 500

    The request failed on our side. Body: Problem.