Pagination

Some APIs return more results than fit in one response, such as an account’s followers. Pagination support is SKU-specific.

Confirm pagination support

Fetch the selected API’s contract with GET /v1/apis/{sku} or MCP get_api. Use cursor pagination only when inputSchema declares cursor and the output schema declares nextCursor. Include limit or requireSinglePage only when inputSchema also declares those fields. Call again with data.nextCursor as cursor until nextCursor is null. The examples use instagram.followers, whose schema declares these fields.

import requests

URL = "https://api.getanyapi.com/v1/run/instagram.followers"
HEADERS = {"X-API-Key": "YOUR_ANYAPI_KEY"}

def all_followers(username):
    results, cursor = [], None
    while True:
        body = {"username": username, "limit": 50}
        if cursor:
            body["cursor"] = cursor
        data = requests.post(URL, headers=HEADERS, json=body).json()["output"]["data"]
        results += data["items"]
        cursor = data.get("nextCursor")
        if not cursor:            # null -> done
            return results

const URL = "https://api.getanyapi.com/v1/run/instagram.followers";
const HEADERS = { "X-API-Key": "YOUR_ANYAPI_KEY", "Content-Type": "application/json" };

async function allFollowers(username) {
  const results = [];
  let cursor = null;
  do {
    const body = { username, limit: 50, ...(cursor && { cursor }) };
    const res = await fetch(URL, { method: "POST", headers: HEADERS, body: JSON.stringify(body) });
    const { data } = (await res.json()).output;
    results.push(...data.items);
    cursor = data.nextCursor;     // null -> done
  } while (cursor);
  return results;
}

# First page
curl -s https://api.getanyapi.com/v1/run/instagram.followers \
  -H "X-API-Key: YOUR_ANYAPI_KEY" -H "Content-Type: application/json" \
  -d '{"username":"natgeo","limit":50}'

# Next page: pass the nextCursor from the previous response back as cursor
curl -s https://api.getanyapi.com/v1/run/instagram.followers \
  -H "X-API-Key: YOUR_ANYAPI_KEY" -H "Content-Type: application/json" \
  -d '{"username":"natgeo","limit":50,"cursor":"PASTE_nextCursor_HERE"}'

What the fields mean

limit, when declared, is the most items you want in this response: a page cap, not a grand total. Follow nextCursor for more.
cursor is an opaque token from a previous response’s nextCursor. Pass it to continue, or omit it to start from the first page. Do not parse or build it: it is sealed and tied to one walk.
nextCursor is in the response at output.data.nextCursor. A non-null value means there is more; null means you have reached the end of this walk.
page, on APIs whose schema declares it (today google.search), picks a page directly: send page: 2, page: 3 and so on, each billed as one request. Any source can serve any page. On those APIs cursor is deprecated but still accepted.

The selected SKU’s schema defines its page-size constraints. Do not copy a limit value from another API. If a cursor is rejected because it expired, start again without a cursor.

Get everything in one call

If you cannot loop and the selected inputSchema declares requireSinglePage, set requireSinglePage: true to request up to the schema’s allowed limit in one response. This route can cost more than walking pages.

curl

curl -s https://api.getanyapi.com/v1/run/instagram.followers \
  -H "X-API-Key: YOUR_ANYAPI_KEY" -H "Content-Type: application/json" \
  -d '{"username":"natgeo","limit":500,"requireSinglePage":true}'

Cost

Check the selected API’s pricing before choosing between paging and a supported single-page request. Your exact charge in USD is returned as costUsd.

Getting Started

API Reference

What the fields mean

Get everything in one call

Cost

​Confirm pagination support

​What the fields mean

​Get everything in one call

​Cost

Confirm pagination support

What the fields mean

Get everything in one call

Cost