Skip to main content
GET
/
universes
/
{id}
/
prompts
/
{prompt_id}
Get a single prompt by integer prompt_id
curl --request GET \
  --url https://verseodin.com/api/v1/universes/{id}/prompts/{prompt_id} \
  --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
  }
}

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.

​
prompt_id
integer
required

1-based position of the prompt inside the universe.

Required range: x >= 1

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

Response

OK

​
data
object

Single row from the prompts table — one row per (universe, day, engine, prompt_id). Every column is documented below as a separate response field. response_text carries the full AI answer body and my_citations / competitor_citations carry the actual cited URLs.