List citations

Returns every citation collected across the active project. The response is paginated, with the newest citations returned first by default.

GET /api/v1/citations

Query parameters

Name	Type	Required	Description
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`.
response_id	integer	Optional	Limit results to citations belonging to a single response.
sort_by	string	Optional	The column to sort by. Defaults to `created_at`.
sort_order	string	Optional	The direction to sort by. Each endpoint has its own default.
include	string	Optional	A comma-separated list of related resources to include in the response. Allowed values: `response`, `response.prompt`, `response.monitor`, `response.project`, `source_url`, `source_url.source`, `source_url.source.project`.

Response

Response schema

Field	Type	Description
data	Citation[]
links	PaginationLinks
meta	PaginationMeta

The citation object

Field	Type	Description
id	integer	The unique ID of the citation.
url	string	The URL that the AI engine cited.
title	string	The title of the cited page, if known.
description	string	A short description of the cited page, if known.
domain	string	The domain of the source that this citation belongs to.
position	integer	The one-indexed order in which the citation appeared in the response. A position of `1` means it was the first citation in the answer.
created_at	datetime	When the citation was recorded.
updated_at	datetime	When the citation was last updated.

import os import requests response = requests.get( "https://pineprompt.com/api/v1/citations", 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/citations', [ '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": [ { "id": 55821, "url": "https://example.com/blog/comparison", "title": "Comparison of AI visibility tools", "description": "string", "domain": "example.com", "position": 1, "created_at": "2026-05-15T09:11:42+00:00", "updated_at": "2026-05-15T09:11:42+00:00" } ], "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 } ] } }