List Scheduled Posts

Overview

The List Scheduled Posts endpoint allows you to retrieve a list of posts that are currently scheduled for future publication. This is useful for building a dashboard or queue view in your own application.

Base URL:

https://www.oneupapp.io

Endpoint

GET /api/getscheduledposts

Request Parameters

Parameter	Required	Description
apiKey	Yes	Your personal API key generated from the API Access page.
start	No	The starting index for pagination. Defaults to 0. Each request returns up to 50 posts.

Sample Request

curl --location --request GET \
"https://www.oneupapp.io/api/getscheduledposts?apiKey=YOUR_API_KEY&start=0"

Sample Response

{
  "message": "OK",
  "error": false,
  "data": [
    {
      "email": "user@example.com",
      "content": "My scheduled post content",
      "source_url": null,
      "date_time": "2026-12-12 13:13:00",
      "category_name": "My Category",
      "video_url": null,
      "post_id": 123456,
      "content_image": "https://example.com/image.jpg",
      "social_network_username": "my_social_handle"
    }
  ]
}

Response Fields

Field	Description
email	The account email associated with the post.
content	The text content of the post.
source_url	The source URL (if applicable).
date_time	The scheduled publication date and time.
category_name	The name of the category the post belongs to.
video_url	The URL of the attached video (if applicable).
post_id	The unique identifier for the post.
content_image	The URL of the attached image (if applicable).
social_network_username	The username of the social account where the post will be published.

✅ Result: You have successfully retrieved your scheduled posts queue!

---

Get Scheduled Posts by ID

Overview

The Get Scheduled Posts by ID endpoint allows you to retrieve specific scheduled posts by their IDs. This is useful for checking the status of posts you just scheduled, without paging through your entire queue.

Endpoint

GET /api/getscheduledpostsbyid

Request Parameters

Parameter	Required	Description
apiKey	Yes	Your personal API key generated from the API Access page.
post_ids[]	Yes	The ID of a post to retrieve. Repeat the parameter to retrieve multiple posts (e.g. post_ids[]=53992891&post_ids[]=54038404). You can find post IDs in the post_ids array returned when you schedule a post, or from the List Scheduled Posts endpoint above.

Sample Request

curl --location --globoff --request GET \
"https://www.oneupapp.io/api/getscheduledpostsbyid?apiKey=YOUR_API_KEY&post_ids[]=53992891&post_ids[]=54038404"

Sample Response

{
  "message": "OK",
  "error": false,
  "data": [
    {
      "email": "user@example.com",
      "content": "My first scheduled post",
      "source_url": "NA",
      "date_time": "2026-10-31 16:08:00",
      "category_name": "My Category",
      "video_url": "NA",
      "post_id": 53992891,
      "content_image": "NA",
      "social_network_username": "My Facebook Page",
      "isPublished": "Scheduled"
    },
    {
      "email": "user@example.com",
      "content": "My second scheduled post",
      "source_url": "NA",
      "date_time": "2026-10-31 18:17:00",
      "category_name": "My Category",
      "video_url": "NA",
      "post_id": 54038404,
      "content_image": "NA",
      "social_network_username": "my_social_handle",
      "isPublished": "Scheduled"
    }
  ]
}

Response Fields

Field	Description
email	The account email associated with the post.
content	The text content of the post.
source_url	The source URL, or NA if not applicable.
date_time	The scheduled publication date and time.
category_name	The name of the category the post belongs to.
video_url	The URL of the attached video, or NA if not applicable.
post_id	The unique identifier for the post.
content_image	The URL of the attached image, or NA if not applicable.
social_network_username	The username of the social account where the post will be published.
isPublished	The current status of the post (e.g. Scheduled).

✅ Result: You have successfully retrieved your scheduled posts by ID!