Validation

Validate post content

Dry-run exactly the checks create runs, WITHOUT creating anything, so valid: true means create would accept the post: per-platform caption limits (each limit grounded in the platform handler or the platform’s documented maximum, counted the way the platform counts), platform text rules (Instagram hashtags and @mentions, Threads links), required media (Instagram, Pinterest, TikTok), media that suits the post type (an Instagram or Facebook Reel and a YouTube video need a video; an Instagram or Facebook Reel or Story takes exactly one file; a TikTok photo post takes images only), media counts and formats, file types, and the platform’s post fields (e.g. TikTok who can view). Each platform is checked against its own text and media when platform_overrides are sent. Free and unbilled. Platforms with no honestly-documented ceiling (Snapchat stories carry no caption; Tumblr documents no body cap) report limit: null. Requires scope social:read.

POST

social

validate

post

Validate post content

curl --request POST \
  --url https://api.smartlyq.com/v1/social/validate/post \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": "Launching today! 🚀",
  "platforms": [
    "twitter",
    "instagram",
    "linkedin"
  ],
  "media_urls": [
    "https://cdn.example.com/launch.jpg"
  ]
}
'

import requests

url = "https://api.smartlyq.com/v1/social/validate/post"

payload = {
    "content": "Launching today! 🚀",
    "platforms": ["twitter", "instagram", "linkedin"],
    "media_urls": ["https://cdn.example.com/launch.jpg"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    content: 'Launching today! 🚀',
    platforms: ['twitter', 'instagram', 'linkedin'],
    media_urls: ['https://cdn.example.com/launch.jpg']
  })
};

fetch('https://api.smartlyq.com/v1/social/validate/post', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.smartlyq.com/v1/social/validate/post",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'content' => 'Launching today! 🚀',
    'platforms' => [
        'twitter',
        'instagram',
        'linkedin'
    ],
    'media_urls' => [
        'https://cdn.example.com/launch.jpg'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.smartlyq.com/v1/social/validate/post"

	payload := strings.NewReader("{\n  \"content\": \"Launching today! 🚀\",\n  \"platforms\": [\n    \"twitter\",\n    \"instagram\",\n    \"linkedin\"\n  ],\n  \"media_urls\": [\n    \"https://cdn.example.com/launch.jpg\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.smartlyq.com/v1/social/validate/post")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"content\": \"Launching today! 🚀\",\n  \"platforms\": [\n    \"twitter\",\n    \"instagram\",\n    \"linkedin\"\n  ],\n  \"media_urls\": [\n    \"https://cdn.example.com/launch.jpg\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.smartlyq.com/v1/social/validate/post")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"content\": \"Launching today! 🚀\",\n  \"platforms\": [\n    \"twitter\",\n    \"instagram\",\n    \"linkedin\"\n  ],\n  \"media_urls\": [\n    \"https://cdn.example.com/launch.jpg\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "valid": true,
    "errors": [
      "example-error"
    ],
    "platforms": {}
  },
  "meta": {
    "request_id": "req_9f3a2b1c-7d4e-4a08-b2c6-5e1f8a9d0c34",
    "timestamp": "2026-07-26T09:41:22Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Missing or malformed Authorization header",
    "details": {}
  },
  "meta": {
    "request_id": "req_9f3a2b1c-7d4e-4a08-b2c6-5e1f8a9d0c34",
    "timestamp": "2026-07-26T09:41:22Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Missing required fields: content, platforms.",
    "details": {
      "fields": [
        "content",
        "platforms"
      ]
    }
  },
  "meta": {
    "request_id": "req_9f3a2b1c-7d4e-4a08-b2c6-5e1f8a9d0c34",
    "timestamp": "2026-07-26T09:41:22Z"
  }
}

Authorizations

Authorization

string

header

required

API key from Developer dashboard (Bearer token).

Body

application/json

platforms

string[]

required

Target platforms, e.g. ["twitter", "instagram"].

content

string

Post text to check.

media_urls

string[]

Media URLs the post would carry (used for required-media and extension checks).

platform_options

object

Optional. Per-platform options as on create (post type, TikTok privacy, ...). The post type decides which media a platform needs.

Show child attributes

platform_overrides

object

Optional. Per-platform text and media as on create; each platform is checked against its own.

Show child attributes

Response

Validation report

success

enum<boolean>

Available options:

true

data

object

Show child attributes

meta

object

Show child attributes

Validate post content

curl --request POST \
  --url https://api.smartlyq.com/v1/social/validate/post \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "content": "Launching today! 🚀",
  "platforms": [
    "twitter",
    "instagram",
    "linkedin"
  ],
  "media_urls": [
    "https://cdn.example.com/launch.jpg"
  ]
}
'

import requests

url = "https://api.smartlyq.com/v1/social/validate/post"

payload = {
    "content": "Launching today! 🚀",
    "platforms": ["twitter", "instagram", "linkedin"],
    "media_urls": ["https://cdn.example.com/launch.jpg"]
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    content: 'Launching today! 🚀',
    platforms: ['twitter', 'instagram', 'linkedin'],
    media_urls: ['https://cdn.example.com/launch.jpg']
  })
};

fetch('https://api.smartlyq.com/v1/social/validate/post', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.smartlyq.com/v1/social/validate/post",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'content' => 'Launching today! 🚀',
    'platforms' => [
        'twitter',
        'instagram',
        'linkedin'
    ],
    'media_urls' => [
        'https://cdn.example.com/launch.jpg'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.smartlyq.com/v1/social/validate/post"

	payload := strings.NewReader("{\n  \"content\": \"Launching today! 🚀\",\n  \"platforms\": [\n    \"twitter\",\n    \"instagram\",\n    \"linkedin\"\n  ],\n  \"media_urls\": [\n    \"https://cdn.example.com/launch.jpg\"\n  ]\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.smartlyq.com/v1/social/validate/post")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"content\": \"Launching today! 🚀\",\n  \"platforms\": [\n    \"twitter\",\n    \"instagram\",\n    \"linkedin\"\n  ],\n  \"media_urls\": [\n    \"https://cdn.example.com/launch.jpg\"\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.smartlyq.com/v1/social/validate/post")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"content\": \"Launching today! 🚀\",\n  \"platforms\": [\n    \"twitter\",\n    \"instagram\",\n    \"linkedin\"\n  ],\n  \"media_urls\": [\n    \"https://cdn.example.com/launch.jpg\"\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "data": {
    "valid": true,
    "errors": [
      "example-error"
    ],
    "platforms": {}
  },
  "meta": {
    "request_id": "req_9f3a2b1c-7d4e-4a08-b2c6-5e1f8a9d0c34",
    "timestamp": "2026-07-26T09:41:22Z"
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_API_KEY",
    "message": "Missing or malformed Authorization header",
    "details": {}
  },
  "meta": {
    "request_id": "req_9f3a2b1c-7d4e-4a08-b2c6-5e1f8a9d0c34",
    "timestamp": "2026-07-26T09:41:22Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Missing required fields: content, platforms.",
    "details": {
      "fields": [
        "content",
        "platforms"
      ]
    }
  },
  "meta": {
    "request_id": "req_9f3a2b1c-7d4e-4a08-b2c6-5e1f8a9d0c34",
    "timestamp": "2026-07-26T09:41:22Z"
  }
}

Core

CRM

Profiles

AI Generation

Social

Ads

WhatsApp

Inbox

AI Assistants

Validate post content

Authorizations

Body

Response