Source-URL-type breakdown

Returns a citation breakdown across the URL-type classifications, such as article, documentation, or product_page. The result is unpaginated and contains one row per enum value. This endpoint may not be scoped by segment.

GET /api/v1/analytics/source-url-types

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`.

Response

Per-URL-type analytics row

Field	Type	Description
source_url_type	string	The URL classification this row represents.
used_percentage	integer	The share of all citations in the window that came from URLs of this type.
used_percentage_change	integer	The difference in `used_percentage` compared with the equal-length period immediately preceding the window.

import os import requests response = requests.get( "https://pineprompt.com/api/v1/analytics/source-url-types", 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-url-types', [ '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);