FeedHorizon API
Posts
GET
/posts

Returns a paginated list of posts. Supports filtering by status, platform, and profile.

Authorization

bearerAuth
AuthorizationBearer <token>

API key with fh_ prefix. Pass as Authorization: Bearer fh_...

In: header

Query Parameters

page?integer

Page number

Default1
perPage?integer

Items per page

Default20
Rangevalue <= 100
status?string

Filter by post status

Value in"DRAFT" | "SCHEDULED" | "QUEUED" | "PUBLISHING" | "PUBLISHED" | "FAILED"
platform?string

Filter by platform (e.g. linkedin)

profileId?string

Filter by profile ID

Response Body

application/json

application/json

curl -X GET "https://app.feedhorizon.dev/api/v1/posts"
{
  "data": [
    {
      "id": "string",
      "content": "string",
      "status": "DRAFT",
      "publishMode": "schedule",
      "scheduledAt": "2019-08-24T14:15:22Z",
      "timezone": "Europe/Berlin",
      "publishedAt": "2019-08-24T14:15:22Z",
      "platforms": [
        "linkedin"
      ],
      "platformPostIds": {
        "property1": "string",
        "property2": "string"
      },
      "errorMessage": "string",
      "profileId": "string",
      "userId": "string",
      "createdAt": "2019-08-24T14:15:22Z",
      "updatedAt": "2019-08-24T14:15:22Z",
      "media": [
        {
          "id": "string",
          "postId": "string",
          "url": "string",
          "storagePath": "string",
          "type": "string",
          "filename": "string",
          "sizeBytes": 0,
          "sortOrder": 0,
          "createdAt": "2019-08-24T14:15:22Z"
        }
      ]
    }
  ],
  "meta": {
    "page": 0,
    "perPage": 0,
    "total": 0
  }
}
{
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "string",
    "details": [
      {
        "field": "string",
        "message": "string"
      }
    ]
  }
}