Post Streams

Endpoints:

GET /posts/streams/me

Token: user

Scope: stream

The authenticated user's stream of posts from their followers and themself.

Example
curl "https://api.pnut.io/v0/posts/streams/me?count=2" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "X-Pretty-Json: 1"

Returns a list of posts.

"call for example 1"

GET /posts/streams/unified

Token: user

Scope: stream

A combined Personal Stream including the authenticated user's mentions.

Example
curl "https://api.pnut.io/v0/posts/streams/unified" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "X-Pretty-Json: 1"

Returns a list of posts.

"call for example 2"

GET /users/{user_id}/mentions

Scope: none

Posts mentioning the specified user.

URL Parameters

Name Description
user_id Posts mention this user
Example
curl "https://api.pnut.io/v0/users/9/mentions?count=2" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "X-Pretty-Json: 1"

Returns a list of posts.

"call for example 3"

GET /users/{user_id}/posts

Scope: none

Posts created by the specified user.

If a user looks up a user they blocked or muted, the posts will still be retrieved.

URL Parameters

Name Description
user_id Posts created by this user
Example
curl "https://api.pnut.io/v0/users/9/posts?count=2" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "X-Pretty-Json: 1"

Returns a list of posts.

"call for example 4"

GET /posts/streams/global

Scope: none

A stream of all users' public posts.

Example
curl "https://api.pnut.io/v0/posts/streams/global?count=2" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "X-Pretty-Json: 1"

Returns a list of posts.

"call for example 5"

GET /posts/tags/{tag}

Scope: none

A stream of all posts that include the specified tag.

URL Parameters

Name Description
tag The string tag that all posts should include
Example
curl "https://api.pnut.io/v0/posts/tags/MondayNightDanceParty?count=2" \
    -H "Authorization: Bearer ${ACCESS_TOKEN}" \
    -H "X-Pretty-Json: 1"

Returns a list of posts.

"call for example 6"