Posting API

Social media posting API with connection, media, and inspection built in.

A thin post endpoint is rarely enough. SocialClaw packages the full posting flow: connected-account ownership, media handoff, provider-aware validation, publish execution, and the ability to inspect what happened afterward.

Start free View pricing

socialclaw login --api-key <workspace-key>
socialclaw accounts list --json
socialclaw accounts capabilities --provider linkedin --json
socialclaw validate -f post.json --json
socialclaw apply -f post.json --idempotency-key product_post_1 --json
socialclaw posts get --post-id <post-id> --json

curl -sS \
  -X POST \
  -H "Authorization: Bearer $SC_API_KEY" \
  -H "Content-Type: application/json" \
  -d @post.json \
  "https://getsocialclaw.com/v1/posts/validate"

curl -sS \
  -X POST \
  -H "Authorization: Bearer $SC_API_KEY" \
  -H "Content-Type: application/json" \
  -d @post.json \
  "https://getsocialclaw.com/v1/posts/apply"

curl -sS \
  -H "Authorization: Bearer $SC_API_KEY" \
  "https://getsocialclaw.com/v1/posts/<post-id>"

What you get

The operational pieces that matter before a workflow promises social publishing.

Connection layer

Hosted OAuth and manual targets

Customers connect publishable accounts once, then the API reuses those targets across later posts and schedules.

Media layer

Hosted URLs or native upload by route

SocialClaw handles media according to the provider route: public URL handoff, native upload, or webhook upload.

Publish layer

Validate before publish execution

Validation checks platform-specific requirements before the work is applied.

Inspection layer

Post records and attempts

The workspace keeps publish state and attempts so your product can show meaningful delivery status.

Inputs and requirements

The data and checks that keep the workflow grounded in current provider rules.

A connected account target stored in the workspace
Text content and provider-supported media
Optional provider settings such as Instagram publish mode, TikTok privacy level, or YouTube privacy status where supported
A validation call before creating publish work
Post or run inspection after apply

How it works

A provider aware flow from connection to inspection.

Start from a workspace target

Use an account already connected through SocialClaw instead of sending raw provider credentials with each post.

Build the provider-specific post

Use the account type and media envelope that matches the selected route.

Validate the payload

Check text, media, settings, and account constraints before asking SocialClaw to apply the post.

Apply the work

Create the publish work through the hosted API or CLI.

Inspect the outcome

Read post detail, attempts, and account health so your product can show what happened.

Constraints to know

Important guardrails to keep the page accurate.

Personal Facebook profiles are not publish targets.
Instagram routes require media; profile carousels support up to ten items, while Story and post + Story modes require one item.
Interaction publishing is provider-specific rather than universal.

Related routes

Pages that reinforce the same product and platform intent.

Scheduling API Add publish_at and schedule whole campaigns Embedded SaaS use case Customer account connection and publish execution inside your product Workflow pages Provider-specific examples and constraints Integrations Account types, media rules, and settings SocialClaw vs Postiz Hosted execution compared with agentic scheduler alternatives Pricing Plans for hosted posting workflows

What builders are saying

Real quotes from Reddit, G2, Trustpilot, and Instagram.

G2 G2 review

“I can prepare the content once and let SocialClaw handle the distribution.”

Instagram

“If SocialClaw sees this just know you changed my entire workflow girl.”

r/mcp

“Since I try market my iOS apps, definitely SocialClaw… because then Claude can post to social media for me.”

r/socialmedia

“Most schedulers still feel like old calendar tools with an AI caption button added on top. SocialClaw feels more built around the newer AI era.”

r/automation

“SocialClaw if you want to schedule posts to social media.”

G2 G2 review

“I can prepare the content once and let SocialClaw handle the distribution.”

Instagram

“If SocialClaw sees this just know you changed my entire workflow girl.”

r/mcp

“Since I try market my iOS apps, definitely SocialClaw… because then Claude can post to social media for me.”

r/socialmedia

“Most schedulers still feel like old calendar tools with an AI caption button added on top. SocialClaw feels more built around the newer AI era.”

r/automation

“SocialClaw if you want to schedule posts to social media.”

Trustpilot Trustpilot review

“SocialClaw handles the repetitive publishing work: uploading media, managing connected accounts, scheduling posts, publishing them, and retrying when something fails.”

r/SocialMediaManagers

“I used to use stuff like Buffer etc, but I use SocialClaw with my AI agent. I just tell it to schedule like 100 videos for the next month.”

r/AI_Agents

“It has an OpenClaw skill, or use it via API, CLI, or even the web dashboard.”

r/openclaw

“I have it install the SocialClaw skill, linked my social media accounts, and it actually has approval to post on my socials for me.”