Browse the docs
Developers / Docs / Posting
List posts
Lists posts made or scheduled from Clippie, newest scheduled time first: status (SCHEDULED, PUBLISHING, PUBLISHED, FAILED, CANCELLED), when, the channel and, once published, the link.
Paste it into any AI assistant. The shortcuts open with the prompt typed in; nothing is sent until you press enter.
At a glance
- REST
GET https://api.clippie.ai/v1/social/posts
- MCP tool
list_posts
- Scope
read
- Cost
- Free. Works with a read-only key.
Parameters
status- In:
- query
- Type:
- string
- Required:
- No
- Description:
- Only posts with this status, e.g. SCHEDULED for what is still to go out. One of
SCHEDULED,PUBLISHING,PUBLISHED,FAILED,CANCELLED.
from- In:
- query
- Type:
- string
- Required:
- No
- Description:
- Only posts scheduled at or after this time (ISO 8601).
to- In:
- query
- Type:
- string
- Required:
- No
- Description:
- Only posts scheduled at or before this time (ISO 8601).
limit- In:
- query
- Type:
- integer
- Required:
- No
- Description:
- At most this many (default 50). 1-200.
Example
curl
curl "https://api.clippie.ai/v1/social/posts" \
-H "Authorization: Bearer $CLIPPIE_API_KEY"list-posts.mjs
const auth = { Authorization: `Bearer ${process.env.CLIPPIE_API_KEY}` };
const res = await fetch('https://api.clippie.ai/v1/social/posts', { headers: auth });
if (!res.ok) throw new Error((await res.json()).error.message);
console.log(await res.json());Response
200 with JSON. The full response schema is in the OpenAPI spec.
From an MCP client
Your AI calls list_posts with the same fields as JSON arguments. See MCP server to connect one.
tools/call
{
"name": "list_posts",
"arguments": {}
}