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

# Twitter / X

> Search, analyze, and post on social media

Connect your agent to Twitter/X to search tweets, analyze users, and post content.

## How to enable

Go to **Settings → Capabilities** and enable the capabilities you need:

* **Twitter/X Search** — Search tweets, get user info, and analyze followers. Requires an API key from [TwitterAPI.io](https://twitterapi.io).
* **Twitter/X Post** — Post tweets and replies from your account. Requires Twitter OAuth credentials — see below.

## Example use cases

* **Brand Monitoring** — "Every morning, search Twitter for mentions of our company name and post a sentiment summary to Slack"
* **Competitor Tracking** — "Search Twitter for tweets from @competitor1 and @competitor2 this week and add a summary to my Notion research database"
* **Content Publishing** — "When interesting research articles are mentioned in slack channel #interesting-stuff, suggest a twitter post about it, wait for approval and then post it."
* **Community Engagement** — "Search Twitter for questions about our product, draft helpful replies, and send them to me for approval before posting"
* **Lead Research** — "When you receive an email about a new lead, search Twitter for their company and summarize their recent social activity"

## How to get Twitter/X credentials

### For Twitter/X Search

Twitter/X Search uses the [TwitterAPI.io](https://twitterapi.io) service. Sign up for an account and copy your API key.

### For Twitter/X Post

Posting requires OAuth credentials from an X Developer account:

<Steps>
  <Step title="Create an X Developer app">
    Go to [developer.x.com](https://developer.x.com) and sign in. Create a new project and app if you don't have one.
  </Step>

  <Step title="Enable user authentication">
    In your app settings, go to **User authentication settings** and enable it. Set **App permissions** to **Read and write**.
  </Step>

  <Step title="Generate credentials">
    Go to the **Keys and tokens** tab and generate:

    * **API Key** and **API Key Secret**
    * **Access Token** and **Access Token Secret**
  </Step>

  <Step title="Configure in Abundly">
    Go to **Settings → Capabilities**, enable **Twitter/X Post**, and enter all four credentials.
  </Step>
</Steps>

<Note>
  The X API Free tier has limited write access. You may need a Basic or Pro tier to post tweets via the API.
</Note>