Skip to main content
GET
/
projects
/
{projectId}
/
prompts
/
{promptId}
/
history
curl "https://app.ranked.ai/api/v1/projects/{projectId}/prompts/{promptId}/history?limit=5" \
  -H "Authorization: Bearer rk_live_your_api_key"

{
  "success": true,
  "data": {
    "prompt_id": "bd17920c-61ff-4298-9116-f0a8035aabf3",
    "prompt": "Who provides tree services for HOA properties in Sioux City, Iowa?",
    "responses": [
      {
        "model": "perplexity/sonar",
        "is_visible": true,
        "position": 5,
        "citations_count": 6,
        "citations": [
          {
            "url": "https://siouxcitytreeco.com",
            "title": "siouxcitytreeco.com",
            "domain": "siouxcitytreeco.com"
          }
        ],
        "response_excerpt": "Several companies in Sioux City, IA, offer professional tree services...",
        "checked_at": "2026-05-10T00:30:51.679+00:00"
      }
    ]
  },
  "meta": {
    "pagination": { "total": 36, "limit": 5, "offset": 0, "has_more": true }
  }
}
Returns the full response history from each AI model, including the response content, brand position, and cited sources.

​
Path parameters

​
projectId
string
required
Project UUID
​
promptId
string
required
Prompt UUID

​
Query parameters

​
limit
number
default:"50"
Max responses to return
​
offset
number
default:"0"
Number to skip
​
date_from
string
Start date (ISO 8601). Defaults to 90 days ago.
​
date_to
string
End date (ISO 8601)
curl "https://app.ranked.ai/api/v1/projects/{projectId}/prompts/{promptId}/history?limit=5" \
  -H "Authorization: Bearer rk_live_your_api_key"

{
  "success": true,
  "data": {
    "prompt_id": "bd17920c-61ff-4298-9116-f0a8035aabf3",
    "prompt": "Who provides tree services for HOA properties in Sioux City, Iowa?",
    "responses": [
      {
        "model": "perplexity/sonar",
        "is_visible": true,
        "position": 5,
        "citations_count": 6,
        "citations": [
          {
            "url": "https://siouxcitytreeco.com",
            "title": "siouxcitytreeco.com",
            "domain": "siouxcitytreeco.com"
          }
        ],
        "response_excerpt": "Several companies in Sioux City, IA, offer professional tree services...",
        "checked_at": "2026-05-10T00:30:51.679+00:00"
      }
    ]
  },
  "meta": {
    "pagination": { "total": 36, "limit": 5, "offset": 0, "has_more": true }
  }
}