List campaigns

​

Returns a flat list of all campaigns across the given instances with basic metadata.

What is included per campaign:

  • Campaign ID, name, description, and status
  • Start date, first post date, and last post date
  • Instance ID the campaign belongs to

No performance metrics are included — use GET /campaigns/performance for metrics.

Query Parameters
  • limit
    Type: number
    min:  
    1
    max:  
    100

    Maximum number of items to return per page. Choose any value on the first request, then keep it unchanged on every subsequent request that passes a nextCursor from this endpoint. To change the page size, start a new walk by omitting nextCursor.

  • nextCursor
    Type: string | null

    Opaque cursor returned by the previous page. Omit on the first request. Cursors are tied to the query parameters of the request that produced them; to paginate, keep every parameter identical across requests and only vary nextCursor. To change filters, sort, or limit, start a new walk by omitting nextCursor.

Responses
  • application/json
  • application/problem+json
  • application/problem+json
  • application/problem+json
  • application/problem+json
Request Example for get/v2/campaigns
curl 'https://reporting.api.later.com/v2/campaigns?limit=50&nextCursor=null' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "data": [
    {
      "campaignId": 49761,
      "campaignName": "Summer Collection 2024",
      "instanceId": "instance_abc",
      "description": "Seasonal product launch",
      "status": "live",
      "startDate": "2024-06-01T00:00:00.000Z",
      "firstPostDate": "2024-06-15T00:00:00.000Z",
      "lastPostDate": "2024-08-15T00:00:00.000Z"
    },
    {
      "campaignId": 49802,
      "campaignName": "Fall Influencer Push",
      "instanceId": "instance_abc",
      "description": null,
      "status": "draft",
      "startDate": "2024-09-01T00:00:00.000Z",
      "firstPostDate": null,
      "lastPostDate": null
    }
  ],
  "nextCursor": "eyJ2ZXJzaW9uIjoxfQ"
}

List of campaigns with metadata