Build with Micro.blog logo
Build with Micro.blog
API Documentation

Twitter Archive

View .md

Endpoints for reading imported Twitter archive data.

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

Returns recent imported Twitter archive posts in JSON Feed format.

Example Request

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

Query Parameters

Name Type Required Description
offset integer Optional Number of items to skip before returning results.

Path Parameters

Name Type Required Description
site_id integer Required Site identifier.
Example: 123

Response

200 OK application/json

Returns a JSON Feed response.

Example Response

{
  "version": "https://jsonfeed.org/version/1.1",
  "items": []
}
GET /twitter/archive/{site_id}/search.json

Searches imported Twitter archive posts in JSON Feed format.

Example Request

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

Query Parameters

Name Type Required Description
q string Required Search query.
Example: search term

Path Parameters

Name Type Required Description
site_id integer Required Site identifier.
Example: 123

Response

200 OK application/json

Returns a JSON Feed response.

Example Response

{
  "version": "https://jsonfeed.org/version/1.1",
  "items": []
}
GET /twitter/archive/{site_id}/years.json

Returns years available in an imported Twitter archive.

Example Request

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

Path Parameters

Name Type Required Description
site_id integer Required Site identifier.
Example: 123

Response

200 OK application/json

Returns a JSON response.

Example Response

[
  2024,
  2025,
  2026
]
GET /twitter/archive/{site_id}/{year}/{month}.json

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

Example Request

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

Path Parameters

Name Type Required Description
site_id integer Required Site identifier.
Example: 123
year integer Required Four-digit year.
Example: 2024
month integer Required Month number.
Example: 4

Response

200 OK application/json

Returns a JSON Feed response.

Example Response

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