List Failed Posts

Overview

The List Failed Posts endpoint allows you to retrieve a list of posts that failed to publish. This is essential for troubleshooting and informing users why their content was not successfully posted.

Base URL:

https://www.oneupapp.io

Endpoint

GET /api/getfailedposts

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/getfailedposts?apiKey=YOUR_API_KEY&start=0"

Sample Response

{
  "message": "OK",
  "error": false,
  "data": [
    {
      "email": "user@example.com",
      "content": "My failed post content",
      "source_url": null,
      "created_at": "2026-02-18 15:30:00",
      "category_name": "My Category",
      "post_id": "987654",
      "content_image": "https://example.com/image.jpg",
      "social_network_username": "my_social_handle",
      "fail_reason": "The image size exceeds the platform limit."
    }
  ]
}

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).
created_at	The date and time when the publication attempt failed.
category_name	The name of the category the post belongs to.
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 was intended to be published.
fail_reason	A description of why the post failed to publish.

✅ Result: You have successfully retrieved your failed posts list!