Prompt-level citation analytics for a source URL

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

Path parameters

Name	Type	Required	Description
source_url	integer	Required	The numeric ID of the source URL you would like to scope the analytics to.

Query parameters

Name	Type	Required	Description
start_date	string	Required	The inclusive UTC start of the analytics window, given as an ISO 8601 date (`YYYY-MM-DD`).
end_date	string	Required	The inclusive UTC end of the analytics window. The value must be on or after `start_date`, and on or before today.
models	string[]	Optional	You may use this parameter to limit responses to one or more AI engines. Repeat the parameter for each value, for example `?models[]=chatgpt&models[]=claude`.
countries	string[]	Optional	You may use this parameter to limit responses to monitors run in the given ISO-3166-1 alpha-2 country codes.
monitors	integer[]	Optional	You may use this parameter to limit responses to specific monitors inside the active project.
tags	integer[]	Optional	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`.
page	integer	Optional	The page number to return. Defaults to `1`.
per_page	integer	Optional	The number of items per page. Defaults to `25`, maximum `100`.
sort_by	string	Optional	The field to sort by. Defaults to `citation_count`.
sort_order	string	Optional	The direction to sort by. Each endpoint has its own default.

Response

Response schema

Field	Type	Description
data	SourceUrlPromptAnalytics[]
links	PaginationLinks
meta	PaginationMeta

Per-prompt citation analytics for a source URL

Field	Type	Description
prompt	Prompt	The prompt this row covers.
citation_count	integer	The number of distinct analyzed responses on this prompt that cited the URL during the window.
last_cited_on	string	The most recent date in the window that a response to this prompt cited the URL. `null` when the URL was never cited.

import os import requests response = requests.get( "https://pineprompt.com/api/v1/analytics/source-urls/1/prompts", headers={ "Authorization": f"Bearer {os.environ['PINEPROMPT_TOKEN']}", "Pineprompt-Project-Id": "1", }, ) response.raise_for_status() payload = response.json()

use GuzzleHttp\Client; $response = (new Client())->get('https://pineprompt.com/api/v1/analytics/source-urls/1/prompts', [ 'headers' => [ 'Authorization' => 'Bearer '.getenv('PINEPROMPT_TOKEN'), 'Pineprompt-Project-Id' => '1', ], ]); // Guzzle throws on 4xx/5xx by default, so no manual check needed. $payload = json_decode((string) $response->getBody(), true);

{ "data": [ { "prompt": { "id": 901, "monitor_id": 271, "prompt": "What are the best AI visibility monitoring tools?", "is_active": true, "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", "prev": null, "next": null }, "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, "active": false } ] } }