Browse the docs
Developers / Docs / Posting
Get post
Gets one post: its status, scheduled time, the link once it is published, and the reason if it failed.
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/:id
- MCP tool
get_post
- Scope
read
- Cost
- Free. Works with a read-only key.
Parameters
id- In:
- path
- Type:
- string
- Required:
- Yes
- Description:
- The post id from post_video or list_posts. 1-64 chars.
Example
curl
curl "https://api.clippie.ai/v1/social/posts/ID" \
-H "Authorization: Bearer $CLIPPIE_API_KEY"get-post.mjs
const auth = { Authorization: `Bearer ${process.env.CLIPPIE_API_KEY}` };
const res = await fetch('https://api.clippie.ai/v1/social/posts/ID', { 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 get_post with the same fields as JSON arguments. See MCP server to connect one.
tools/call
{
"name": "get_post",
"arguments": {
"id": "ID"
}
}