# AdaptlyPost Public API API

**Canonical:** https://apis.io/apis/adaptlypost-com/adaptlypost-public-api-api/  
**Provider:** AdaptlyPost — https://apis.io/providers/adaptlypost-com/  
**Base URL:** https://post.adaptlypost.com/post/api/v1  
**Documentation:** https://adaptlypost.com/llms.txt

AdaptlyPost Public API API is one of 2 APIs that [AdaptlyPost](https://apis.io/providers/adaptlypost-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

REST API for creating, scheduling, and managing social media posts across Facebook, Instagram, Threads, TikTok, X (Twitter), Bluesky, Mastodon, LinkedIn, Pinterest, YouTube, Google Business Profile, Tumblr, WordPress and Telegram. Register webhooks to receive `post.published`, `post.partially_failed

## Operations (55)

| Method | Path | Summary |
|---|---|---|
| GET | `/me` | Describe the calling key |
| GET | `/workspaces` | List the workspaces the caller can act in |
| POST | `/social-posts` | Create a post (immediate, scheduled, or draft) |
| GET | `/social-posts` | List posts |
| POST | `/social-posts/validate` | Dry-run a post without creating it |
| POST | `/social-posts/bulk/validate` | Dry-run a bulk schedule without creating posts |
| POST | `/social-posts/bulk` | Bulk schedule up to 100 posts |
| GET | `/social-posts/{id}` | Get a post by ID |
| PATCH | `/social-posts/{id}` | Update a draft or scheduled post |
| DELETE | `/social-posts/{id}` | Delete a post |
| GET | `/social-posts/{id}/results` | Get per-platform publishing results for a post |
| POST | `/social-posts/{id}/publish` | Publish or schedule a draft post |
| POST | `/social-posts/{id}/unschedule` | Unschedule a post |
| POST | `/social-posts/{id}/retry` | Retry failed platforms of a post |
| GET | `/recurring-posts` | List recurring posts |
| GET | `/recurring-posts/{id}` | Get a recurring post |
| DELETE | `/recurring-posts/{id}` | Delete a recurring post |
| POST | `/recurring-posts/{id}/pause` | Pause a recurring post |
| POST | `/recurring-posts/{id}/resume` | Resume a recurring post |
| GET | `/rss-feeds` | List RSS feeds |
| POST | `/rss-feeds` | Connect an RSS feed |
| POST | `/rss-feeds/preview` | Preview an RSS feed |
| GET | `/rss-feeds/{id}` | Get an RSS feed |
| PATCH | `/rss-feeds/{id}` | Update an RSS feed |
| DELETE | `/rss-feeds/{id}` | Delete an RSS feed |
| GET | `/rss-feeds/{id}/items` | List the items an RSS feed has seen |
| POST | `/rss-feeds/{id}/pause` | Pause an RSS feed |
| POST | `/rss-feeds/{id}/resume` | Resume an RSS feed |
| POST | `/rss-feeds/{id}/check` | Check an RSS feed now |
| GET | `/social-accounts` | List connected social accounts |
| POST | `/social-accounts/{id}/check` | Re-check an account with its platform now |
| DELETE | `/social-accounts/{id}` | Remove a social account from the workspace |
| GET | `/social-accounts/{id}/instagram-audio` | Search Instagram music and original sounds for a Reel |
| GET | `/social-accounts/{id}/pinterest-boards` | List the boards of a Pinterest account |
| POST | `/upload-urls` | Get presigned upload URLs for media files |
| POST | `/connect-links` | Create a white-label link for connecting social accounts |
| DELETE | `/connect-links/{token}` | Revoke a connect link |
| POST | `/webhooks` | Register a webhook endpoint |
| GET | `/webhooks` | List registered webhooks |
| GET | `/webhooks/{id}` | Get a webhook by ID |
| PATCH | `/webhooks/{id}` | Update a webhook (URL or active state) |
| DELETE | `/webhooks/{id}` | Delete a webhook |
| POST | `/webhooks/{id}/test` | Send a signed webhook.test event to the endpoint |
| GET | `/analytics/overview` | Workspace-wide totals for a date window, with previous-window comparison |
| GET | `/analytics/timeseries` | Metrics bucketed by day, week or month |
| GET | `/analytics/platform-breakdown` | The same metrics as the overview, one row per platform |
| GET | `/analytics/posts` | Per-post metrics for every tracked post published in the window, paginated |
| GET | `/analytics/top-posts` | Best-performing posts in the window by one metric |
| GET | `/analytics/discovered-posts` | Posts found on the connected accounts that were not published through AdaptlyPost |
| GET | `/analytics/sync-status` | Freshness of the analytics data, per connected account |
| POST | `/analytics/sync` | Ask for an analytics refresh now |
| POST | `/ai/captions` | Generate a caption |
| POST | `/ai/captions/refine` | Rewrite an existing caption |
| POST | `/ai/images` | Start an image generation |
| GET | `/ai/images/{jobId}` | Read an image generation job |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/adaptlypost-com/openapi/_original/adaptlypost-com-api-openapi.json
- **JSONSchema** — https://artifacts.apis.io/adaptlypost-com/json-schema/adaptlypost-com-create-social-post-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/adaptlypost-com/json-schema/adaptlypost-com-update-social-post-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/adaptlypost-com/json-schema/adaptlypost-com-bulk-schedule-posts-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/adaptlypost-com/json-schema/adaptlypost-com-rss-feed-schema.json
- **JSONSchema** — https://artifacts.apis.io/adaptlypost-com/json-schema/adaptlypost-com-recurring-post-schema.json
- **JSONSchema** — https://artifacts.apis.io/adaptlypost-com/json-schema/adaptlypost-com-create-connect-link-request-schema.json

## Other AdaptlyPost APIs (1)

- [AdaptlyPost API](https://apis.io/apis/adaptlypost-com/adaptlypost-api/)

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/adaptlypost-com/adaptlypost-public-api-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/adaptlypost-com/.