Skip to main content
GET
/
universes
/
{id}
/
history
/
{day}
/
{engine}
Get a single history row by (day, engine)
curl --request GET \
  --url https://verseodin.com/api/v1/universes/{id}/history/{day}/{engine} \
  --header 'Authorization: Bearer <token>'
{
  "data": {
    "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "day": "2023-12-25",
    "engine": "chatgpt",
    "user_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "universe_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "job_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "prompts_ids": [
      "3c90c3cc-0d44-4b50-8888-8dd25736052a"
    ],
    "website": "<string>",
    "competitor_websites_plus_brand_tokens": [
      {}
    ],
    "ai_coverage_over_time": 123,
    "ai_trust_mentions": 123,
    "ai_avg_trust_position": 123,
    "ai_visibility_ranking": [
      {}
    ],
    "ai_top_prompts_by_trust_mentions": [
      {}
    ],
    "ai_visibility_index": [
      {}
    ],
    "ai_citations_ranked_urls": [
      {}
    ],
    "ai_competitive_analysis": [
      {}
    ],
    "ai_domain_citation_count": 123,
    "ai_citation_share": 123,
    "ai_top3_cited_urls": [
      {}
    ],
    "ai_top_domain_citations": [
      {}
    ],
    "ai_top_prompts_by_website_citations": [
      {}
    ],
    "geo_citations_over_time": 123,
    "geo_total_citations": 123,
    "geo_avg_citation_rank": 123,
    "geo_top_domains_in_citations": [
      {}
    ],
    "geo_top_prompts_citing_my_domain": [
      {}
    ],
    "geo_citation_index": [
      {}
    ],
    "geo_competitor_analysis": [
      {}
    ],
    "geo_citation_share": 123,
    "geo_top3_cited_urls": [
      {}
    ],
    "geo_prompts_vs_you_vs_competitors": [
      {}
    ],
    "geo_top_citing_domains": [
      {}
    ],
    "geo_top_queries_citing_my_domain": [
      {}
    ],
    "aeo_brand_mentions_over_time": 123,
    "aeo_your_brand_mentions": 123,
    "aeo_avg_mention_rank": 123,
    "aeo_top_surfaces_mentioning_you": [
      {}
    ],
    "aeo_top_prompts_driving_mentions": [
      {}
    ],
    "aeo_brand_mention_index": [
      {}
    ],
    "aeo_mention_share_over_time": [
      {}
    ],
    "aeo_total_mentions": 123,
    "aeo_mention_share": 123,
    "aeo_top3_urls_shown": [
      {}
    ],
    "aeo_prompt_mentions_vs_you_vs_competitors": [
      {}
    ],
    "aeo_top_surfaces_naming_your_brand": [
      {}
    ],
    "aeo_top_prompts_mentioning_my_brand": [
      {}
    ],
    "monitors_daily_brand_mentions": 123,
    "monitors_answer_coverage": 123,
    "monitors_citation_freshness": 123,
    "monitors_model_coverage": [
      {}
    ],
    "prompts_rows": [
      {}
    ]
  }
}

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.

day
string<date>
required

YYYY-MM-DD.

engine
enum<string>
required

AI engine identifier.

Available options:
chatgpt,
gemini,
grok,
claude

Response

OK

data
object

Single row from the history table — one row per (universe, day, engine) triple. Every column listed here is a separately documented response field; the *_over_time and *_index columns are JSONB arrays whose internal shape is described per-column.