List responses

Returns the AI responses collected in the active project, optionally filtered to a single prompt or to the responses that cite a given source URL. The response is paginated, with the newest returned first by default.

GET /api/v1/responses

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`.
prompt_id	integer	Optional	Limit results to responses belonging to a single prompt.
source_url_id	integer	Optional	Limit results to responses that cite the given source URL. A response qualifies when at least one of its citations points at that URL.
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: `prompt`, `prompt.monitor`, `prompt.monitor.project`, `prompt.monitor.project.organization`, `monitor`, `monitor.project`, `monitor.project.organization`, `project`, `project.organization`.

Response

Response schema

Field	Type	Description
data	Response[]
links	PaginationLinks
meta	PaginationMeta

The response object

Field	Type	Description
id	integer	The unique ID of the response.
prompt_id	integer	The numeric ID of the prompt that produced this response. You may pass this ID to the `prompt_id` filter on the list endpoint.
monitor_id	integer	The numeric ID of the monitor this response ran under.
prompt_text	string	The exact prompt text the platform was given.
platform	string	The AI platform that produced this answer.
model	string	The model identifier reported by the platform.
country	string	The ISO 3166-1 alpha-2 country code the response was run in.
language	string	The language the response was run in.
content	string	The raw markdown content the platform produced.
html	string	The rendered HTML form of the content, suitable for display.
excerpt	string	A whitespace-collapsed plain-text excerpt of the content, suitable for list views.
search_queries	string[]	The web search queries the platform ran while producing this answer, if any.
created_at	datetime	When the response was recorded.
updated_at	datetime	When the response was last updated.

import os import requests response = requests.get( "https://pineprompt.com/api/v1/responses", 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/responses', [ '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": 7842, "prompt_id": 901, "monitor_id": 271, "prompt_text": "What are the best AI visibility monitoring tools?", "platform": "chatgpt", "model": "gpt-4", "country": "US", "language": "en", "content": "string", "html": "string", "excerpt": "string", "search_queries": [ "string" ], "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 } ] } }