Skip to main content
The GET /v1/campaigns endpoint returns campaigns from all connected platforms in a unified format. You can filter by platform, status, and paginate through results using cursors.

Basic Request

Query Parameters

Filtering by Platform

Fetch only Google Ads campaigns:

Filtering by Status

Fetch only active campaigns across all platforms:
Combine filters:

Cursor Pagination

AdRelay uses cursor-based pagination. Each response includes a pagination object indicating whether more results are available and providing a cursor for the next page.

Response Shape

Paginating Through Results

To fetch the next page, pass the next_cursor value as the cursor query parameter:
When has_more is false, you have reached the last page.

Full Pagination Example (Node.js)

Campaign Object Fields