# Discover

Page: https://microblog.dev/api/discover/
API base URL: https://micro.blog

Endpoints for curated Discover timelines and topic feeds.

## Endpoints
### GET /posts/discover

URL: `https://micro.blog/posts/discover`

Returns the Discover timeline feed.




Query parameters:
- `before_id` (integer, optional): Only return posts older than this post ID.
  Example: `9853826`



Header parameters:
- `Authorization` (string, required): Bearer token for authentication. Format: `Bearer {token}`.
  Example: `Bearer EF7BB9BCAC1F6D561C93`




Example request:

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

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

```json
{
  "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

URL: `https://micro.blog/posts/discover/books`

Returns the Discover books feed in JSON Feed format.

Example request:

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

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 /posts/discover/photos

URL: `https://micro.blog/posts/discover/photos`

Returns the Discover photos feed.




Query parameters:
- `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:
- `Authorization` (string, required): Bearer token for authentication. Format: `Bearer {token}`.
  Example: `Bearer EF7BB9BCAC1F6D561C93`




Example request:

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

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

```json
{
  "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

URL: `https://micro.blog/posts/discover/slowreads`

Returns the Discover slow reads feed in JSON Feed format.




Query parameters:
- `before_id` (string, optional): Only return items older than this ID.
  Example: `12345`






Example request:

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

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 /posts/discover/{topic}

URL: `https://micro.blog/posts/discover/{topic}`

Returns a Discover topic feed in JSON Feed format.


Path parameters:
- `topic` (string, required): topic parameter.
  Example: `example`



Query parameters:
- `before_id` (string, optional): Only return items older than this ID.
  Example: `12345`






Example request:

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

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

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