# Twitter Archive

Page: https://microblog.dev/api/twitter-archive/
API base URL: https://micro.blog

Endpoints for reading imported Twitter archive data.

## Endpoints
### GET /twitter/archive/{site_id}/recent.json

URL: `https://micro.blog/twitter/archive/{site_id}/recent.json`

Returns recent imported Twitter archive posts in JSON Feed format.


Path parameters:
- `site_id` (integer, required): Site identifier.
  Example: `123`



Query parameters:
- `offset` (integer, optional): Number of items to skip before returning results.






Example request:

```sh
curl -X GET "https://micro.blog/twitter/archive/{site_id}/recent.json"
```

Response:
- Status: 200
- Content-Type: `application/json`
- Description: Returns a JSON Feed response.
Example response:

```json
{
  "version": "https://jsonfeed.org/version/1.1",
  "items": []
}
```

### GET /twitter/archive/{site_id}/search.json

URL: `https://micro.blog/twitter/archive/{site_id}/search.json`

Searches imported Twitter archive posts in JSON Feed format.


Path parameters:
- `site_id` (integer, required): Site identifier.
  Example: `123`



Query parameters:
- `q` (string, required): Search query.
  Example: `search term`






Example request:

```sh
curl -X GET "https://micro.blog/twitter/archive/{site_id}/search.json?q=search+term"
```

Response:
- Status: 200
- Content-Type: `application/json`
- Description: Returns a JSON Feed response.
Example response:

```json
{
  "version": "https://jsonfeed.org/version/1.1",
  "items": []
}
```

### GET /twitter/archive/{site_id}/years.json

URL: `https://micro.blog/twitter/archive/{site_id}/years.json`

Returns years available in an imported Twitter archive.


Path parameters:
- `site_id` (integer, required): Site identifier.
  Example: `123`








Example request:

```sh
curl -X GET "https://micro.blog/twitter/archive/{site_id}/years.json"
```

Response:
- Status: 200
- Content-Type: `application/json`
- Description: Returns a JSON response.
Example response:

```json
[
  2024,
  2025,
  2026
]
```

### GET /twitter/archive/{site_id}/{year}/{month}.json

URL: `https://micro.blog/twitter/archive/{site_id}/{year}/{month}.json`

Returns imported Twitter archive posts for a year and month in JSON Feed format.


Path parameters:
- `site_id` (integer, required): Site identifier.
  Example: `123`
- `year` (integer, required): Four-digit year.
  Example: `2024`
- `month` (integer, required): Month number.
  Example: `4`








Example request:

```sh
curl -X GET "https://micro.blog/twitter/archive/{site_id}/{year}/{month}.json"
```

Response:
- Status: 200
- Content-Type: `application/json`
- Description: Returns a JSON Feed response.
Example response:

```json
{
  "version": "https://jsonfeed.org/version/1.1",
  "items": []
}
```