UseTrawsnUseTrawsn
Capabilities

Generate

Image GenerationCreate and edit images from prompts or references.Video GenerationCreate motion outputs from text and image inputs.Music GenerationProduce music tracks through one runtime.Audio GenerationGenerate speech, dialogue, sound effects, and complete audio scenes from text, audio, or image input.

Understand

Image UnderstandingRead screenshots, diagrams, and visual references.Video AnalysisInspect recordings and extract structured details.Audio UnderstandingTranscribe and analyze voice and audio files.

Retrieve

Web SearchSearch the web from the same agent workflow.Grounded Web SearchReturn synthesized answers with live citations.Web CrawlFetch pages and convert them into clean content.Social Media LookupRead Instagram and X profiles, posts, feeds, and X search results.

Store

DriveStore outputs, organize assets, and create public URLs.
Equip Agents
Claude CodeCursorCodexDeepSeek HarnessManus
Resources

Explore

GuidesDecision guides for building reliable agent workflows.Context EngineeringUnderstand how prompts, files, and workspace state shape agent behavior.Agent SkillsSee how reusable skills package workflows and capability usage for agents.

Evaluate

Compare UseTrawsnBrowse comparison pages for adjacent agent tooling, media APIs, and tradeoffs.GlossaryA shared vocabulary for agent capabilities, tools, and workflows.
Docs ↗Pricing
I'm Agent
I'm Agent
  1. Home
  2. Guides
  3. X (Twitter) Data for AI Agents

Guide · By UseTrawsn Team

X (Twitter) data for AI agents

UseTrawsn lets an AI agent read X profiles, posts, account feeds, and search results as structured JSON through one CLI command.

A lot of what agents are asked to track happens on X: product launches, announcements, and how people react to them. Social lookup gives the agent the posts and metrics as fields, so it can summarize a topic or compare accounts and link every claim to a source post.

Set up UseTrawsn

  1. 1. Install the UseTrawsn skill

    $
    npx -y skills add usetrawsn-ai/usetrawsn -a claude-code -y
  2. 2. Install the CLI

    $
    curl -fsSL https://usetrawsn.ai/install.sh | sh
  3. 3. Log in once

    $
    usetrawsn login

Read an account profile

Profile lookup returns the display name, bio, verification flag, and follower, following, and post counts. It also returns the account's platform ID, which you need to list its posts.

Look up a profile

$
usetrawsn social profile --platform x --username nasa

List an account's recent posts

X feeds are addressed by platform ID, not username. Read the ID from the profile result and pass it with --user-id.

Profile, then feed

$
USER_ID=$(usetrawsn social profile --platform x --username nasa | jq -r '.data.profile.platform_id')
usetrawsn social list --platform x --user-id "$USER_ID"

What this looks like in Codex

We gave Codex CLI one English prompt and let it choose the commands. It read the UseTrawsn skill, looked up the profile, and listed the feed by platform ID, the same two steps as above.

Prompt used

Use UseTrawsn to find NASA's latest posts on X. Look up the @NASA profile, then list the 5 most recent posts with their date, likes, and link. Keep the answer short.
Codex CLI terminal showing it ran usetrawsn social profile for NASA on X, then usetrawsn social list with NASA's platform ID, each returning JSON with a credit cost of 1.
Codex runs a profile lookup, then a feed list by platform ID. --platform twitter and --platform x are interchangeable. Production run, UseTrawsn CLI 0.6.4, September 29, 2026.
Codex answer listing @NASA's latest five X posts with UTC time, a short description, and like counts, noting that reposts report 0 likes.
Codex's answer from the returned JSON. It flags that repost entries report 0 likes instead of guessing the original post's count. Two lookups, 2 credits.

Search X posts

Search takes a keyword or an X search expression and returns one batch of Top results.

Search by keyword

$
usetrawsn social search --platform x --query 'artemis'

Search one account's posts

$
usetrawsn social search --platform x --query 'from:nasa'

Keep text, time, and link

