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

{
    "status": "success",
    "statusCode": 200,
    "contentType": "image/jpeg"
}
Available on Premium, Business, Enterprise plans.
Verify that the media file exists when uploaded. It should be used in conjunction with the /media/uploadUrl endpoint.

​
Header Parameters

​
Authorization
string
required
API Key of the Primary Profile.

Format: Authorization: Bearer API_KEY

​
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

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