Skip to main content
POST
/
media
/
urlExists
curl \
-H "Authorization: Bearer API_KEY" \
-H 'Content-Type: application/json' \
-d '{"mediaUrl": "https://img.ayrshare.com/012/vid.mp4"}' \
-X POST https://api.ayrshare.com/api/media/urlExists

const API_KEY = "API_KEY";

fetch("https://api.ayrshare.com/api/media/urlExists", {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "Authorization": `Bearer ${API_KEY}`
      },
      body: JSON.stringify({
        mediaUrl: "https://img.ayrshare.com/012/vid.mp4"
      }),
    })
      .then((res) => res.json())
      .then((json) => console.log(json))
      .catch(console.error);

import requests

payload = {'mediaUrl': 'https://img.ayrshare.com/012/vid.mp4'}
headers = {'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'}

r = requests.post('https://api.ayrshare.com/api/media/urlExists',
    json=payload,
    headers=headers)

print(r.json())

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

$client = new GuzzleHttp\Client();
$res = $client->request(
    'POST',
    'https://api.ayrshare.com/api/media/urlExists',
    [
        'headers' => [
            'Content-Type'      => 'application/json',
            'Authorization'     => 'Bearer API_KEY'
        ],
        'mediaUrl' => 'https://img.ayrshare.com/012/vid.mp4'
    ]
);

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

{
    "status": "success",
    "statusCode": 200,
    "contentType": "image/jpeg"
}

{
  "status": "error",
  "statusCode": 404,
  "statusText": "Not Found"
}
Verify that the media file exists when uploaded. It should be used in conjunction with the /media/uploadUrl endpoint.

​
Header Parameters

​
Verify Media URL Exists

POST https://api.ayrshare.com/api/media/urlExists Verify that the media file exists when uploaded. It should be used in conjunction with the /media/uploadUrl endpoint. You will also receive the contentType of the media file. A HEAD request is made to the media URL to verify it exists. Please be sure the hosting provider is not blocking the HEAD request.

​
Body Parameters

​
mediaUrl
string
required
URL of the media to verify exists.
curl \
-H "Authorization: Bearer API_KEY" \
-H 'Content-Type: application/json' \
-d '{"mediaUrl": "https://img.ayrshare.com/012/vid.mp4"}' \
-X POST https://api.ayrshare.com/api/media/urlExists

const API_KEY = "API_KEY";

fetch("https://api.ayrshare.com/api/media/urlExists", {
      method: "POST",
      headers: {
        "Content-Type": "application/json",
        "Authorization": `Bearer ${API_KEY}`
      },
      body: JSON.stringify({
        mediaUrl: "https://img.ayrshare.com/012/vid.mp4"
      }),
    })
      .then((res) => res.json())
      .then((json) => console.log(json))
      .catch(console.error);

import requests

payload = {'mediaUrl': 'https://img.ayrshare.com/012/vid.mp4'}
headers = {'Content-Type': 'application/json',
        'Authorization': 'Bearer API_KEY'}

r = requests.post('https://api.ayrshare.com/api/media/urlExists',
    json=payload,
    headers=headers)

print(r.json())

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

$client = new GuzzleHttp\Client();
$res = $client->request(
    'POST',
    'https://api.ayrshare.com/api/media/urlExists',
    [
        'headers' => [
            'Content-Type'      => 'application/json',
            'Authorization'     => 'Bearer API_KEY'
        ],
        'mediaUrl' => 'https://img.ayrshare.com/012/vid.mp4'
    ]
);

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

{
    "status": "success",
    "statusCode": 200,
    "contentType": "image/jpeg"
}

{
  "status": "error",
  "statusCode": 404,
  "statusText": "Not Found"
}