Runs

Raw platform responses from the latest usable or selected run

Returns enriched platform responses (one per prompt × platform) with parse state plus trusted brand mentions, citations, and attributes. Pass runId to read a specific completed run, or pair it with allowIncompleteRun=1 for live partial results. Empty array when no usable run exists.

get/prompts/results

Query parameters

projectIdstring uuid required

Project id. Required on all data endpoints.

runIdstring uuid

Prompt run ID. Omit to use the project's latest usable run. By default the run must be completed; pair with allowIncompleteRun=1 to read partial results from an owned in-progress, cancelled, or failed run. Use GET /prompts/runs to list run IDs.

topicIdstring uuid
promptIdstring uuid
platform'chatgpt' | 'chatgpt_app' | 'claude' | 'gemini' | 'gemini_app' | 'grok_app' | 'grok_api' | 'perplexity' | 'perplexity_app' | 'google_app' | 'deepseek'

LLM platform identifier. Newer scraper-backed ids end in _app; chatgpt, perplexity, and gemini are legacy and not returned by current runs.

limitinteger
allowIncompleteRun'1'

Set to 1 with runId to read partial results from an owned run in any status. Unknown and other-project run IDs return an empty array in this mode.

promptAttributesstring

Comma-separated list of attribute filters. Accepts both built-in attributes (e.g. pricing, comparisons) and project-specific custom attributes.

Response

Successful response

idstring uuid
llmPlatform'chatgpt' | 'chatgpt_app' | 'claude' | 'gemini' | 'gemini_app' | 'grok_app' | 'grok_api' | 'perplexity' | 'perplexity_app' | 'google_app' | 'deepseek'

LLM platform identifier. Newer scraper-backed ids end in _app; chatgpt, perplexity, and gemini are legacy and not returned by current runs.

rawResponsestring
promptUsedstring
createdAtstring date-time
promptIdstring uuid
parseState'pending' | 'running' | 'succeeded' | 'failed' | 'skipped'
mentionsobject[]
citationsobject[]
attributesobject[]

Changes

Changed in 2 of the 4 revisions of this API.3

    • added the optional property items/parseState to the response with the 200 status

      response-optional-property-added

    • added the new optional query request parameter allowIncompleteRun

      new-optional-request-parameter

    • added the new optional query request parameter runId

      new-optional-request-parameter