MENU navbar-image

Introduction

This is the API for the Social Media Value Calculator

You can Also use api.socialmediavalue.io as base url. Important the standard currency is USD If you want to get a different currency you have to give it as parameter "

Authenticating requests

This API is not authenticated.

Endpoints

POST /facebook

Example request:
curl --request POST \
    "socialmediavalue.io/facebook" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"impressions\": 50,
    \"reactions\": 16,
    \"comments\": 7,
    \"shares\": 8,
    \"currency\": \"USD\"
}"
const url = new URL(
    "socialmediavalue.io/facebook"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "impressions": 50,
    "reactions": 16,
    "comments": 7,
    "shares": 8,
    "currency": "USD"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
$client = new \GuzzleHttp\Client();
$url = 'socialmediavalue.io/facebook';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'impressions' => 50,
            'reactions' => 16,
            'comments' => 7,
            'shares' => 8,
            'currency' => 'USD',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'socialmediavalue.io/facebook'
payload = {
    "impressions": 50,
    "reactions": 16,
    "comments": 7,
    "shares": 8,
    "currency": "USD"
}
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

Example response (200):


{
    "result": 1,
    "currency": "USD"
}
 

Request   

POST facebook

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Body Parameters

impressions   integer   

The number of people who have seen the post. Example: 50

reactions   integer  optional  

The number of people who interactet with the post. Example: 16

comments   integer  optional  

The number of people who commented. Example: 7

shares   integer  optional  

The number of people who liked the post. Example: 8

currency   string  optional  

The Currency in the ISO format like USD, EUR. Example: USD

POST /instagram

Example request:
curl --request POST \
    "socialmediavalue.io/instagram" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"impressions\": 50,
    \"likes\": 20,
    \"comments\": 9,
    \"saved\": 1,
    \"currency\": \"USD\"
}"
const url = new URL(
    "socialmediavalue.io/instagram"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "impressions": 50,
    "likes": 20,
    "comments": 9,
    "saved": 1,
    "currency": "USD"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
$client = new \GuzzleHttp\Client();
$url = 'socialmediavalue.io/instagram';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'impressions' => 50,
            'likes' => 20,
            'comments' => 9,
            'saved' => 1,
            'currency' => 'USD',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'socialmediavalue.io/instagram'
payload = {
    "impressions": 50,
    "likes": 20,
    "comments": 9,
    "saved": 1,
    "currency": "USD"
}
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

Example response (200):


{
    "result": 1,
    "currency": "USD"
}
 

Request   

POST instagram

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Body Parameters

impressions   integer   

The number of people who have seen the post. Example: 50

likes   integer  optional  

The number of people who liked with the post. Example: 20

comments   integer  optional  

The number of people who commented. Example: 9

saved   integer  optional  

The number of people who saved the post. Example: 1

currency   string  optional  

The Currency in the ISO format like USD, EUR. Example: USD

POST /twitter

Example request:
curl --request POST \
    "socialmediavalue.io/twitter" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"impressions\": 50,
    \"likes\": 18,
    \"comments\": 15,
    \"retweets\": 9,
    \"currency\": \"USD\"
}"
const url = new URL(
    "socialmediavalue.io/twitter"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "impressions": 50,
    "likes": 18,
    "comments": 15,
    "retweets": 9,
    "currency": "USD"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
$client = new \GuzzleHttp\Client();
$url = 'socialmediavalue.io/twitter';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'impressions' => 50,
            'likes' => 18,
            'comments' => 15,
            'retweets' => 9,
            'currency' => 'USD',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'socialmediavalue.io/twitter'
payload = {
    "impressions": 50,
    "likes": 18,
    "comments": 15,
    "retweets": 9,
    "currency": "USD"
}
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

Example response (200):


{
    "result": 1,
    "currency": "USD"
}
 

Request   

POST twitter

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Body Parameters

impressions   integer   

The number of people who have seen the post. Example: 50

likes   integer  optional  

The number of people who liked with the post. Example: 18

comments   integer  optional  

The number of people who commented. Example: 15

retweets   integer  optional  

The number of people who retweets the post. Example: 9

currency   string  optional  

The Currency in the ISO format like USD, EUR. Example: USD

POST /youtube

Example request:
curl --request POST \
    "socialmediavalue.io/youtube" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"views\": 50,
    \"likes\": 1,
    \"comments\": 9,
    \"shares\": 6,
    \"currency\": \"USD\"
}"
const url = new URL(
    "socialmediavalue.io/youtube"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "views": 50,
    "likes": 1,
    "comments": 9,
    "shares": 6,
    "currency": "USD"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
$client = new \GuzzleHttp\Client();
$url = 'socialmediavalue.io/youtube';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'views' => 50,
            'likes' => 1,
            'comments' => 9,
            'shares' => 6,
            'currency' => 'USD',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'socialmediavalue.io/youtube'
payload = {
    "views": 50,
    "likes": 1,
    "comments": 9,
    "shares": 6,
    "currency": "USD"
}
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

Example response (200):


{
    "result": 1,
    "currency": "USD"
}
 

Request   

POST youtube

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Body Parameters

views   integer   

The number of people who have seen the Video. Example: 50

likes   integer  optional  

The number of people who interactet (Like/dislikes) with the video. Example: 1

comments   integer  optional  

The number of people who commented. Example: 9

shares   integer  optional  

The number of people who shared the video. Example: 6

currency   string  optional  

The Currency in the ISO format like USD, EUR. Example: USD

Post /linkedin

Example request:
curl --request POST \
    "socialmediavalue.io/linkedin" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"impressions\": 50,
    \"likes\": 17,
    \"comments\": 9,
    \"shares\": 5,
    \"currency\": \"USD\"
}"
const url = new URL(
    "socialmediavalue.io/linkedin"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "impressions": 50,
    "likes": 17,
    "comments": 9,
    "shares": 5,
    "currency": "USD"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
$client = new \GuzzleHttp\Client();
$url = 'socialmediavalue.io/linkedin';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'impressions' => 50,
            'likes' => 17,
            'comments' => 9,
            'shares' => 5,
            'currency' => 'USD',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'socialmediavalue.io/linkedin'
payload = {
    "impressions": 50,
    "likes": 17,
    "comments": 9,
    "shares": 5,
    "currency": "USD"
}
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

Example response (200):


{
    "result": 1,
    "currency": "USD"
}
 

Request   

POST linkedin

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Body Parameters

impressions   integer   

The number of people who have seen the post. Example: 50

likes   integer  optional  

The number of people who liked with the post. Example: 17

comments   integer  optional  

The number of people who commented. Example: 9

shares   integer  optional  

The number of people who shared the post. Example: 5

currency   string  optional  

The Currency in the ISO format like USD, EUR. Example: USD

POST /tiktok

Example request:
curl --request POST \
    "socialmediavalue.io/tiktok" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"views\": 50,
    \"likes\": 3,
    \"comments\": 20,
    \"shares\": 8,
    \"currency\": \"USD\"
}"
const url = new URL(
    "socialmediavalue.io/tiktok"
);