$
usetrawsn social search --platform x --query 'from:nasa' | jq '.data.items | map({published_at, text, url})'

Fetch a single post by URL

Pass an HTTPS status permalink from x.com or twitter.com to read the post's text, author, media, and metrics.

Read a post

$
usetrawsn social get --url "https://x.com/<username>/status/<post-id>"

Ask the agent in plain language

Topic summary

Search X for posts about our launch and summarize the main reactions with links.

Account comparison

Compare the follower counts and last batch of posts for @nasa and @esa on X.

Read the results correctly

IDs are strings
X IDs are too large for many number types. Keep platform_id and post IDs as strings, and pass them through jq -r rather than doing arithmetic on them.
Text-only posts
A post without images or video has media_type "text" and an empty media array.
Reposts and quotes
When available, repost and quote counts appear in metrics.reposts and metrics.quotes next to likes, comments, and views.
Null is not zero
A metric the platform did not return is null. Report it as unavailable instead of as zero engagement.
Platform name
You can pass --platform x or --platform twitter. Results always use twitter, and returned post URLs use x.com.

What social lookup does not do

  • Lookup is read-only. It does not post, reply, like, repost, follow, or send messages.
  • Search uses X's Top results. There is no Latest mode or alternate search mode.
  • List and search return one batch each. There is no cursor, requested count, or full-history export.
  • A list needs the account's platform ID. It does not resolve a username on its own.

FAQ

Can an AI agent read X without the X API?

+

Yes. UseTrawsn social lookup reads X profile, post, feed, and search data through one CLI and one UseTrawsn login, so the agent does not need its own X developer app, API tier, or bearer token.

Why does social list need --user-id instead of a username?

+

X feeds are addressed by the account's numeric platform ID. Look up the profile first, read data.profile.platform_id, and pass it as a string with --user-id. Profile and list are separate billed calls.

What can I put in a search query?

+

A keyword or an X search expression, such as from:nasa to read one account's posts. Results come from X's Top search, in one batch.

Does social get accept twitter.com links?

+

Yes. It accepts HTTPS status permalinks on x.com or twitter.com. The returned post URL uses x.com.

Continue from here

  • Social media lookup capability →

    See all four social operations across Instagram and X.

  • Instagram data for AI agents →

    Profiles, posts, reels, and account feeds on Instagram.

  • Grounded web search →

    Combine X posts with cited web sources for a fuller answer.

CLI version and updating · 0.6.5

Current release checked October 21, 2026: 0.6.5. Use the update command for your installation method, then verify the version and login in the same environment that runs your agent.

Direct binary installation

$
usetrawsn update

npm installation

$
npm install -g @usetrawsn/cli@latest
$
usetrawsn --version
usetrawsn status

Version 0.6.5 retries transient downloads, recovers an expired video link by querying the same task, and saves multiple image outputs to numbered files. After a video download failure, resume the existing task instead of generating again.

$
usetrawsn video tasks wait <task-id> -o result.mp4

Dated examples retain the CLI version, output and charge from the original run. Updating the CLI does not revalidate an old result. Check the live model schema and current pricing before a new billed task.

Capabilities

  • Overview
  • Image Generation
  • Video Generation
  • Music Generation
  • Image Understanding
  • Video Analysis
  • Audio Understanding
  • Web Search
  • Grounded Web Search
  • Web Crawl
  • Social Media Lookup
  • Drive

Equip Agents

  • Overview
  • Start here
  • Claude Code
  • Cursor
  • Codex
  • Manus

Resources

  • Overview
  • Context Engineering
  • Agent Skills
  • What Agents Can't Do
  • Compare agents and tools

Product

  • Product overview
  • Models
  • Install UseTrawsn
  • Install the Agent Skill

Documentation

  • Docs overview
  • Install UseTrawsn
  • MCP setup
  • CLI reference

Company

  • About
  • Contact
  • Privacy
  • Terms
UseTrawsn
Join the UseTrawsn Discord