List posts

Posts, newest scheduled first, a page at a time; pass nextCursor back as cursor for the next page. Needs the read permission.

GET

https://mixetape.com/api/v1/posts

View as Markdown

Authorisation

apiKeyHTTPrequired

Query parameters

accountIdoptionalstring
Comma-separated account ids: only posts on these accounts
provideroptionalstring
Comma-separated platforms, e.g. youtube,instagram
searchoptionalstring
Words in the title, caption or description (case-insensitive)
cursoroptionalstring
nextCursor from the previous page
statusoptionalstring
Comma-separated statuses, e.g. scheduled,failed
fromoptionalstring
ISO time; scheduled at or after

format: date-time
tooptionalstring
ISO time; scheduled at or before

format: date-time
limitoptionalinteger
Default 100, max 500

maximum: 500
Default: 100

Returns

200

A page of posts.

JSON

postsarray ofobjectrequired
16 properties
- idstringrequired
- accountIdstringrequired
- providerstringrequired
- mediaUrlstringrequired
- scheduledAtstringrequired
  When it goes live
  
  format: date-time
- statusscheduledorpublishingoruploadedorpublishedorfailedorcancelledrequired
- captionoptionalstring | null
- metadataoptionalobject | null
  The platform's own fields
- leadMinutesoptionalinteger | null
  Uploaded or prepared this long before scheduledAt
- platformPostIdoptionalstring | null
- platformUrloptionalstring | null
- erroroptionalstring | null
  Why it failed, when it did
- attemptsoptionalinteger
- publishedAtoptionalstring | null
  format: date-time
- createdAtoptionalstring
  format: date-time
- updatedAtoptionalstring
  format: date-time
nextCursorstring | nullrequired
Pass as cursor for the next page; null on the last

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

{ "posts": [ { "id": "string", "accountId": "string", "provider": "string", "mediaUrl": "string", "caption": "string", "metadata": {}, "scheduledAt": "2019-08-24T14:15:22Z", "leadMinutes": 0, "status": "scheduled", "platformPostId": "string", "platformUrl": "string", "error": "string", "attempts": 0, "publishedAt": "2019-08-24T14:15:22Z", "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" } ], "nextCursor": "string" }