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

# How to connect

> How to connect the Sistrix data source to Adriel: paste a Sistrix API key, scope a target domain by country and device, and import Visibility Index and SEO reports.

Sistrix is a European SEO and SERP analytics platform best known for its Visibility Index (Sichtbarkeitsindex), a position- and search-volume-weighted score summarizing a domain's organic visibility for a given country and device. Connecting it brings Visibility Index time series, keyword rankings, competitor analysis, and on-page audit data into Adriel dashboards.

## Before you connect

The following are required:

* A Sistrix account with API access.
* A Sistrix API key. Sign in to Sistrix, open **Account** then **API access**, and copy the API key.
* The target domain, host, path, or URL to report on.
* The country code and device (desktop or mobile) for the SERP corpus.

## Connect Sistrix

<Steps>
  <Step title="Select the data source">
    On the **Data Sources** page, search for **Sistrix** and select it.
  </Step>

  <Step title="Paste the API key">
    Enter the Sistrix API key into the credential field and submit.
  </Step>

  <Step title="Choose the target">
    Select the **domain**, **host**, **path**, or **URL** the report should be scoped to.
  </Step>

  <Step title="Set country and device">
    Pick the Sistrix **country code** and either **desktop** or **mobile**. The Visibility Index is computed per country and device, so this selection defines the SERP corpus for the report.
  </Step>

  <Step title="Select an Optimizer project (optional)">
    For project-scoped on-page reports, choose a connected Sistrix **Optimizer project**.
  </Step>

  <Step title="Save the connection">
    Confirm to save the connection and start the initial 90-day backfill. The first sync runs in the background.
  </Step>
</Steps>

## What gets imported

Visibility Index time-series data is backfilled for the last 90 days on first connection, then refreshed for the latest 10 days at 12:00 AM and 2:00 PM UTC. Snapshot reports (domain overview, competitors, ranking distribution, opportunity keywords, keyword traffic, and Optimizer on-page metrics) return current values from a file-based cache.

For the complete list of metrics, breakdowns, endpoints, and cache behavior, see the [Sistrix data reference](/data-sources/o-z/sistrix/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="Visibility Index values differ across country or device">
    The Visibility Index is computed per country and device. A value for `de`/desktop is not directly comparable to `de`/mobile or to another country. Confirm the country and device selected on the connection match the intended SERP corpus.
  </Accordion>

  <Accordion title="Domain age returns a dash">
    The `domain.age` endpoint is deprecated upstream and may return a placeholder value (`-`) instead of a number. No action is required; the field is retained for backwards compatibility.
  </Accordion>

  <Accordion title="Social metrics are missing">
    Sistrix's `domain.social.*` endpoints require additional API access that is not currently provisioned for this connector. Social data is not available.
  </Accordion>

  <Accordion title="Older dates appear frozen">
    Only the latest 10 days are refreshed twice daily. Dates outside that rolling window remain at their originally fetched values.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="Sistrix data reference" href="/data-sources/o-z/sistrix/data-reference">
    Metrics, breakdowns, endpoints, and cache behavior for Sistrix.
  </Card>

  <Card title="Sistrix FAQs" href="/data-sources/o-z/sistrix/faqs">
    Common questions and expected behaviors for the Sistrix data source.
  </Card>

  <Card title="How to connect SEMrush" href="/data-sources/o-z/semrush/how-to-connect">
    Connect an alternative SEO and competitive-research platform.
  </Card>

  <Card title="How to connect SE Ranking" href="/data-sources/o-z/se-ranking/how-to-connect">
    Connect another SEO rank-tracking and audit platform.
  </Card>
</CardGroup>