2018-09-26 00:19:54 +02:00
|
|
|
---
|
2018-10-05 02:35:29 +02:00
|
|
|
title: Timelines
|
2018-09-26 00:19:54 +02:00
|
|
|
menu:
|
|
|
|
docs:
|
2018-10-05 02:35:29 +02:00
|
|
|
parent: rest-api
|
2018-09-26 00:19:54 +02:00
|
|
|
weight: 10
|
|
|
|
---
|
2018-10-05 00:59:57 +02:00
|
|
|
|
|
|
|
## GET /api/v1/timelines/home
|
|
|
|
|
2018-10-05 01:37:50 +02:00
|
|
|
Statuses from accounts the user follows.
|
|
|
|
|
2018-10-05 00:59:57 +02:00
|
|
|
Returns array of [Status]({{< relref "entities.md#status" >}})
|
|
|
|
|
|
|
|
### Resource information
|
|
|
|
|
|
|
|
{{< api_method_info auth="Yes" user="Yes" scope="read read:statuses" version="0.0.0" >}}
|
|
|
|
|
|
|
|
### Parameters
|
|
|
|
|
|
|
|
|Name|Description|Required|Default|
|
|
|
|
|----|-----------|:------:|:-----:|
|
|
|
|
| `max_id` | Return results older than ID | Optional ||
|
|
|
|
| `since_id` | Return results newer than ID | Optional ||
|
|
|
|
| `limit` | Maximum number of results | Optional | 20 |
|
|
|
|
|
|
|
|
### Pagination
|
|
|
|
|
|
|
|
{{< api_dynamic_pagination >}}
|
|
|
|
|
|
|
|
## GET /api/v1/timelines/public
|
|
|
|
|
2018-10-05 01:37:50 +02:00
|
|
|
Public statuses known to the server.
|
|
|
|
|
2018-10-05 00:59:57 +02:00
|
|
|
Returns array of [Status]({{< relref "entities.md#status" >}})
|
|
|
|
|
|
|
|
### Resource information
|
|
|
|
|
|
|
|
{{< api_method_info auth="No" user="No" scope="read read:statuses" version="0.0.0" >}}
|
|
|
|
|
|
|
|
### Parameters
|
|
|
|
|
|
|
|
|Name|Description|Required|Default|
|
|
|
|
|----|-----------|:------:|:-----:|
|
|
|
|
| `local` | Only local statuses | Optional ||
|
|
|
|
| `only_media` | Only statuses with media attachments | Optional ||
|
|
|
|
| `max_id` | Return results older than ID | Optional ||
|
|
|
|
| `since_id` | Return results newer than ID | Optional ||
|
|
|
|
| `limit` | Maximum number of results | Optional | 20 |
|
|
|
|
|
|
|
|
### Pagination
|
|
|
|
|
|
|
|
{{< api_dynamic_pagination >}}
|
|
|
|
|
|
|
|
## GET /api/v1/timelines/tag/:hashtag
|
|
|
|
|
2018-10-05 01:37:50 +02:00
|
|
|
Public statuses known to the server marked with a given hashtag.
|
|
|
|
|
2018-10-05 00:59:57 +02:00
|
|
|
Returns array of [Status]({{< relref "entities.md#status" >}})
|
|
|
|
|
|
|
|
### Resource information
|
|
|
|
|
|
|
|
{{< api_method_info auth="No" user="No" scope="read read:statuses" version="0.0.0" >}}
|
|
|
|
|
|
|
|
### Parameters
|
|
|
|
|
|
|
|
|Name|Description|Required|Default|
|
|
|
|
|----|-----------|:------:|:-----:|
|
|
|
|
| `local` | Only local statuses | Optional ||
|
|
|
|
| `only_media` | Only statuses with media attachments | Optional ||
|
|
|
|
| `max_id` | Return results older than ID | Optional ||
|
|
|
|
| `since_id` | Return results newer than ID | Optional ||
|
|
|
|
| `limit` | Maximum number of results | Optional | 20 |
|
|
|
|
|
|
|
|
### Pagination
|
|
|
|
|
|
|
|
{{< api_dynamic_pagination >}}
|
|
|
|
|
|
|
|
## GET /api/v1/timelines/list/:list_id
|
|
|
|
|
2018-10-05 01:37:50 +02:00
|
|
|
Statuses from accounts on a given list.
|
|
|
|
|
2018-10-05 00:59:57 +02:00
|
|
|
Returns array of [Status]({{< relref "entities.md#status" >}})
|
|
|
|
|
|
|
|
### Resource information
|
|
|
|
|
|
|
|
{{< api_method_info auth="Yes" user="Yes" scope="read read:statuses" version="0.0.0" >}}
|
|
|
|
|
|
|
|
### Parameters
|
|
|
|
|
|
|
|
|Name|Description|Required|Default|
|
|
|
|
|----|-----------|:------:|:-----:|
|
|
|
|
| `max_id` | Get a list of statuses with ID less than this value | Optional ||
|
|
|
|
| `since_id` | Get a list of statuses with ID greater than this value | Optional ||
|
|
|
|
| `limit` | Maximum number of statuses to return | Optional | 20 |
|
|
|
|
|
|
|
|
### Pagination
|
|
|
|
|
|
|
|
{{< api_dynamic_pagination >}}
|