Timelines¶
GET /api/v1/timelines/home¶
Statuses from accounts the user follows.
Returns array of Status
Resource information¶
Response format | JSON |
Requires authentication | Yes |
Requires user | Yes |
Scope | read read:statuses |
Available since | 0.0.0 |
Parameters¶
Name | Description | Required | Default |
---|---|---|---|
max_id |
Return results older than ID | Optional | |
since_id |
Return results newer than ID | Optional | |
min_id |
Return results immediately newer than ID | Optional | |
limit |
Maximum number of results | Optional | 20 |
GET /api/v1/conversations¶
Conversations for an account
Returns array of Conversation
Resource information¶
Response format | JSON |
Requires authentication | Yes |
Requires user | Yes |
Scope | read read:statuses |
Available since | 2.6.0 |
Parameters¶
Name | Description | Required | Default |
---|---|---|---|
max_id |
Return results older than ID | Optional | |
since_id |
Return results newer than ID | Optional | |
min_id |
Return results immediately newer than ID | Optional | |
limit |
Maximum number of results | Optional | 20 |
Pagination¶
This API returns Link headers containing links to the next and previous page. However, the links can also be constructed dynamically using query params and id
values.
GET /api/v1/timelines/public¶
Public statuses known to the server.
Returns array of Status
Resource information¶
Response format | JSON |
Requires authentication | No |
Requires user | No |
Scope | read read:statuses |
Available since | 0.0.0 |
Parameters¶
Name | Description | Required | Default |
---|---|---|---|
local |
Only local statuses | Optional | false |
only_media |
Only statuses with media attachments | Optional | false |
max_id |
Return results older than ID | Optional | |
since_id |
Return results newer than ID | Optional | |
min_id |
Return results immediately newer than ID | Optional | |
limit |
Maximum number of results | Optional | 20 |
Pagination¶
This API returns Link headers containing links to the next and previous page. However, the links can also be constructed dynamically using query params and id
values.
GET /api/v1/timelines/tag/:hashtag¶
Public statuses known to the server marked with a given hashtag.
Returns array of Status
Resource information¶
Response format | JSON |
Requires authentication | No |
Requires user | No |
Scope | read read:statuses |
Available since | 0.0.0 |
Parameters¶
Name | Description | Required | Default |
---|---|---|---|
local |
Only local statuses | Optional | false |
only_media |
Only statuses with media attachments | Optional | false |
max_id |
Return results older than ID | Optional | |
since_id |
Return results newer than ID | Optional | |
min_id |
Return results immediately newer than ID | Optional | |
limit |
Maximum number of results | Optional | 20 |
Pagination¶
This API returns Link headers containing links to the next and previous page. However, the links can also be constructed dynamically using query params and id
values.
GET /api/v1/timelines/list/:list_id¶
Statuses from accounts on a given list.
Returns array of Status
Resource information¶
Response format | JSON |
Requires authentication | Yes |
Requires user | Yes |
Scope | read read:statuses |
Available since | 2.1.0 |
Parameters¶
Name | Description | Required | Default |
---|---|---|---|
max_id |
Return results older than ID | Optional | |
since_id |
Return results newer than ID | Optional | |
min_id |
Return results immediately newer than ID | Optional | |
limit |
Maximum number of results | Optional | 20 |
Pagination¶
This API returns Link headers containing links to the next and previous page. However, the links can also be constructed dynamically using query params and id
values.