Skip to main content
GET
/
universes
/
{id}
/
history
Get full history row(s) — every column
curl --request GET \
  --url https://verseodin.com/api/v1/universes/{id}/history \
  --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.

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
days
integer
default:1

Most-recent N days back from day (or today).

Required range: 1 <= x <= 90

Response

OK

data
object[]