RedRover Logo

Strategy

List Blog Campaigns

Lists your blog campaigns, newest first, with how many articles are written.

GET/blog-campaigns
Scope: strategy:readAI Connector Tool: redrover_list_blog_campaigns

Headers

  • AuthorizationstringRequired

    Bearer followed by an rr_live_ API key or a connected app's access token. See Authentication.

  • X-Workspace-IdstringRequired

    The workspace to act on, from List Workspaces.

    UUID

Query Parameters

  • limitinteger

    How many results to return, 1 to 100 (default 25)

    1 to 100 · default 25

  • offsetinteger

    How many results to skip (default 0)

    default 0

Response

200 A page of blog campaigns.

  • dataobject[]Required
    Show 10 Child Fields
    • idstringRequired

      Blog campaign ID

      UUID

    • namestringRequired

      The campaign's name

    • objectivestringRequired

      What the campaign is for

      nullable

    • statusstringRequired

      Where the campaign stands, like active or completed

    • cadenceDaysnumberRequired

      Days between articles

      nullable

    • startDatestringRequired

      When it starts

      nullable

    • endDatestringRequired

      When it ends, if set

      nullable

    • articlesobjectRequired
      Show 3 Child Fields
      • plannednumberRequired

        Articles in the campaign

      • donenumberRequired

        Articles written

      • failednumberRequired

        Articles that could not be written

    • publishingbooleanRequired

      True when articles publish to your site automatically

    • createdAtdatetimeRequired

      When it was created

  • paginationobjectRequired
    Show 3 Child Fields
    • limitintegerRequired

      Page size used for this response

    • offsetintegerRequired

      How many results were skipped

    • hasMorebooleanRequired

      True when more results follow at a higher offset

Errors

Every error uses the error envelope.

  • 400limit or offset is not valid
  • 401The Authorization header is missing, or the key is invalid or revoked
  • 403The key lacks the endpoint's scope, or cannot reach the workspace
  • 429More than 120 requests in a minute. Wait for Retry-After seconds
  • 500Something went wrong on our side
curl "https://app.tryredrover.com/api/public/v1/blog-campaigns?limit=25" \
  -H "Authorization: Bearer $REDROVER_API_KEY" \
  -H "X-Workspace-Id: $REDROVER_WORKSPACE_ID"
200 Response
{
  "data": [
    {
      "id": "6a1b2c3d-4e5f-4a6b-9c7d-8e9f0a1b2c3d",
      "name": "Q1 Changelog Guides",
      "objective": "traffic",
      "status": "active",
      "cadenceDays": 3,
      "startDate": "2026-12-01",
      "endDate": "2027-02-28",
      "articles": {
        "planned": 30,
        "done": 4,
        "failed": 0
      },
      "publishing": true,
      "createdAt": "2026-11-20T15:00:00Z"
    }
  ],
  "pagination": {
    "limit": 25,
    "offset": 0,
    "hasMore": false
  }
}