# REST API

> One REST API for publishing, inbox, analytics, accounts, webhooks and Focus mode on 14 social networks. OpenAPI 3.1, consistent objects and errors.

One API, every network. Stop maintaining fourteen integrations. Socialit gives you one REST API with consistent objects, errors and pagination, and handles app reviews, OAuth, media and rate limits for each network.

## At a glance

- **14** networks behind one base URL
- **3.1** OpenAPI spec
- **1** error format
- **24 h** idempotency keys

## Consistent everywhere

Every object has an id with a prefix, snake_case fields and ISO dates. Lists share one envelope and one filter syntax.

- Prefixed ids (pst_, sa_, wh_)
- page, limit, has_more
- field.condition=value filters

## Errors you can act on

One error shape with a type, a code, the parameter, per-field errors and the network’s own code when it was the network that said no.

- type, code, param, errors
- platform and platform_code
- request_id for support

## Built for production

Idempotency keys on every create, RateLimit headers, signed webhooks with retries and a request log you can search.

- Idempotency-Key header
- RateLimit-* headers
- Request logs

## Features

- **API keys**: Full or read-only, optionally restricted to profiles.
- **OAuth 2.1**: Let apps and agents act for your users with scoped tokens.
- **Webhooks**: HMAC-SHA256 signatures, retries for 3 days, redelivery.
- **OpenAPI 3.1**: Generate clients in any language from /v1/openapi.json.
- **Request logs**: Search every request and response by key, path and status.
- **Validation**: Validate a post or media against every network before creating it.

## FAQ

### Is the API included on Free?

Yes. The API, webhooks and the MCP server are on every plan, with request budgets that grow with the plan.

### Do I need my own developer apps on each network?

No. Socialit runs the apps and passes the networks’ reviews. Enterprise customers can bring their own apps where a network allows it.

### Is there an OpenAPI spec?

Yes. GET /v1/openapi.json returns the OpenAPI 3.1 document the API reference is generated from. Use it to generate a client in any language.

## Links

- Documentation: https://socialit.com/docs/api-reference/
- Pricing: https://socialit.com/pricing/
- Sign up: https://app.socialit.com/register

---

Source: https://socialit.com/product/api/
