List formats
Every format (selfie with background, story slideshow, street interviews, …) that has videos, with the slug List videos takes and the format's page URL. Needs an account (any plan). Each request counts against the team's call allowance, shared with MCP; past it, a 402.
/api/v1/formatsAuthentication
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.
Response fields
formatsarray of FormatEach with
slug,name,video_count,url.
Responses
- 200
Every video format, with its slug and video count.
- 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);resolutionsays what to do and links the plans page. Body:Problem. - 403
The token lacks mcp:read. Body:
Problem. - 429
Rate limit exceeded; wait Retry-After seconds. Body:
Problem. - 500
The request failed on our side. Body:
Problem.