List Media Library

Retrieve a paginated list of your uploaded images or videos. Use this to find media_ids for existing assets.

Endpoint

GET https://api.schedpilot.com/developers/v1/media/list

Parameters (Query String)

Parameter	Type	Default	Description
type	string	image	image or video.
page	number	1	The page number to retrieve.
per_page	number	20	How many items to return per request (Max 100).

---

Example Request

curl -G "[https://api.schedpilot.com/developers/v1/media/list](https://api.schedpilot.com/developers/v1/media/list)" \
     -d "type=video" \
     -d "page=1" \
     -d "per_page=10" \
     -H "X-API-KEY: smm_your_secret_key"

---

Example Output

{
  "code": 200,
  "type": "video",
  "page": 1,
  "per_page": 10,
  "total_items": 45,
  "total_pages": 5,
  "items": [
    {
      "media_id": "video-1024",
      "url": "[https://api.schedpilot.com/uploads/.../video.mp4](https://api.schedpilot.com/uploads/.../video.mp4)",
      "title": "Summer Campaign Clip",
      "status": "processed"
    },
    {
      "media_id": "video-1023",
      "url": "[https://api.schedpilot.com/uploads/.../intro.mp4](https://api.schedpilot.com/uploads/.../intro.mp4)",
      "title": "Intro Video",
      "status": "pending"
    }
  ]
}