X

Search and data

X for AI agents. One API key, ready-made tools.

Search recent posts on X, read posts and look up accounts and their timelines, reached with your Agent200 API key.

About X

With the X connector, your agent searches recent posts, reads single posts and looks up accounts and what they have posted. It is reached with your project’s Agent200 API key, so there is no separate X key to collect, store or rotate.

X, formerly Twitter, is a social network for short public posts, news and conversation.

Tools

What your agent can do in X.

Each tool is a capability the model can call. You decide which ones a project allows, and your Agent200 API key reaches them.

  • Search recent posts

    Read
    x_search_posts

    Find posts from the last seven days that match a query.

  • Get a post

    Read
    x_get_post

    Read a post with its author and engagement counts.

  • Get a user

    Read
    x_get_user

    Look up an account by username: name, bio and follower counts.

  • List a user's posts

    Read
    x_list_user_posts

    Read the most recent posts from an account.

Control

Limits you can set.

You decide what your agent may do in X, and Agent200 runs every call within those limits.

  • Turn single tools on or off

    Allow x_search_posts and x_get_post, and switch off x_list_user_posts if your agent should not follow particular accounts.

  • Restrict what the agent reaches

    Choose the endpoints a project may use. A call outside them is refused.

Get started

Connect X
in two steps.

  1. 1

    Set up the SDK

    Add the Agent200 SDK to the codebase you already have and authenticate with your API key. The key covers every connector enabled for the project.

    agent.js
    Conceptual example
    Set up the SDK with the Agent200 API key
    // One Agent200 API key covers every connector enabled for the project.
    const agent200 = new Agent200({
      apiKey: process.env.AGENT200_API_KEY,
    });
  2. 2

    Run with the X tools

    Name the model and the tools. The model decides which X tools to call, and Agent200 executes them with your Agent200 API key.

    run.js
    Conceptual example
    Run a request with the connector's tools
    const result = await agent200
      .user("user_123")
      .run({
        model: "openai/gpt-5.6-sol",
        input: "What are people posting about our launch today",
        tools: ["x"],
      });
    
    console.log(result.output);

For agents

Instructions for AI agents.

Using a coding agent? Paste this brief into it, or give it the address of this page. It describes the X connector and how to use it.

Agent brief
Connector: X, through Agent200. In code: "x".
What it does: Search recent posts on X, read posts and look up accounts and their timelines, reached with your Agent200 API key.
Page: https://www.agent200.com/tools/x/

1. Get an Agent200 API key. If the developer has none, send them to https://agent200.com/platform/apikeys/ and ask them to choose "Create an API key". Read the key from the AGENT200_API_KEY environment variable. Never ask for it in chat, and never write it into code, prompts or logs.
2. Agent200 reaches X with the project's Agent200 API key. No separate X key is needed.
3. Read tools: x_search_posts, x_get_post, x_get_user, x_list_user_posts. Name "x" in the tools of a request; the model decides which tool to call.
4. Stay within the project's settings. If a tool is turned off or a call is refused, tell the user. Do not work around it.
5. Before a write, confirm with the user, unless they asked for that exact change.
6. For setup with a specific framework, follow its guide:
   https://www.agent200.com/tools/x/framework/claude/
   https://www.agent200.com/tools/x/framework/chatgpt/
   https://www.agent200.com/tools/x/framework/claude-code/
   https://www.agent200.com/tools/x/framework/muse/
   https://www.agent200.com/tools/x/framework/grok-bot/
   https://www.agent200.com/tools/x/framework/openai-dots/
   https://www.agent200.com/tools/x/framework/claude-duet/
   https://www.agent200.com/tools/x/framework/hermes-agent/
   https://www.agent200.com/tools/x/framework/openclaw/

The code on the connector page is a conceptual example of the SDK. SDK reference: https://docs.igpt.ai/

This page is also available as Markdown, for agents and LLMs: /tools/x.md

Guides

Use X with the AI you build on.

Step-by-step setup for X with a specific model, assistant or agent framework.

FAQ

X and Agent200, answered.

Do I need my own X API key?

No. Your Agent200 API key reaches X, so there is no separate provider key to collect, store or rotate.

Can I limit what my agent can do in X?

Yes. You choose which services, endpoints and authorization scopes are allowed in your Agent200 configuration, and the agent works only within them.

  • Tavily

    Tavily

    Web search built for agents, reached with your Agent200 API key.

    Agent200 API key Search and data
  • Exa

    Exa

    Search the web by meaning, read page contents and find similar pages, reached with your Agent200 API key.

    Agent200 API key Search and data
  • Firecrawl

    Firecrawl

    Scrape pages into Markdown, crawl and map sites, and extract structured data, reached with your Agent200 API key.

    Agent200 API key Search and data
  • Brave Search

    Brave Search

    Search the web, news, images and videos from Brave's independent index, reached with your Agent200 API key.

    Agent200 API key Search and data
200 OK

Start with X.
Your agent does the rest.

Your agent reaches X with your Agent200 API key. No provider key to collect, store or rotate.

Book a demo.
See it in action.

Tell us who you are, then pick a time for a 1:1 session with an expert from our team.

We use your details only to email you about Agent200. See the Privacy Policy.

Pick a time. We'll take it from there.

A 1:1 session with an expert from our team, about what you are building.

Open in Calendly (opens in a new tab)