Skip to main content
GET
List user posts

Authorizations

Authorization
string
header
required

Link access token for one Sandbox, Test, or Live authorization.

x-linked-account-id
string
header
required

Selects one of the authorization's linked accounts via the x-linked-account-id header.

Headers

x-linked-account-id
string
required

The linked account to use. The user must have shared it with your app. A missing account returns linked_account_required; an account outside your access returns linked_account_not_granted.

Example:

"conn_example123"

Path Parameters

userId
string | null

User ID (numeric or username)

Minimum string length: 1

Query Parameters

limit
integer
default:10

Number of posts to return (1-50)

Required range: 1 <= x <= 50
media
enum<string>

Filter to posts with media. Use any for all media posts, or photo/video for a specific media type.

Available options:
any,
photo,
video
sortBy
enum<string>
default:publish_date

Sort posts by: publish_date, tips, or favorites_count

Available options:
publish_date,
tips,
favorites_count
sortDirection
enum<string>
default:desc

Sort direction

Available options:
asc,
desc
pinned
boolean
default:false

Include pinned posts

onlyCanView
boolean

Only include posts viewable by the authenticated account

cursor
string

Publish time cursor from the previous response. Also accepts ISO datetime, seconds, or seconds.fraction.

Pattern: ^\d+\.\d{6}$

Response

Successful response

items
object[]
required
page
object
required