RedRover Logo

Keywords

List Target Prompts

Lists the questions people ask AI assistants that you want to show up for, with each one's visibility over the last 30 days.

GET/target-prompts
Scope: keywords:readAI Connector Tool: redrover_list_target_prompts

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 target prompts.

  • dataobject[]Required
    Show 7 Child Fields
    • idstringRequired

      Prompt ID (UUID)

    • promptstringRequired

      The question people ask AI assistants

    • keywordstringRequired

      The keyword it is grouped under; null while unassigned

      nullable

    • funnelStagestringRequired

      nullable

    • brandedbooleanRequired

      Whether the prompt names your brand

    • createdAtstringRequired

      ISO 8601 datetime

    • visibilityobjectRequired
      Show 4 Child Fields
      • checksnumberRequired

        AI assistant answers checked in the last 30 days

      • mentionRatenumberRequired

        Share of answers that mention your brand, 0 to 1

        nullable

      • citationRatenumberRequired

        Share of answers that cite your site, 0 to 1

        nullable

      • averagePositionnumberRequired

        Average position of your citation among the sources

        nullable

  • 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/target-prompts?limit=25" \
  -H "Authorization: Bearer $REDROVER_API_KEY" \
  -H "X-Workspace-Id: $REDROVER_WORKSPACE_ID"
200 Response
{
  "data": [
    {
      "id": "5d2c8e41-9a7b-4f3e-8c6d-1b0a2e4f6c8d",
      "prompt": "What is the best product analytics tool for a small SaaS?",
      "keyword": "product analytics for startups",
      "funnelStage": "consideration",
      "branded": false,
      "createdAt": "2026-10-02T12:00:00Z",
      "visibility": {
        "checks": 42,
        "mentionRate": 0.38,
        "citationRate": 0.12,
        "averagePosition": 2.4
      }
    }
  ],
  "pagination": {
    "limit": 25,
    "offset": 0,
    "hasMore": false
  }
}