const headers = {
    "Content-Type": "application/json",
    "Accept": "application/json",
};

let body = {
    "views": 50,
    "likes": 3,
    "comments": 20,
    "shares": 8,
    "currency": "USD"
};

fetch(url, {
    method: "POST",
    headers,
    body: JSON.stringify(body),
}).then(response => response.json());
$client = new \GuzzleHttp\Client();
$url = 'socialmediavalue.io/tiktok';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => [
            'views' => 50,
            'likes' => 3,
            'comments' => 20,
            'shares' => 8,
            'currency' => 'USD',
        ],
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));
import requests
import json

url = 'socialmediavalue.io/tiktok'
payload = {
    "views": 50,
    "likes": 3,
    "comments": 20,
    "shares": 8,
    "currency": "USD"
}
headers = {
  'Content-Type': 'application/json',
  'Accept': 'application/json'
}

response = requests.request('POST', url, headers=headers, json=payload)
response.json()

Example response (200):


{
    "result": 1,
    "currency": "USD"
}
 

Request   

POST tiktok

Headers

Content-Type      

Example: application/json

Accept      

Example: application/json

Body Parameters

views   integer   

The number of people who have seen the video. Example: 50

likes   integer  optional  

The number of people who liked with the video. Example: 3

comments   integer  optional  

The number of people who commented. Example: 20

shares   integer  optional  

The number of people who shared the video. Example: 8

currency   string  optional  

The Currency in the ISO format like USD, EUR. Example: USD