# Substack posts API endpoint

Source: https://subalytics.com/docs/substack-posts/

> GET /api/v1/substack-posts/: search Substack posts by creator, audience and engagement. Parameters, response fields and example.

`GET /api/v1/substack-posts/` (Cursor pagination). Base URL `https://subalytics.com/api/v1/`, API key in the `X-API-key` header; authentication, pagination, dates and errors: https://subalytics.com/docs/

Search posts by creator, audience and engagement. By default returns post summaries: title, URL, date, description, a truncated body and engagement counts.

| Parameter | Type | Description |
|---|---|---|
| `sub_id` | string | Subalytics ID of one creator |
| `audience` | string | Audience, e.g. only_paid or everyone |
| `wordcount` | int | Minimum word count |
| `comment_count` | int | Minimum number of comments |
| `reaction_count` | int | Minimum number of reactions |
| `full` | string | true = return the complete post record |
| `limit` | int | Results per page (default 25, max 100) |
| `cursor` | string | next_cursor from the previous page |

## Example

```
GET /api/v1/substack-posts/?sub_id=803b198749&audience=only_paid
```