Pagination

API Direct endpoints support pagination to retrieve multiple pages of results. There are two pagination patterns depending on the endpoint.

Pattern 1: page Parameter

Some endpoints use a page parameter where you request one page at a time. Each request returns a single page of results.

Endpoints using page: LinkedIn Posts, Reddit Posts, Forum Posts

# Get page 1
curl "https://api.apidirect.io/v1/reddit/posts?query=python&page=1" \
  -H "X-API-Key: YOUR_API_KEY"

# Get page 2
curl "https://api.apidirect.io/v1/reddit/posts?query=python&page=2" \
  -H "X-API-Key: YOUR_API_KEY"

The response includes the current page number:

{
  "posts": [...],
  "page": 2,
  "count": 20
}

Pattern 2: pages Parameter

Other endpoints use a pages parameter that fetches multiple pages in a single API call. This is useful for retrieving larger result sets without making multiple requests.

Endpoints using pages: Twitter Posts, Reddit Comments, YouTube Videos, Instagram Posts

# Fetch 3 pages of results in one call
curl "https://api.apidirect.io/v1/twitter/posts?query=AI&pages=3" \
  -H "X-API-Key: YOUR_API_KEY"

The response includes the number of pages fetched:

{
  "posts": [...],
  "pages": 3,
  "count": 60
}

Page Limits

Billing Note

For endpoints using the pages parameter, you are billed per page fetched. For example, requesting pages=3 on the Twitter endpoint costs 3x the per-page price.