# Tools API

> Validate posts and media before publishing; feedback and changelog.

Base URL: `https://api.socialit.com/v1`. Authenticate with `Authorization: Bearer <API key or OAuth token>`.

## Character counts per network

`POST /tools/validate/post-length`

Weighted counts (X: URLs = 23, emoji/CJK = 2; x_premium = 25,000).

Access: `read` · MCP tool: `validate-post-length` · Zernio: `POST /v1/tools/validate/post-length`

### Body

- `text` (string; required; ≤ 100000 characters)
- `platforms` (array of string)

```bash
curl -X POST "https://api.socialit.com/v1/tools/validate/post-length" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "string",
    "platforms": [
      "string"
    ]
  }'
```

Response 200:

```json
{
  "object": "post_length",
  "text_length": 1,
  "platforms": {
    "key": {
      "length": 1,
      "limit": 1,
      "remaining": 1,
      "valid": true
    }
  }
}
```

## Validate a post for its target networks

`POST /tools/validate/post`

Same body as POST /posts; nothing is created. Runs shared limits, each network validator and platform_options schemas.

Access: `read` · MCP tool: `validate-post` · Zernio: `POST /v1/tools/validate/post`

### Body

- `content` (string; ≤ 63206 characters)
- `title` (string | null; ≤ 300 characters)
- `account_ids` (array of string; ≤ 200 items)
- `profile_id` (string | null; ≤ 80 characters)
- `group_id` (string; ≤ 80 characters)
- `platforms` (array of string; ≤ 30 items)
- `targets` (array of object; ≤ 200 items)
  - `targets[].account_id` (string; required; 1–80 characters): socialAccount id (sa_…)
  - `targets[].content` (string; ≤ 63206 characters)
  - `targets[].media_ids` (array of string; ≤ 35 items)
  - `targets[].media_urls` (array of any; ≤ 35 items): Public HTTPS URLs or { url, alt_text?, type? }
  - `targets[].media` (array of object; ≤ 35 items)
    - `targets[].media[].media_id` (string; 1–80 characters): media id (med_…)
    - `targets[].media[].url` (string; ≤ 2048 characters)
    - `targets[].media[].alt_text` (string; ≤ 2000 characters)
    - `targets[].media[].type` (string; one of image, video, gif, document)
  - `targets[].platform_options` (object)
  - `targets[].first_comment` (string; ≤ 10000 characters)
  - `targets[].scheduled_at` (string; ≤ 40 characters)
- `media_ids` (array of string; ≤ 35 items)
- `media_urls` (array of any; ≤ 35 items): Public HTTPS URLs or { url, alt_text?, type? }
- `media` (array of object; ≤ 35 items)
  - `media[].media_id` (string; 1–80 characters): media id (med_…)
  - `media[].url` (string; ≤ 2048 characters)
  - `media[].alt_text` (string; ≤ 2000 characters)
  - `media[].type` (string; one of image, video, gif, document)
- `platform_options` (object)
- `first_comment` (string | null; ≤ 10000 characters)
- `thread_items` (array of object; ≤ 25 items)
  - `thread_items[].content` (string; required; ≤ 63206 characters)
  - `thread_items[].media_ids` (array of string; ≤ 10 items)
- `quote_post_id` (string | null; ≤ 80 characters)
- `quote_url` (string | null; ≤ 2048 characters)
- `reply_to_url` (string | null; ≤ 2048 characters)
- `scheduled_at` (string | null; ≤ 40 characters): ISO 8601; without offset = wall clock in timezone
- `timezone` (string | null; ≤ 64 characters)
- `publish_now` (boolean)
- `queue` (boolean)
- `queue_id` (string | null; ≤ 80 characters)
- `draft` (boolean)
- `tags` (array of string; ≤ 50 items)
- `metadata` (object)
- `strict` (boolean)
- `recycle` (object | null)
  - `recycle.enabled` (boolean; required)
  - `recycle.interval` (integer; 1–365)
  - `recycle.interval_unit` (string; one of day, week, month)
  - `recycle.start_at` (string (date-time))
  - `recycle.max_count` (integer | null; 1–1000)
  - `recycle.expires_at` (string (date-time) | null)
  - `recycle.content_variations` (array of string; ≤ 20 items)
- `note` (string; ≤ 5000 characters)

```bash
curl -X POST "https://api.socialit.com/v1/tools/validate/post" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "string",
    "title": "string",
    "account_ids": [
      "sa_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd"
    ],
    "profile_id": "string",
    "group_id": "string"
  }'
```

Response 200:

```json
{
  "object": "post_validation",
  "valid": true,
  "errors": [
    {
      "account_id": "string",
      "platform": "string",
      "code": "string",
      "message": "string",
      "param": "string"
    }
  ],
  "warnings": [
    {
      "account_id": "string",
      "platform": "string",
      "code": "string",
      "message": "string",
      "param": "string"
    }
  ],
  "targets": [
    {
      "account_id": "string",
      "platform": "string",
      "valid": true,
      "length": 1,
      "limit": 1,
      "errors": [
        "string"
      ],
      "warnings": [
        "string"
      ]
    }
  ]
}
```

