Posts
get/posts

Request

  • Base URL
    https://api.omnisocials.com/v1
  • URL
    https://api.omnisocials.com/v1/posts
  • Auth
    HTTP bearer

Query parameters

status'draft' | 'in_approval' | 'scheduled' | 'posting' | 'published' | 'failed' | 'warning' | 'rejected'

Filter by status. published and the legacy alias posted are equivalent. in_approval matches posts waiting for a reviewer in an approval workflow. rejected matches posts an approver declined via POST /posts/{id}/reject. warning matches partially failed posts (some platforms published, some failed). These do NOT match failed, which only matches posts where every platform failed.

limitinteger

Number of posts to return

offsetinteger

Number of posts to skip

tagstring
Example:Question hook

Only posts with this tag: a tag id or name. Comma separate several to match posts with any of them. An unknown tag answers 404 tag_not_found.

Response

List of posts

Example response

{
  "data": [
    {
      "id": "1024",
      "content": {
        "default": "Our autumn menu is here.",
        "instagram": "Our autumn menu is here. #autumnmenu"
      },
      "accounts": {
        "instagram": true,
        "linkedin_page": true,
        "facebook": false,
        "x": false
      },
      "media": {
        "default": [
          {
            "url": "https://cdn.omnisocials.com/file/library-omnisocials/312a658f-2b45-4289-b240-890807221a74/library/1792573200000-k3j9xq_0c9e6b1a-2f4d-4b8e-a7c3-9d1e5f6a2b70.jpg",
            "id": "482913",
            "alt": "A bowl of pumpkin soup on a wooden table"
          }
        ]
      },
      "location_id": "1234567890",
      "collaborators": [
        "partnerbrand"
      ],
      "user_tags": [
        {
          "username": "partnerbrand",
          "x": 0.5,
          "y": 0.8
        }
      ],
      "schedule_at": "2026-10-21T09:00:00.000Z",
      "app_url": "https://app.omnisocials.com/create-post/1024",
      "tags": [
        {
          "id": 12,
          "name": "Question hook"
        }
      ],
      "published_urls": {
        "facebook": "https://www.facebook.com/123456789/posts/987654321",
        "instagram": "https://www.instagram.com/p/Cxyz123ABC/",
        "linkedin": "https://www.linkedin.com/feed/update/urn:li:share:7191234567890",
        "x": "https://x.com/yourhandle/status/1791234567890123456"
      },
      "retry_of": "1023",
      "retries": [
        "1031"
      ],
      "created_at": "2026-10-20T14:32:10.000Z",
      "errors": {
        "facebook": "Already Posted: These photos were already posted.",
        "instagram": "Instagram couldn't accept one of your images. Check that every image is JPEG/PNG, at least 320×320, has an aspect ratio between 4:5 and 1.91:1, and isn't visually flagged by Instagram. Re-upload or replace the offending image and try again."
      },
      "source": "api",
      "updated_at": "2026-10-20T14:35:42.000Z",
      "x": {
        "poll": {
          "options": [
            "Yes"
          ]
        },
        "thread_parts": [
          {
            "id": "6f1d8e2a-4b7c-4d9e-8a3f-2c5b9e7d1a60",
            "text": "1/3: our results are in"
          }
        ]
      },
      "bluesky": {
        "thread_parts": [
          {
            "id": "6f1d8e2a-4b7c-4d9e-8a3f-2c5b9e7d1a60",
            "text": "1/3: our results are in"
          }
        ]
      },
      "mastodon": {
        "poll": {
          "options": [
            "Yes"
          ]
        },
        "thread_parts": [
          {
            "id": "6f1d8e2a-4b7c-4d9e-8a3f-2c5b9e7d1a60",
            "text": "1/3: our results are in"
          }
        ]
      },
      "threads": {
        "poll": {
          "options": [
            "Yes"
          ]
        },
        "topic_tag": "Build in public",
        "location": {
          "id": "17841400000000000",
          "name": "Griffith Observatory",
          "address": "2800 E Observatory Rd",
          "city": "Los Angeles",
          "country": "United States"
        },
        "thread_parts": [
          {
            "id": "6f1d8e2a-4b7c-4d9e-8a3f-2c5b9e7d1a60",
            "text": "1/3: our results are in"
          }
        ]
      },
      "telegram": {
        "link_preview": true,
        "pin": true,
        "buttons": [
          {
            "text": "See the menu",
            "url": "https://example.com/menu"
          }
        ],
        "poll": {
          "options": [
            "Yes"
          ],
          "open_period": 86400
        },
        "result": {
          "chat_id": "-1001234567890",
          "message_ids": [
            "42"
          ],
          "text_message_id": "43",
          "pinned": true,
          "link_public": "https://t.me/brand/42",
          "link_private": "https://t.me/c/1234567890/42",
          "sent_at": "2026-10-21T09:00:07.000Z"
        }
      },
      "discord": {
        "link_preview": true,
        "thread_name": "October menu",
        "buttons": [
          {
            "text": "See the menu",
            "url": "https://example.com/menu"
          }
        ],
        "poll": {
          "options": [
            "Yes"
          ],
          "duration_hours": 24
        },
        "result": {
          "webhook_id": "1290000000000000000",
          "guild_id": "1180000000000000000",
          "channel_id": "1180000000000000001",
          "message_id": "1300000000000000000",
          "url": "https://discord.com/channels/1180000000000000000/1180000000000000001/1300000000000000000",
          "sent_at": "2026-10-22T09:00:03.000Z",
          "warnings": [
            "media_sent_as_links"
          ]
        }
      },
      "instagram": {
        "first_comment": "Full menu at the link in our bio.",
        "first_comment_result": {
          "posted_at": "2026-10-21T09:00:07.000Z"
        }
      },
      "video_cover": {
        "type": "frame",
        "thumb_offset": 3000,
        "overrides": {
          "linkedin_page": {
            "type": "custom",
            "cover_url": "https://example.com/cover.jpg"
          }
        }
      },
      "facebook": {
        "first_comment": "Full menu at the link in our bio.",
        "first_comment_result": {
          "posted_at": "2026-10-21T09:00:07.000Z"
        }
      },
      "linkedin": {
        "first_comment": "Full menu at the link in our bio.",
        "first_comment_result": {
          "posted_at": "2026-10-21T09:00:07.000Z"
        }
      },
      "linkedin_page": {
        "first_comment": "Full menu at the link in our bio.",
        "first_comment_result": {
          "posted_at": "2026-10-21T09:00:07.000Z"
        }
      },
      "youtube": {
        "first_comment": "Full menu at the link in our bio.",
        "first_comment_result": {
          "posted_at": "2026-10-21T09:00:07.000Z"
        }
      },
      "tiktok": {
        "title": "Autumn menu",
        "first_comment": "Full menu at the link in our bio.",
        "first_comment_result": {
          "posted_at": "2026-10-21T09:00:07.000Z"
        }
      },
      "comment_dm_automation": {
        "id": "318",
        "name": "Guide DM",
        "post_id": "1024",
        "instagram_media_id": "17912345678901234",
        "facebook_post_id": "104857600123456_987654321098765",
        "trigger": {
          "keywords": [
            "guide"
          ]
        },
        "actions": {
          "dm": {
            "text": "Here is the guide: https://example.com/guide"
          },
          "public_reply": {
            "enabled": true,
            "variations": [
              "Sent you a DM!"
            ]
          }
        },
        "limits": {
          "max_sends": 500,
          "stop_at": "2026-11-30T23:00:00.000Z"
        },
        "stats": {
          "matched": 120,
          "sent": 112,
          "skipped": 6,
          "failed": 2,
          "last_event_at": "2026-10-21T15:00:12.000Z"
        },
        "created_at": "2026-10-20T14:32:10.000Z",
        "updated_at": "2026-10-20T14:35:42.000Z",
        "platforms": [
          "instagram",
          "facebook"
        ],
        "automations": [
          {
            "id": "318"
          }
        ]
      }
    }
  ],
  "pagination": {
    "total": 42,
    "limit": 20,
    "has_more": true
  }
}

Changes

    • info

      added the new optional query request parameter tag

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property /// to the response with the status