Fetch Media

Media-buckets are where files live in Mediacloud — they are a collection of files you've uploaded to us. On this page, we'll dive into the different media-bucket endpoints you can use to fetch media programmatically.

GET/api/media

List all medias

This endpoint allows you to retrieve a paginated list of all your media. By default, a maximum of ten contacts are shown per page.

Request

GET

/v1/media

curl -G https://mediacloud.ng/api/media \
  -H "Authorization: Bearer {token}"

Response

{
    "data": {
        "current_page": 1,
        "data": [
            "https://mediacloud.ng/media/bWVkaWEvaW1hZ2VzL29yaWdpbmFsLzdUU3BsWFo3U2hTQkNWVDVMWjFlb3IxS2JhaXlJRFM5dGhEU2x1SXkucG5n",
            "https://mediacloud.ng/media/bWVkaWEvaW1hZ2VzL29yaWdpbmFsL0dLOVd0and4WWF5azkwMjlEbUpDMVpxSzBVemp3VmJMdThOUUlrMU8ucG5n"
        ],
        "first_page_url": "https://mediacloud.ng/api/media?page=1",
        "from": 1,
        "last_page": 1,
        "last_page_url": "https://mediacloud.ng/api/media?page=1",
        "links": [
            {
                "url": null,
                "label": "&laquo; Previous",
                "active": false
            },
            {
                "url": "https://mediacloud.ng/api/media?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": null,
                "label": "Next &raquo;",
                "active": false
            }
        ],
        "next_page_url": null,
        "path": "https://mediacloud.ng/api/media",
        "per_page": 10,
        "prev_page_url": null,
        "to": 2,
        "total": 2
    }
}