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

# X (Twitter) on Vortex IQ

> Monitor X (Twitter) publishing, engagement and freshness, and catch decay before organic reach erodes.

Monitor X (Twitter) publishing, engagement and freshness, and catch decay before organic reach erodes.

[Connect or manage this source](https://app.vortexiq.ai/workbench/settings/sources) · [How connecting works](/integrations/connector-catalogue) · [Create a workflow](https://app.vortexiq.ai/workbench/flows/create?connector=twitter)

<CardGroup cols={5}>
  <Card title="23">
    performance signals
  </Card>

  <Card title="3">
    automated checks
  </Card>

  <Card title="0">
    prepared fixes
  </Card>

  <Card title="0">
    proven workflows
  </Card>

  <Card title="178">
    API operations
  </Card>
</CardGroup>

<Tabs>
  <Tab title="Overview">
    ### What you can achieve

    Capabilities are grouped around merchant outcomes, not API terminology.

    <CardGroup cols={2}>
      <Card title="Grow revenue">
        Improve discovery, conversion, campaigns and repeat purchase.
      </Card>

      <Card title="Run operations">
        Monitor orders, fulfilment, delivery and settlement.
      </Card>

      <Card title="Customer experience">
        Find storefront, speed, accessibility and journey problems.
      </Card>

      <Card title="Control risk and change">
        Keep tracking, access and change under governed control.
      </Card>
    </CardGroup>

    ### From connection to verified outcome

    The controlled sequence every capability follows. Nothing changes a connected system without the approval step.

    <Steps>
      <Step title="Connect">
        Authorise the source. Scopes are shown before access is granted.
      </Step>

      <Step title="Monitor">
        Watch the signals against your own baselines, not universal defaults.
      </Step>

      <Step title="Detect">
        Run checks and gather evidence specific to your store.
      </Step>

      <Step title="Recommend">
        Explain what happened, why it matters and the proposed action.
      </Step>

      <Step title="Approve">
        You review scope, risk and reversibility before anything changes.
      </Step>

      <Step title="Execute">
        Apply through governed connector operations.
      </Step>

      <Step title="Verify">
        Confirm the intended result and keep the receipt.
      </Step>
    </Steps>

    No changes are made without the configured approval policy. Read-only operations do not modify the connected system; schedules, access scopes, API usage and data handling remain governed by Vortex IQ controls.
  </Tab>

  <Tab title="Monitor (23)">
    ### Monitor performance

    23 performance signals. Open an outcome to see its signals and how each one alerts. Read-only operations do not modify the connected system.

    <AccordionGroup>
      <Accordion title="Grow revenue (16 signals)">
        | Signal                                | Alert behaviour    | What it tracks                                                                                                                   |
        | ------------------------------------- | ------------------ | -------------------------------------------------------------------------------------------------------------------------------- |
        | **Account Age (days)**                | Watch only         | Days since users/me created\_at.                                                                                                 |
        | **Bookmarks (30d)**                   | Watch only         | Sum of public\_metrics.bookmark\_count; save-for-later intent.                                                                   |
        | **Days Since Last Post**              | Watch only         | Days since the most recent post. Silent cadence collapse is the top organic-social decay signal.                                 |
        | **Engagement Drop Alert**             | Alert band 3 / 1   | Current 30d engagement rate; sentiment fires when it crosses the engagement\_rate band.                                          |
        | **Engagement Rate**                   | Alert band 3 / 1   | Avg per-post (likes + replies + reposts + quotes) / followers x 100 across posts in the last 30d.                                |
        | **Engagement per 1k Followers (30d)** | Watch only         | Total 30d engagement / followers x 1000; size-normalised engagement.                                                             |
        | **Follower : Following Ratio**        | Watch only         | followers\_count / following\_count; a rough authority signal.                                                                   |
        | **Following**                         | Watch only         | users/me public\_metrics.following\_count.                                                                                       |
        | **Likes (30d)**                       | Watch only         | Sum of public\_metrics.like\_count.                                                                                              |
        | **Listed Count**                      | Watch only         | users/me public\_metrics.listed\_count; how many curated lists include the account.                                              |
        | **Replies (30d)**                     | Watch only         | Sum of public\_metrics.reply\_count; conversation signal.                                                                        |
        | **Reposts + Quotes (30d)**            | Watch only         | Sum of retweet\_count + quote\_count; amplification signal.                                                                      |
        | **Social Health Score**               | Alert band 90 / 70 | Composite 0-100: engagement rate (50%) x posting cadence (30%) x days-since-last-post (20%), from users/me + the last 200 posts. |
        | **Top Posts by Engagement**           | Watch only         | Top 10 posts by likes + replies + reposts + quotes.                                                                              |
        | **Total Engagement (30d)**            | Watch only         | Sum of likes + replies + reposts + quotes over posts in the last 30d.                                                            |
        | **Total Posts (lifetime)**            | Watch only         | users/me public\_metrics.tweet\_count.                                                                                           |
      </Accordion>

      <Accordion title="Customer experience (4 signals)">
        | Signal                             | Alert behaviour | What it tracks                                                               |
        | ---------------------------------- | --------------- | ---------------------------------------------------------------------------- |
        | **Avg Impressions per Post (30d)** | Watch only      | Mean impression\_count over posts in the last 30d (user-context token only). |
        | **Avg Likes per Post (30d)**       | Watch only      | Mean public\_metrics.like\_count over posts in the last 30d.                 |
        | **Avg Replies per Post (30d)**     | Watch only      | Mean public\_metrics.reply\_count over posts in the last 30d.                |
        | **Posts Published Trend**          | Watch only      | Posts per month across the fetched window (up to 200 posts).                 |
      </Accordion>

      <Accordion title="Run operations (2 signals)">
        | Signal          | Alert behaviour    | What it tracks                             |
        | --------------- | ------------------ | ------------------------------------------ |
        | **Followers**   | Alert band 0 / -2  | users/me public\_metrics.followers\_count. |
        | **Posts (30d)** | Alert band 0 / -40 | Count of posts created in the last 30d.    |
      </Accordion>

      <Accordion title="Control risk and change (1 signals)">
        | Signal                | Alert behaviour | What it tracks                                                                                                                             |
        | --------------------- | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
        | **Impressions (30d)** | Watch only      | Sum of public\_metrics.impression\_count over posts in the last 30d. Owner user-context token only; app-only bearer tokens render no data. |
      </Accordion>
    </AccordionGroup>
  </Tab>

  <Tab title="Audit (3)">
    ### Audit risks and opportunities

    A fix status appears only where the action, inputs, approval, verification and recovery controls are mapped. Candidate remediations are never executable. Open a check for the detail.

    <AccordionGroup>
      <Accordion title="Engagement rate below 1%">
        **Severity** medium · **Outcome** Grow revenue · **Fix status** Report only

        Engagement below 1 percent means content is reaching feeds and being scrolled past; format and hook need work before spend goes behind it.

        Vortex IQ detects and explains this; resolution is manual, with evidence and recommended steps.

        Reference: `SOCIAL-ENGAGEMENT-001`
      </Accordion>

      <Accordion title="Reach dropped > 20% vs prior period">
        **Severity** medium · **Outcome** Run operations · **Fix status** Report only

        Reach dropping over 20 percent usually means the algorithm has deprioritised the account or a format change landed badly; catching it early keeps the slide shallow.

        Vortex IQ detects and explains this; resolution is manual, with evidence and recommended steps.

        Reference: `SOCIAL-REACH-001`
      </Accordion>

      <Accordion title="Posting cadence collapsed (no post in 14 days)">
        **Severity** low · **Outcome** Grow revenue · **Fix status** Candidate remediation

        Posting cadence collapsing to zero lets the audience's attention lapse; reach compounds only while the account stays present.

        A likely corrective operation exists, but its mapping and recovery are not yet complete, so execution is not offered. Evidence and recommended manual steps are provided.

        Reference: `SOCIAL-CADENCE-001`
      </Accordion>
    </AccordionGroup>

    #### Build your own automated fixes

    Turn any finding into an automated fix with a Vortex IQ workflow: **over 13,000 read and write operations across more than 200 connectors** are available as building blocks, with approval, verification and rollback on every change.
  </Tab>

  <Tab title="Automate">
    ### Automate approved work

    Vortex IQ is integrated with **100 read** and **78 write** operations across activitysubscriptions, broadcastscheduleds, lists, tweets, webhooks, account activitywebhooksubscriptionalls on X (Twitter). Combine them with anything from the **over 13,000 operations across more than 200 connectors** to automate the work in your own words.

    Changes follow your configured approval policy: the target, proposed change, affected records, risk, reversibility and verification plan are shown before execution.

    [Create a workflow](https://app.vortexiq.ai/workbench/flows/create?connector=twitter)

    #### Ready to build your first X (Twitter) workflow

    Pick a trigger, add the operations above as steps, and every step that changes data pauses for your approval. Monitoring and audits are live now and can start any workflow you build.

    <Accordion title="Browse the operations you can build with">
      | Resource                                | Read operations | Write operations |
      | --------------------------------------- | --------------- | ---------------- |
      | activitysubscriptions                   | 1               | 4                |
      | broadcastscheduleds                     | 2               | 3                |
      | lists                                   | 1               | 3                |
      | tweets                                  | 2               | 2                |
      | webhooks                                | 1               | 3                |
      | account activitywebhooksubscriptionalls | 1               | 2                |
      | broadcastchats                          | 1               | 2                |
      | compliancejobs                          | 2               | 1                |

      Signed-in users see the full catalogue in the workflow builder, filtered to the sources they have connected.
    </Accordion>
  </Tab>
</Tabs>
