> ## Documentation Index
> Fetch the complete documentation index at: https://docs.videntic.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Public API

> Public API V2 private-preview access and the discoverable reference for existing, deprecated V1 integrations.

<Warning>
  Public API V1 is deprecated but remains operational. No Sunset date has been
  announced, and existing V1 clients are never silently redirected. New
  integrations should [review the V2 migration and private-preview
  guide](/api/v2-migration) and request access through `api@videntic.com`.
</Warning>

The Videntic Public API lets enterprise customers connect their AI visibility
data to BI warehouses, internal dashboards, sync pipelines, or partner
integrations. Public API V2 is a separately versioned private preview that is
disabled by default; it is not generally available or production-ready.

The content below describes the discoverable V1 reference for existing
integrations. V1 remains on its released contract while deprecated.

<Note>
  Existing V1 customers with a docs password can [open the V1
  reference](/api/authentication). For a new integration, request the
  [V2 private preview](mailto:api@videntic.com?subject=Public%20API%20V2%20private%20preview)
  instead of starting on V1.
</Note>

## What you can pull

<CardGroup cols={2}>
  <Card title="Websites" icon="globe">
    Every URL tracked under your workspace, with country, language, niche, and last-scrape time.
  </Card>

  <Card title="Brand mentions" icon="quote-left">
    Every sentence captured from an LLM response where your brand was named, with the provider and position. Prompt-library text is not exposed.
  </Card>

  <Card title="Analytics reports" icon="file-pdf">
    Metadata for every PDF report generated in your workspace, with a signed-URL download endpoint.
  </Card>

  <Card title="Competitors" icon="users">
    Domains we've detected as competitors of your tracked websites, with appearance counts, average position, and first/last-seen timestamps.
  </Card>
</CardGroup>

## How it works

* **Bulk snapshot** — one call returns websites, recent mentions, recent reports, and competitors in a single envelope. Use for nightly mirrors, BI loads, or quick exports.
* **Paginated list endpoints** — newest-first, cursor-based, with `updated_since` filters for incremental sync. Use for steady-state operations.
* **Cross-tenant isolation** — every key is scoped to exactly one workspace. The API never returns rows from another tenant, and unknown IDs return 404 without leaking whether they exist elsewhere.
* **Deprecated V1 contract** — existing endpoints remain under `/public/v1/` and are never silently redirected. Consumers should ignore unknown fields and use the canonical metric names. If you integrated before the TypeScript cutover, follow the [older-client migration guide](/api/typescript-migration).

## Who it's for

The Public API is part of the **Enterprise** plan. It's the right fit for:

* Multi-location and multi-region brands that want their AI visibility data in BI tools (Looker, Tableau, Snowflake, BigQuery).
* Agencies and platforms reselling AI visibility insights to their own customers.
* Internal dashboards that combine Videntic data with first-party traffic, conversion, or CRM signals.

If you're on a non-enterprise plan, the same data is available through the dashboard, scheduled email reports, and PDF exports.

## Access and reference

<CardGroup cols={2}>
  <Card title="Request the V2 private preview" icon="envelope" href="mailto:api@videntic.com?subject=Public%20API%20V2%20private%20preview">
    Tell the API team your workspace, integration shape, current V1 routes if
    applicable, and expected request volume. Preview routing is disabled until
    access is explicitly enabled.
  </Card>

  <Card title="Existing V1 integration" icon="lock" href="/api/authentication">
    Open the deprecated V1 reference. You'll be prompted for the docs password
    on the way in, and the session lasts until your browser clears it.
  </Card>
</CardGroup>