Pagination

How lists are paged.

Every list answers { "data": [ … ], "next_cursor": … }. GET /videos is paged with a cursor; the short lists (/personas, /lines, /assets, /recipes, /slide-formats, /music, /profiles, /plan) come whole, with next_cursor: null.

curl "https://getuser.app/api/v1/videos?limit=50" -H "Authorization: Bearer $GETUSER_API_KEY"
{ "data": [ … ], "next_cursor": "eyJ0IjoiMjAyNi0xMC0yNlQwOTo…" }
  • limit (GET /videos): 1–100, default 20.
  • cursor: pass next_cursor back to get the next page. null means there is no next page.
  • Newest first. Cursors are opaque: do not build or edit them.
import os, requests

url = "https://getuser.app/api/v1/videos"
headers = {"Authorization": f"Bearer {os.environ['GETUSER_API_KEY']}"}
params = {"limit": 100}
while True:
    page = requests.get(url, headers=headers, params=params).json()
    for video in page["data"]:
        print(video["id"], video["status"])
    if not page["next_cursor"]:
        break
    params["cursor"] = page["next_cursor"]