# DunSocial API for social media management and scheduling

> Social media management using the DunSocial API: schedule and publish across eight networks from your product, script or backend with JSON over HTTPS and scoped access.

- Base URL: https://api.dunsocial.com
- Full reference: https://www.dunsocial.com/docs/api
- Authentication: signed-in sessions for human-facing apps; workspace-bound Personal Access Tokens for scripts and services.
- SDKs: no maintained language SDK is currently published. Use curl, fetch or the HTTP client in any language.

## What you can build

- Schedule, publish, reschedule, cancel and list social media posts
- Manage drafts, media uploads and searchable brand memory
- List workspaces, members and connected social accounts without exposing social OAuth tokens
- Receive signed webhook events when posts publish, fail or an account needs attention
- Authenticate with browser sessions or workspace-bound personal access tokens
- Use scoped permissions for posts, drafts, media, memory and workspace reads
- JSON requests and responses over HTTPS, usable from any programming language

## API resources

### Posts

Schedule, publish, reschedule, cancel, delete and list posts or X threads.

### Drafts

Create, update, list and delete work that is not ready to publish.

### Media

Create upload URLs, complete uploads and manage gallery assets.

### Memory

Store brand facts in collections and retrieve them with semantic search.

### Accounts

List connected social accounts and their safe, publishable identifiers.

### Workspaces

Read workspaces, members and invitations with role-aware access.

### Webhooks

Receive signed events for publishing results and account health.

## Authentication and scopes

Personal Access Tokens are bound to one workspace. Grant only the capabilities that the integration needs and send the token in the `Authorization` header. Social network OAuth secrets never leave DunSocial.

- `workspace:read`
- `posts:read`
- `posts:schedule`
- `posts:publish`
- `posts:delete`
- `drafts:write`
- `media:read / media:write`
- `memory:read / memory:write`

## Example request

```bash
curl https://api.dunsocial.com/api/posts \
  -H "Authorization: Bearer $DUN_TOKEN" \
  -H "X-Workspace-Id: $DUN_WORKSPACE_ID"
```

## Errors and rate limits

General API traffic is limited to about 100 requests per minute per authenticated user or trusted client IP. Authentication and AI routes have tighter limits. Handle `429` with backoff and use the returned rate-limit headers.

Errors and rate limits: https://www.dunsocial.com/docs/api/getting-started/errors-and-rate-limits

## API, CLI or MCP

- Use the REST API when you are building a product, backend or custom integration.
- Use the CLI for a terminal, CI job, cron task or local coding agent.
- Use MCP when Claude, ChatGPT, Cursor or another assistant should operate DunSocial in natural language.

## Frequently asked questions

### Can I manage social media using an API?

Yes. The DunSocial REST API lets products and backends create drafts, schedule and publish posts, manage media and memory, inspect social accounts and receive signed webhook events across the same workspace as the web app.

### What can I build with the DunSocial API?

Use the REST API to schedule and publish posts from your own product or script, manage drafts and media, store and search brand memory, inspect connected accounts, and receive signed publishing events through webhooks.

### How does the DunSocial API authenticate requests?

Human-facing apps can use a signed-in session. Scripts, CI jobs and backend services should use a workspace-bound Personal Access Token with only the scopes they need, sent as an Authorization bearer token.

### Is the DunSocial API a social network scraping API?

No. DunSocial publishes through the official integrations for supported social networks. Your API client works with sanitized DunSocial account identifiers and never receives the underlying social OAuth tokens.

### Does DunSocial provide an SDK?

DunSocial does not currently publish a maintained language SDK. The API uses JSON over HTTPS, so you can call it with fetch, curl or the HTTP client in any language without waiting for an SDK release.

### What are the API rate limits?

General API traffic is limited to about 100 requests per minute per authenticated user or trusted client IP. Authentication and AI routes have tighter limits. A 429 response includes rate-limit headers; clients should back off and retry.

### Should I use the API, CLI or MCP server?

Use the API when you are building a product or custom backend. Use the CLI for terminals, CI and local scripts. Use MCP when Claude, ChatGPT, Cursor or another assistant should discover and call DunSocial tools in natural language.


## About this document

This is the Markdown representation of https://www.dunsocial.com/api. The HTML version of the same page is at the same URL. You can also request Markdown from any page by sending `Accept: text/markdown`.

Machine-readable summary of the whole site: https://www.dunsocial.com/llms.txt

## Company

- Product: DunSocial, https://www.dunsocial.com
- Legal entity: THISUX PRIVATE LIMITED, Chennai, Tamil Nadu, India
- Support: support@dunsocial.com
- Open the app: https://app.dunsocial.com/login