---
title: "GET api/posts"
method: GET
path: "/api/posts"
tags: ["Post"]
---

# GET api/posts

`GET /api/posts`

## Request

- Base URL: `https://app.followr.ai`
- URL: `https://app.followr.ai/api/posts`
- Auth: HTTP bearer

Return the list of posts

## Query parameters

- `filter[title]` string: filter by title
- `filter[description]` string: filter by description
- `filter[group.company_id]` string: filter by company id
- `filter[user_id]` string: filter by user id
- `filter[social_network_type]` string: filter by social network type
- `filter[external_id]` string: filter by external id
- `filter[link]` string: filter by link
- `filter[status]` string: filter by status
- `include` string: additional relations to include in response, separated by semi-colon.
- `sort` string: sort by field.
- `page[number]` integer: page number.
- `page[size]` integer: items per page (default 30).

## Response `200`

- object
  - `data` object[]
    - `id` integer
    - `social_network_type` string
    - `title` string
    - `description` string
    - `status` string
    - `status_message` string
    - `external_id` string
    - `link` string
    - `preferences` string
    - `comments_to_create` string
    - `created_at` string
    - `updated_at` string
    - `published_at` string
    - `group` object
      - `id` integer
      - `title` string
      - `topic` string
      - `draft` boolean
      - `auto_publish` boolean
      - `created_at` string
      - `updated_at` string
      - `publish_at` string

---

[API](https://skmtc.dev/followr/apis/followr-api-documentation.md) - [All operations](https://skmtc.dev/followr/apis/followr-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/followr/apis/followr-api-documentation/revisions/df7f1bbefd95?raw)