Skip to main content
GET
/
universes
/
{id}
/
prompts
Get full prompts row(s) — including AI answer + citations
curl --request GET \
  --url https://verseodin.com/api/v1/universes/{id}/prompts \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "day": "2023-12-25",
      "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "universe_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "job_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "prompt_id": 123,
      "prompt_text": "<string>",
      "engine": "chatgpt",
      "engine_account": "<string>",
      "website": {},
      "competitor_websites": [
        {}
      ],
      "priority_level": 123,
      "provider": "<string>",
      "attempts": 123,
      "snapshot_id": "<string>",
      "status": "pending",
      "error_text": "<string>",
      "created_at": "2023-11-07T05:31:56Z",
      "started_at": "2023-11-07T05:31:56Z",
      "finished_at": "2023-11-07T05:31:56Z",
      "response_text": "<string>",
      "appeared_links": [
        "<string>"
      ],
      "appeared_links_unique": [
        "<string>"
      ],
      "appeared_links_run1": [
        "<string>"
      ],
      "appeared_links_run2": [
        "<string>"
      ],
      "my_citations": [
        "<string>"
      ],
      "competitor_citations": [
        "<string>"
      ],
      "total_citations_count": 123,
      "my_domain_citations_count": 123,
      "my_brand_mentions_count": 123,
      "model_used": "<string>",
      "web_search_triggered": true,
      "cost_milli_cents": 123
    }
  ],
  "limit": 123,
  "offset": 123
}

Authorizations

Authorization
string
header
required

Generate a key at /dashboard/settings/api-keys. Pass it as Authorization: Bearer vso_xxx on every request.

Path Parameters

id
string<uuid>
required

Universe UUID — see GET /universes.

Query Parameters

day
string<date>

Pin the query to a specific day (YYYY-MM-DD). Without this, returns the most recent day.

engine
enum<string>

Filter to a single AI engine. Omit for all.

Available options:
chatgpt,
gemini,
grok,
claude
status
enum<string>

Filter by lifecycle status.

Available options:
pending,
processing,
completed,
failed
limit
integer
default:200
Required range: 1 <= x <= 1000
offset
integer
default:0
Required range: x >= 0

Response

OK

data
object[]
limit
integer
offset
integer