## Validate a media URL or library item

`POST /tools/validate/media`

Access: `read` · MCP tool: `validate-media-url` · Zernio: `POST /v1/tools/validate/media`

### Body

- `url` (string; ≤ 2048 characters)
- `media_id` (string; 1–80 characters): media id (med_…)
- `platforms` (array of string)

```bash
curl -X POST "https://api.socialit.com/v1/tools/validate/media" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "media_id": "med_2Jx0Fq5Pz8vYkB3mN6rT1wQ9sLd",
    "platforms": [
      "string"
    ]
  }'
```

Response 200:

```json
{
  "object": "media_validation",
  "valid": true,
  "url": "https://example.com",
  "content_type": "string",
  "size": 1,
  "size_formatted": "string",
  "type": "string",
  "platforms": {
    "key": {
      "valid": true,
      "max_bytes": 1,
      "errors": [
        "string"
      ]
    }
  },
  "errors": [
    "string"
  ]
}
```

## Check a subreddit

`GET /tools/validate/subreddit`

Existence, posting restrictions, rules and post requirements, through a connected Reddit account.

Access: `read` · MCP tool: `validate-subreddit` · Zernio: `GET /v1/tools/validate/subreddit`

### Query parameters

- `name` (string; required; 1–100 characters)
- `account_id` (string)

```bash
curl "https://api.socialit.com/v1/tools/validate/subreddit?name=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "subreddit_validation",
  "name": "string",
  "exists": true,
  "valid": true,
  "subreddit": {}
}
```

## TikTok video metadata

`GET /tools/tiktok/download`

Metadata and embed only: TikTok's official APIs don't allow downloading videos (download_url is always null).

Access: `read` · MCP tool: `download-tik-tok-video` · Zernio: `GET /v1/tools/tiktok/download`

### Query parameters

- `url` (string; required; 10–2048 characters)
- `action` (string; one of download, metadata)
- `format_id` (string)

```bash
curl "https://api.socialit.com/v1/tools/tiktok/download?url=value" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "tiktok_video",
  "url": "https://example.com",
  "video_id": "string",
  "author": "string",
  "title": "string",
  "thumbnail_url": "https://example.com",
  "embed_html": "string",
  "download_url": "https://example.com",
  "unavailable_reason": "string",
  "formats": [
    {}
  ]
}
```

## Send feedback to the Socialit team

`POST /feedback`

Bugs, missing features and docs issues; built for AI agents too.

Access: `read` · MCP tool: `submit-feedback` · Zernio: `POST /v1/feedback`

### Headers

- `Idempotency-Key` (string; ≤ 255 characters): Unique key (for example a UUID) that makes retries safe: a repeated request with the same key and body returns the first response (Idempotent-Replayed: true) for 24 hours.

### Body

- `type` (string; required; one of bug, missing_feature, docs, other)
- `summary` (string; required; 3–500 characters)
- `details` (string; ≤ 10000 characters)
- `endpoint` (string; ≤ 300 characters)
- `request_id` (string; ≤ 100 characters)
- `expected` (string; ≤ 5000 characters)
- `actual` (string; ≤ 5000 characters)
- `agent` (string; ≤ 100 characters)

```bash
curl -X POST "https://api.socialit.com/v1/feedback" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "bug",
    "summary": "string",
    "details": "string",
    "endpoint": "string",
    "request_id": "string"
  }'
```

Response 201:

```json
{
  "object": "feedback",
  "id": "string",
  "type": "string",
  "summary": "string",
  "details": "string",
  "endpoint": "string",
  "request_id": "string",
  "expected": "string",
  "actual": "string",
  "agent": "string",
  "created_at": "2026-10-13T09:00:00.000Z"
}
```

## API changelog

`GET /changelog`

Access: `read` · MCP tool: `list-changelog` · Zernio: `GET /v1/changelog`

### Query parameters

- `type` (string; one of new_feature, improvement, breaking_change, deprecation, fix)
- `impact` (string; one of low, medium, high)
- `platform` (string)
- `before` (string; ≤ 30 characters)
- `limit` (integer; 1–100)

```bash
curl "https://api.socialit.com/v1/changelog" \
  -H "Authorization: Bearer $SOCIALIT_API_KEY"
```

Response 200:

```json
{
  "object": "list",
  "data": [
    {
      "object": "changelog_entry",
      "id": "string",
      "date": "string",
      "type": "string",
      "impact": "string",
      "title": "string",
      "description": "string",
      "platforms": [
        "string"
      ],
      "operations": [
        "string"
      ],
      "url": "https://example.com"
    }
  ],
  "page": 1,
  "limit": 1,
  "total": 1,
  "has_more": true,
  "next_page_url": "https://example.com",
  "previous_page_url": "https://example.com"
}
```


---

Source: https://socialit.com/docs/api-reference/tools/
