REST API · Creatives

List drive folder

The videos and images of a Google Drive folder, with their format (through the Drive connected to Apogee)

GEThttps://api.apogee.ad/api/v1/drive-folders

Scope: read Pro and Scale plans Credits: Free* Paginated

Request

GET /drive-folders on https://api.apogee.ad/api/v1.

Query parameters

url string query required

Drive folder link or id

1 to 2,048 characters
recursive string query optional

Default true

One of true, false
limit integer query optional

Page size

Default 50

1 to 200
cursor string query optional

next_cursor of the previous page

Headers

Authorization string header required

Bearer apk_…: an API key with the scope of this route.

Response

200. A page of results: pass next_cursor as cursor for the next one, limit from 1 to 200 (default 50).

data array of objects
Fields of each item (10)
- ref string
  
  drive:<id>
- name string
- folder string or null
- kind string
  
  One of video, image
- mimeType string or null
- width number or null
- height number or null
- format string
- sizeMB number or null
- durationS number or null
has_more boolean
next_cursor string or null

Every answer carries X-Request-Id (give it to support), Apogee-Version: 2026-10-06, and the RateLimit and RateLimit-Policy headers.

Errors

Errors are application/problem+json with a stable code to switch on (all the codes).

Status	Possible codes
400 Bad request	`idempotency_key_required`, `not_supported`, `request_refused`, `validation_failed`
401 Unauthorized	`invalid_api_key`
403 Forbidden	`account_not_connected`, `forbidden`, `insufficient_scope`, `meta_permission_denied`, `platform_permission_denied`, `upgrade_required`
404 Not found	`not_found`
429 Too many requests	`daily_read_cap`, `meta_rate_limited`, `platform_rate_limited`, `quota_exceeded`, `rate_limited`
500 Internal server error	`internal_error`

Example

With your key in APOGEE_API_KEY (create one):

Request

curl 'https://api.apogee.ad/api/v1/drive-folders?url=https%3A%2F%2Fwww.dropbox.com%2Fscl%2Ffo%2Fexample0000%2Fnordlicht-creatives' \
  -H "Authorization: Bearer $APOGEE_API_KEY"

Response 200 (shape)

{
  "data": [
    {
      "ref": "120200000000000001",
      "name": "Nordlicht | Spring launch",
      "folder": "120200000000000001",
      "kind": "video",
      "mimeType": "120200000000000001",
      "width": 1080,
      "height": 1920,
      "format": "120200000000000001",
      "sizeMB": 46,
      "durationS": 15
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Access and cost

Plans	Pro and Scale.
Scope	`read` (scopes).
Credits	Free up to the daily free reads (5,000 a day on Pro, 10,000 on Scale), then 1 credit per read. A request that fails costs nothing, a replayed one neither (credits).
Rate limit	Read: 600 per 15 minutes on Pro, 1,200 on Scale (rate limits).
Daily cap	Counts 1 unit toward the 2,000 units one API key can use in 24 hours.

In the MCP

An AI assistant does the same with this tool of the MCP server:

list_drive_folder: The videos and images of a Google Drive folder, subfolders included, each with its format.

Create import: POST /imports
Get import: GET /imports/{id}
Create uploads: POST /uploads
Confirm uploads: POST /uploads/confirm
List TikTok posts: GET /ad-accounts/{acc}/tiktok-posts
List TikTok music: GET /ad-accounts/{acc}/tiktok-music
List platform templates: GET /ad-accounts/{acc}/platform-templates

Request

Query parameters

Headers

Response

Errors

Example

Access and cost

In the MCP

Related operations