validate

Validate Social Posts and JSON

Required a Premium or Business Plan.

The following endpoints validate social posts and a JSON objects.

POST Validate a Post

POST https://app.ayrshare.com/api/validate/post

Useful for pre-validating a post before publishing.

Instead of publishing a post with the /post endpoint, use the /validate/post endpoint to verify the content and parameters are correct. Validate by sending the exact same JSON you normally send to the /post endpoint.

⮕ Validation tests based on Ayrshare's own internal algorithms.

⮕ Posts are not sent to the social networks.

⮕ Posts may still return an error by the social networks even with a passed validation.

Please see the /post endpoint for sending a post.

Headers

Name	Type	Description
Authorization*	string	Format: Authorization: Bearer API_KEY. See Overview for more information.

Request Body

Name	Type	Description
	String	See /post endpoint

200: OK Successful Post

{
    "status": "success",
    "message": "No validation issues were found with this post. This is only an Ayrshare validation test and the post may still return an error by the social networks.",
}

201 Error Post

{
    "action": "post",
    "status": "error",
    "code": 136,
    "message": "Media URLs invalid. Please verify the media is an externally accessible URL.",
}

200 Successful Post with Non-Fatal Warnings

{
    "status": "success",
    "message": "No validation issues were found with this post. This is only an Ayrshare validation test and the post may still return an error by the social networks.",
    "warnings": [
        {
            "action": "post",
            "status": "error",
            "code": 156,
            "message": "Twitter is not linked with Ayrshare. Please confirm the linkage on the Social Accounts page in your dashboard."
        }
    ]
}

---

POST Validate JSON

POST https://app.ayrshare.com/api/validate/json

Send JSON to validate if correctly formatted. You can validate your JSON by using either an online linter, such as https://jsonlint.com/ or using Postman.

If you use no-code tool such as Bubble or Make or receive a 500 "Bad Request" response, this endpoint is useful to debug the JSON request.

Headers

Name	Type	Description
Authorization*	string	Format: Authorization: Bearer API_KEY. See Overview for more information.

200: OK Valid JSON

{
    "status": "success",
    "message": "Valid JSON. Nice Job!"
}

400: Bad Request Invalid JSON

{
    "status": "error",
    "message": "JSON is not valid. Unexpected end of JSON input while parsing near '{\"test\": \"happy}'"
}

• Send data as text. If using Postman, please be sure to select "Text" as the type.

• Set the "Content-Type": "text/plain".

Request Examples

An example of invalid JSON using Postman. Can you spot it? A missing comma at the end on the second parameter platforms.

Be sure to set the Content-Type in the header as text/plain and select "Text" when sending.

Postman Validate JSON

---

POST Check Post Length

POST https://app.ayrshare.com/api/validate/postLength

Calculate the weighted length, or character count, of a post string for Facebook, Google Business Profile, Instagram, LinkedIn, Pinterest, Reddit, TikTok, X/Twitter, and YouTube. Checks if the post length is valid and returns the maximum length allowed for each social network.

Special characters, such as ü, ø, or 😊, have a higher character count value (unicode).

This check is automatically done with the /post endpoint.

The weighted length is an estimate calculated by Ayrshare. Social networks may have slightly different character counts based on their own calculation methods.

Headers

Name	Type	Description
Authorization*	string	Format: Authorization: Bearer API_KEY See Overview for more information.

Request Body

Name	Type	Description
post*	string	Post string to calculated the length.

200: OK Character length results

{
    "twitterWeightedLength": 2932,
    "instagramWeightedLength": 3015,
    "tikTokWeightedLength": 3017,
    "linkedInWeightedLength": 3015,
    "facebookWeightedLength": 3015,
    "pinterestWeightedLength": 3015,
    "youtubeWeightedLength": 3015,
    "gmbWeightedLength": 3015,
    "twitterValid": false,
    "twitterLongValid": true,
    "facebookValid": true,
    "gmbValid": false,
    "instagramValid": false,
    "linkedInValid": false,
    "pinterestValid": false,
    "redditValid": true,
    "tikTokValid": false,
    "youtubeValid": true,
    "maxCharLimits": {
        "facebook": 63206,
        "gmb": 1500,
        "instagram": 2200,
        "linkedin": 3000,
        "pinterest": 500,
        "reddit": 10000,
        "tiktok": 2200,
        "twitter": 280,
        "twitterLong": 25000,
        "youtube": 5000
    }
}

Request Examples

cURL

curl \
-H "Authorization: Bearer API Key" \
-H 'Content-Type: application/json' \
-d '{"post": "🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩"}' \
-X POST https://app.ayrshare.com/api/post/checkPostWeight

Node.js

const API_KEY = "API_KEY";
const post = "🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩";

fetch("https://app.ayrshare.com/api/post/checkPostWeight", {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "Authorization": `Bearer ${API_KEY}`
      },
      body: JSON.stringify({ post }),
    })
      .then((res) => res.json())
      .then((json) => console.log(json))
      .catch(console.error);

Python

import requests

payload = {'post': '🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩'}
headers = {'Content-Type': 'application/json', 
        'Authorization': 'Bearer API_KEY'}

r = requests.post('https://app.ayrshare.com/api/post/checkPostWeight', 
    json=payload, 
    headers=headers)
    
print(r.json())

PHP

<?php
require 'vendor/autoload.php';   // Composer auto-loader using Guzzle. See https://docs.guzzlephp.org/en/stable/overview.html

$client = new GuzzleHttp\Client();
$res = $client->request(
    'POST',
    'https://app.ayrshare.com/api/post/checkPostWeight',
    [
        'headers' => [
            'Content-Type'      => 'application/json',
            'Authorization'     => 'Bearer API_KEY'
        ],
        'json' => [
            'post' => ['🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩']
        ]
    ]
);

echo json_encode(json_decode($res->getBody()), JSON_PRETTY_PRINT); 

C#

using System;
using System.Net;
using System.IO;

namespace CheckPostWeightRequest_charp
{
    class Post
    {
        static void Main(string[] args)
        {
            string API_KEY = "API_KEY";
            string url = "https://app.ayrshare.com/api/post/checkPostWeight";

            var httpWebRequest = WebRequest.CreateHttp(url);
            httpWebRequest.ContentType = "application/json";
            httpWebRequest.Method = "POST";
            httpWebRequest.Headers.Add("Authorization", "Bearer " + API_KEY);

            using (var streamWriter = new StreamWriter(httpWebRequest.GetRequestStream()))
            {
                string json = "{\"post\" : \"🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩🍩\"}";

                streamWriter.Write(json);
                streamWriter.Flush();
            }

            var httpResponse = (HttpWebResponse)httpWebRequest.GetResponse();
            using (var streamReader = new StreamReader(httpResponse.GetResponseStream()))
            {
                var response = streamReader.ReadToEnd();
                Console.WriteLine(response);
            }
        }
    }
}

---

GET Check Subreddit Exists

GET https://app.ayrshare.com/api/validate/redditExists/:subreddit

Check if a subreddit exists.

Headers

Name	Type	Description
Authorization*	string	Format: Authorization: Bearer API_KEY See Overview for more information.

Path Parameters

Name	Type	Description
subreddit*	string	The name of the subreddit to check if exists.

200 - Exists

{
    "status": "success",
    "subReddit": "tesla",
    "exists": true
}

200 - Does Not Exist

{
    "status": "success",
    "subReddit": "jkhjkhjkhkjhj",
    "exists": false
}

Request Examples

GET https://api.ayrshare.com/api/validate/redditExists/tesla