Discover | Build with Micro.blog

GET


                          /posts/discover

Returns the Discover timeline feed.

Example Request

curl -X GET "https://micro.blog/posts/discover" \
  --header "Authorization: Bearer EF7BB9BCAC1F6D561C93"

Query Parameters

Name	Type	Required	Description
`before_id`	integer	Optional	Only return posts older than this post ID. Example: `9853826`

Header Parameters

Name	Type	Required	Description
`Authorization`	string	Required	Bearer token for authentication. Format: `Bearer {token}`.

Response

200 OK application/json

Returns a JSON Feed response.

Example Response

{
  "version": "https://jsonfeed.org/version/1.1",
  "title": "Micro.blog",
  "home_page_url": "https://micro.blog",
  "feed_url": "https://micro.blog/posts/discover",
  "items": []
}

GET


                          /posts/discover/books

Returns the Discover books feed in JSON Feed format.

Example Request

curl -X GET "https://micro.blog/posts/discover/books"

Response

200 OK application/json

Returns a JSON Feed response.

Example Response

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

GET


                          /posts/discover/photos

Returns the Discover photos feed.

Example Request

curl -X GET "https://micro.blog/posts/discover/photos" \
  --header "Authorization: Bearer EF7BB9BCAC1F6D561C93"

Query Parameters

Name	Type	Required	Description
`before_id`	integer	Optional	Only return posts older than this post ID. Example: `19321821`
`count`	integer	Optional	Maximum number of items to return. Example: `60`
`since_id`	integer	Optional	Only return posts newer than this post ID. Example: `19388108`

Header Parameters

Name	Type	Required	Description
`Authorization`	string	Required	Bearer token for authentication. Format: `Bearer {token}`.

Response

200 OK application/json

Returns a JSON Feed response.

Example Response

{
  "version": "https://jsonfeed.org/version/1.1",
  "title": "Micro.blog",
  "home_page_url": "https://micro.blog",
  "feed_url": "https://micro.blog/posts/discover/photos",
  "items": []
}

GET


                          /posts/discover/slowreads

Returns the Discover slow reads feed in JSON Feed format.

Example Request

curl -X GET "https://micro.blog/posts/discover/slowreads"

Query Parameters

Name	Type	Required	Description
`before_id`	string	Optional	Only return items older than this ID. Example: `12345`

Response

200 OK application/json

Returns a JSON Feed response.

Example Response

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

GET


                          /posts/discover/{topic}

Returns a Discover topic feed in JSON Feed format.

Example Request

curl -X GET "https://micro.blog/posts/discover/{topic}"

Query Parameters

Name	Type	Required	Description
`before_id`	string	Optional	Only return items older than this ID. Example: `12345`

Path Parameters

Name	Type	Required	Description
`topic`	string	Required	topic parameter. Example: `example`

Response

200 OK application/json

Returns a JSON Feed response.

Example Response

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