Pagination

​

How it works

1. Make your first request (no cursor):

curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/signals?keyword=AI&limit=10"

2. Check has_more and next_cursor in the response (the list itself is under a resource key: signals for /v1/signals, entities for /v1/entities):

{
  "signals": [...],
  "has_more": true,
  "next_cursor": "c2cudjEuOGYzYTFjOWUuNDU2"
}

3. Pass next_cursor as the cursor parameter for the next page:

curl -H "X-API-Key: gld_your_key" \
  "https://api.gildea.ai/v1/signals?keyword=AI&limit=10&cursor=c2cudjEuOGYzYTFjOWUu..."

4. Repeat until has_more is false.

​

Parameters

​

Paginated endpoints

• GET /v1/signals: signals list
• GET /v1/entities: entities list

​

Why cursor-based?

• No skipped/duplicated results when data changes between pages
• Consistent performance regardless of page depth (no OFFSET N scan)
• Opaque cursors: the format may change without breaking clients