List media files
curl --request GET \
--url https://api.social-api.ai/v1/media \
--header 'Authorization: <api-key>'const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.social-api.ai/v1/media', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.social-api.ai/v1/media"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"count": 42,
"data": [
{
"content_type": "image/jpeg",
"created_at": "2026-03-20T09:00:00Z",
"filename": "photo.jpg",
"id": "550e8400-e29b-41d4-a716-446655440000",
"size_bytes": 2048576,
"status": "ready",
"url": "https://s3.example.com/media/..."
}
],
"next_cursor": "<string>"
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
}
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
}
}Media
List media files
Returns a paginated list of uploaded media files for the authenticated user.
GET
/
media
List media files
curl --request GET \
--url https://api.social-api.ai/v1/media \
--header 'Authorization: <api-key>'const options = {method: 'GET', headers: {Authorization: '<api-key>'}};
fetch('https://api.social-api.ai/v1/media', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.social-api.ai/v1/media"
headers = {"Authorization": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text){
"count": 42,
"data": [
{
"content_type": "image/jpeg",
"created_at": "2026-03-20T09:00:00Z",
"filename": "photo.jpg",
"id": "550e8400-e29b-41d4-a716-446655440000",
"size_bytes": 2048576,
"status": "ready",
"url": "https://s3.example.com/media/..."
}
],
"next_cursor": "<string>"
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
}
}{
"error": {
"code": "resource.not_found",
"message": "Account not found",
"meta": {}
}
}Authorizations
Prefix your API key with "Bearer ". Example: Authorization: Bearer sapi_key_...
Query Parameters
Max results (default 50, max 100)
Pagination cursor (media ID)