> ## 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 X (Twitter) Organic data source to Adriel: authorize an X account, choose an account and user, and verify data.

X (Twitter) Organic (formerly Twitter Organic) surfaces account-level and post-level organic performance for a connected X account through the X API. Connecting it brings follower and following counts, post impressions, profile visits, and post engagement (likes, reposts, replies, bookmarks, quotes) into Adriel dashboards.

## Before you connect

The following are required:

* An X (Twitter) account to connect.
* X API access at a tier that exposes organic analytics — Basic tier or higher is typically required for tweet impressions and engagement metrics. Higher tiers unlock historical impressions, deeper engagement breakdowns, and longer lookback windows.
* Permission to authorize third-party applications against the account.
* An X (Twitter) account with access to an X Ads account. This is required to fetch the account list during connection; the X Ads account also needs a configured payment method before its account list is exposed.

## Connect X (Twitter) Organic

<Steps>
  <Step title="Authorize the X account">
    On the **Data Sources** page, search for **X (Twitter) Organic** and select it. Sign in to the X (Twitter) account when the pop-up window opens, then click **Authorize app** to grant access to the account.
  </Step>

  <Step title="Choose the account and user">
    On the data source settings, fill in the two required fields. For **Account**, choose the account to connect from the dropdown list. For **User**, choose the user to connect from the dropdown list.
  </Step>

  <Step title="Submit">
    Click **Submit** to complete the connection. Initial data availability can take up to one business day.
  </Step>
</Steps>

## What gets imported

Data arrives at daily granularity in UTC via the X API. Lifetime account and post data refresh once per day at 6:30 PM UTC, and the daily-page window refreshes the most recent 3 days at 6:00 PM UTC. The metric set depends on the API tier of the credentials used at authorization — higher tiers expose historical impressions and richer engagement breakdowns, while lower tiers may surface partial coverage. X also enforces strict rate limits on organic analytics endpoints, especially under Free and Basic tiers, which can delay or partially complete a refresh cycle.

For the complete list of metrics and breakdowns, see the [X (Twitter) Organic data reference](/data-sources/o-z/x-twitter-organic/data-reference).

## Troubleshooting

<AccordionGroup>
  <Accordion title="No accounts appear in the dropdown">
    The connection requires signing in with an X account that has access to an X Ads account. Without an ad account, the connector cannot fetch the account list. The X Ads account also requires a configured payment method before its account list is exposed via the Ads API.
  </Accordion>

  <Accordion title="Some metrics are missing or sparse">
    The X API meters organic analytics by access tier. Metrics such as historical impressions and bookmarks are typically gated to Basic tier or higher. Upgrade the X API plan backing the connection if richer coverage is needed.
  </Accordion>

  <Accordion title="A refresh cycle completed only partially">
    X's organic analytics endpoints enforce strict rate limits, particularly on Free and Basic tiers. Large or high-volume accounts can hit those limits mid-cycle. The next refresh picks up where the previous one stopped.
  </Accordion>

  <Accordion title="The connection has stopped refreshing">
    X refresh tokens eventually expire or can be revoked by the X account holder. Reconnect the data source through the OAuth flow to mint a new token pair.
  </Accordion>

  <Accordion title="Older posts show no daily values">
    The initial backfill retrieves posts created within the past 182 days but only with lifetime metrics — no historical daily values are reconstructed. Daily values accumulate going forward from the connection date.
  </Accordion>
</AccordionGroup>

## Related

<CardGroup cols={2}>
  <Card title="X (Twitter) Organic data reference" href="/data-sources/o-z/x-twitter-organic/data-reference">
    Metrics, breakdowns, refresh cadence, and limits for X (Twitter) Organic.
  </Card>

  <Card title="X (Twitter) Organic FAQs" href="/data-sources/o-z/x-twitter-organic/faqs">
    Common questions and expected behaviors for the X (Twitter) Organic data source.
  </Card>

  <Card title="How to connect X (Twitter) Ads" href="/data-sources/o-z/x-twitter-ads/how-to-connect">
    Connect paid X (Twitter) advertising campaigns.
  </Card>

  <Card title="How to connect LinkedIn Organic" href="/data-sources/g-n/linkedin-organic/how-to-connect">
    Connect owned LinkedIn Page analytics.
  </Card>
</CardGroup>