List Files

GET/api/v1/media/files

List all files in your dedicated SpiderMedia bucket, optionally filtered by folder.

Request

folderstring

Optional folder path to filter files (e.g., "logos", "images")

Response

successboolean

Whether the request succeeded

filesarray

Array of file objects

File Object

keystring

File key/path within the bucket

sizeinteger

File size in bytes

last_modifiedstring

ISO 8601 timestamp of last modification

urlstring

Public URL to access the file

totalinteger

Total number of files returned

Example

cURL

# List all files
curl "https://spideriq.ai/api/v1/media/files" \
  -H "Authorization: Bearer cli_abc123:sk_xxx:secret_xxx"

# List files in specific folder
curl "https://spideriq.ai/api/v1/media/files?folder=logos" \
  -H "Authorization: Bearer cli_abc123:sk_xxx:secret_xxx"

Python

import requests

url = "https://spideriq.ai/api/v1/media/files"
headers = {"Authorization": "Bearer cli_abc123:sk_xxx:secret_xxx"}
params = {"folder": "logos"}  # optional

response = requests.get(url, headers=headers, params=params)
print(response.json())

Response Example

{
  "success": true,
  "files": [
    {
      "key": "logos/company-logo.png",
      "size": 15234,
      "last_modified": "2026-01-08T20:30:00Z",
      "url": "https://media.spideriq.ai/client-cli-abc123/logos/company-logo.png"
    },
    {
      "key": "logos/favicon.ico",
      "size": 1234,
      "last_modified": "2026-01-08T19:15:00Z",
      "url": "https://media.spideriq.ai/client-cli-abc123/logos/favicon.ico"
    }
  ],
  "total": 2
}