analytics

Source URL prompt analytics

Returns per-prompt aggregates scoped to a single source URL: how many distinct analyzed responses on each prompt cited the URL during the window, and when the URL was most recently cited. The response is paginated. This endpoint may not be scoped by segment.

get/api/v1/analytics/source-urls/{source_url}/prompts

Request

Base URL: https://pineprompt.com
URL: https://pineprompt.com/api/v1/analytics/source-urls/{source_url}/prompts
Auth: HTTP bearer

Path parameters

source_urlinteger required

The numeric ID of the source URL you would like to scope the analytics to.

Query parameters

start_datestring date required

Example:2026-04-01

The inclusive UTC start of the analytics window, given as an ISO 8601 date (YYYY-MM-DD).

end_datestring date required

Example:2026-05-20

The inclusive UTC end of the analytics window. The value must be on or after start_date, and on or before today.

platformsstring[]

You may use this parameter to limit responses to one or more AI platforms. Repeat the parameter for each value, for example ?platforms[]=chatgpt&platforms[]=claude. When omitted, every platform is included. Accepted values: chatgpt, perplexity, gemini, grok, copilot, claude, google_ai_mode, and google_ai_overview.

countriesstring[]

You may use this parameter to limit responses to monitors run in the given ISO-3166-1 alpha-2 country codes.

[
  "US",
  "NL"
]

monitorsinteger[]

You may use this parameter to limit responses to specific monitors inside the active project.

tagsinteger[]

You may use this parameter to limit responses to those whose prompt carries any of the given tag IDs, such as branded or non-branded.

[
  3,
  5
]

pageinteger

Example:1

The page number to return. Defaults to 1.

per_pageinteger

Example:25

The number of items per page. Defaults to 25, maximum 100.

sort_by'citation_count' | 'last_cited_on' | 'prompt' | 'monitor_name'

The field to sort by. Defaults to citation_count.

sort_order'asc' | 'desc'

The direction to sort by. Each endpoint has its own default.

Headers

Pineprompt-Project-Idinteger required

The active project's numeric ID.

Response

Example response

{
  "data": [
    {
      "prompt": {
        "id": 901,
        "monitor_id": 271,
        "prompt": "What are the best AI visibility monitoring tools?",
        "is_active": true,
        "monitor": {
          "id": 271,
          "project_id": 42,
          "name": "Brand visibility (US)",
          "platforms": [
            "chatgpt",
            "perplexity",
            "claude"
          ],
          "country": "US",
          "language": "en",
          "is_active": true,
          "project": {
            "id": 42,
            "organization_id": 7,
            "name": "Acme Marketing",
            "brand_id": 555,
            "organization": {
              "id": 7,
              "name": "Acme Inc.",
              "created_at": "2026-05-15T09:11:42+00:00",
              "updated_at": "2026-05-15T09:11:42+00:00"
            },
            "created_at": "2026-05-15T09:11:42+00:00",
            "updated_at": "2026-05-15T09:11:42+00:00"
          },
          "created_at": "2026-05-15T09:11:42+00:00",
          "updated_at": "2026-05-15T09:11:42+00:00"
        },
        "created_at": "2026-05-15T09:11:42+00:00",
        "updated_at": "2026-05-15T09:11:42+00:00"
      },
      "citation_count": 12,
      "last_cited_on": "2026-05-18"
    }
  ],
  "links": {
    "first": "https://pineprompt.com/api/v1/monitors?page=1",
    "last": "https://pineprompt.com/api/v1/monitors?page=1"
  },
  "meta": {
    "current_page": 1,
    "from": 1,
    "last_page": 1,
    "path": "https://pineprompt.com/api/v1/monitors",
    "per_page": 25,
    "to": 1,
    "total": 1,
    "links": [
      {
        "url": "https://pineprompt.com/api/v1/monitors?page=2",
        "label": "2",
        "page": 2
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.