list_posts

List posts, newest scheduled time first, a page at a time — narrow by account, platform, status, time or words in the title/caption. Statuses: scheduled (waiting in mixetape, editable with update_post), publishing (uploading), uploaded (on the platform, private until its time), published (live; change with edit_published_post), failed, cancelled. Returns { posts, nextCursor }; pass nextCursor back as cursor for the next page (null on the last). Needs the read permission. Also available as the MCP tool list_posts.

POST

https://mixetape.com/api/v1/tools/list_posts

View as Markdown

Authorisation

apiKeyHTTPrequired

Request bodyJSONrequired

accountIdoptionalarray ofstring
Only posts on these accounts (list_accounts ids)
provideroptionalarray ofstring
Only posts on these platforms, e.g. youtube, instagram
statusoptionalarray ofstring
Only these statuses
searchoptionalstring
Words in the title, caption or description (case-insensitive)
fromoptionalstring
ISO time; scheduled at or after
tooptionalstring
ISO time; scheduled at or before
limitoptionalnumber
Posts per page: default 50, max 500
cursoroptionalstring
nextCursor from the previous page

Returns

200

The tool's result.

JSON

resultunknownrequired
What the tool returns

400

The request is invalid; error says why.

JSON

errorstringrequired
What went wrong, in plain words

401

No valid API key.

JSON

errorstringrequired
What went wrong, in plain words

403

The key lacks the permission this needs.

JSON

errorstringrequired
What went wrong, in plain words

404

Not found, or not yours.

JSON

errorstringrequired
What went wrong, in plain words

curl --request POST \ --url https://mixetape.com/api/v1/tools/list_posts \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "accountId": [ "string" ], "provider": [ "string" ], "status": [ "string" ], "search": "string", "from": "string", "to": "string", "limit": 0, "cursor": "string" } '