GET
https://spideriq.ai
/
api
/
v1
/
media
/
files
List Files
curl --request GET \
  --url https://spideriq.ai/api/v1/media/files \
  --header 'Authorization: Bearer <token>'
{
  "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
}
List all files in your dedicated SpiderMedia bucket, optionally filtered by folder.

​
Request

​
folder
string
Optional folder path to filter files (e.g., “logos”, “images”)

​
Response

​
success
boolean
Whether the request succeeded
​
files
array
Array of file objects
​
total
integer
Total number of files returned

​
Example

# 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"

{
  "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
}