Skip to content
Tailwind API

List posts

GET
/v1/accounts/{accountId}/posts

List scheduled posts for an account. Filter by status to get drafts, queued, sent, or uploading posts.

Authorizations

Parameters

Path Parameters

accountId
required
string

Pinterest account ID

Query Parameters

status
string
default: queued
Allowed values: draft queued sent uploading

Filter by post status

cursor
string

Pagination cursor from previous response

limit
integer
default: 50 >= 1 <= 100

Number of results to return (1-100)

startDate
string format: date-time

Filter posts scheduled after this date (ISO 8601). Required for sent/uploading status.

endDate
string format: date-time

Filter posts scheduled before this date (ISO 8601). Required for sent/uploading status.

Responses

200

List of posts

object
data
object
posts
Array<object>
object
id

Post ID

string
status

Post status

string
Allowed values: draft queued sent uploading
mediaUrl

URL of the media file

string
mediaType

Type of media

string
Allowed values: image video
title

Pin title

string
nullable
description

Pin description

string
nullable
url

Destination URL

string
nullable
boardId

Target board ID

string
nullable
altText

Alt text for accessibility

string
nullable
sendAt

Scheduled send time (Unix timestamp)

integer
nullable
sentAt

Actual send time (Unix timestamp)

integer
nullable
createdAt

Creation time (Unix timestamp)

integer
pinId

Pinterest pin ID (only present after publishing)

string
nullable
cursor

Cursor for next page, null if no more results

string
nullable
meta
object
requestId

Unique request ID for debugging

string

400

Invalid request

object
error
object
code

Error code

string
message

Error message

string
meta
object
requestId

Unique request ID for debugging

string
Example
{
  "error": {
    "code": "BAD_REQUEST",
    "message": "Invalid request body"
  },
  "meta": {
    "requestId": "abc123"
  }
}

401

Authentication required or invalid API key

object
error
object
code

Error code

string
message

Error message

string
meta
object
requestId

Unique request ID for debugging

string
Example
{
  "error": {
    "code": "UNAUTHORIZED",
    "message": "Invalid API key"
  },
  "meta": {
    "requestId": "abc123"
  }
}

404

Resource not found

object
error
object
code

Error code

string
message

Error message

string
meta
object
requestId

Unique request ID for debugging

string
Example
{
  "error": {
    "code": "NOT_FOUND",
    "message": "Account not found"
  },
  "meta": {
    "requestId": "abc123"
  }
}