agentCLAWHUBUnverified
twitterapi-io
Interact with Twitter/X via TwitterAPI.io — search tweets, get user info, post tweets, like, retweet, follow, send DMs, and more. Covers all 67 active endpoi... Skill: twitterapi-io Owner: dorukardahan Summary: Interact with Twitter/X via TwitterAPI.io — search tweets, get user info, post tweets, like, retweet, follow, send DMs, and more. Covers all 67 active endpoi... Tags: latest:3.8.5 Version history: v3.8.5 | 2026-04-29T04:06:24.978Z | user Remove duplicated monitored-users read reference v3.8.4 | 2026-04-25T10:34:33.936Z | user Sync live OpenAPI write params v3.8.3 | 20
OpenClaw
Rank
62
Safety
84
Downloads
2.3k
Updated
Oct 9, 2026
Version
3.8.5
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 2.3K downloads reported by the source. Last updated 10/9/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 9, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 9, 2026
- Adoption signal
- 2.3K downloadsadoption · observed Oct 9, 2026
- Latest release
- 3.8.5release · observed Apr 29, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17ec9h02rq9dyxk1p8ndsz7ps84kpzp:twitterapi-io- Setup complexity is classified as HIGH. You must provision dedicated cloud infrastructure or an isolated VM. Do not run this directly on your local workstation.
- Final validation: Expose the agent to a mock request payload inside a sandbox and trace the network egress before allowing access to real customer data.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-dorukardahan-twitterapi-io/snapshot"
Documentation
CLAWHUB
149,322 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
---
name: twitterapi-io
description: Interact with Twitter/X via TwitterAPI.io — search tweets, get user info, post tweets, like, retweet, follow, send DMs, and more. Covers all 67 active endpoints. Use when the user wants to read or write Twitter data.
metadata:
version: 3.8.5
updated: 2026-04-29
author: dorukardahan
---
# TwitterAPI.io skill v3.8.5
Access Twitter/X data and perform actions via [TwitterAPI.io](https://twitterapi.io) REST API.
Use TwitterAPI.io REST API for read, write, webhook, and stream operations.
Docs: https://docs.twitterapi.io | Dashboard: https://twitterapi.io/dashboard
---
## Setup
1. Get API key: https://twitterapi.io/dashboard ($0.10 free credits, no CC)
2. Store the key in a `.env` file or your shell's secure config (do not use raw `export` with the actual key in the terminal -- it gets saved to shell history).
3. For write actions, you also need `login_cookies` from v2 login + residential `proxy`.
Base URL: `https://api.twitterapi.io`
Auth header: `X-API-Key: $TWITTERAPI_IO_KEY` (all requests)
---
## Pricing (credit-based, 1 USD = 100,000 credits)
| Resource | Credits | Approx $/1K |
|----------|---------|-------------|
| Tweets (per returned tweet) | 15 | $0.15 |
| Profiles (per returned profile) | 18 | $0.18 |
| Profiles batch 100+ (per profile) | 10 | $0.10 |
| Followers (per returned follower) | 15 | $0.15 |
| Verified followers (per follower) | 30 | $0.30 |
| Minimum per API call | 15 | $0.00015 |
| List endpoint calls | 150 | $0.0015 |
| Check follow relationship | 100 | $0.001 |
| Get article | 100 | $0.001 |
| Community info | 20 | $0.0002 |
| Write actions (tweet, like, RT, follow) | 200-300 | $0.002-0.003 |
| Login | 300 | $0.003 |
Note: If the API returns 0 or 1 item, you are still charged the minimum (15 credits).
---
## QPS (rate limits) -- balance-based
| Account Balance (Credits) | QPS Limit |
|---------------------------|-----------|
| < 1,000 (free tier) | 1 req / 5 sec |
| >= 1,000 | 3 |
| >= 5,000 | 6 |
| >= 10,000 | 10 |
| >= 50,000 | 20 |
---
## API Notes
OpenAPI now also exposes several legacy auth/write paths alongside V2 endpoints. Prefer V2 where available.
V3 endpoints were taken offline by TwitterAPI.io in March 2026. Use V2 for write operations. For mission-critical tweet posting, consider Twitter's official API.
### login_cookie vs login_cookies -- API Inconsistency
The API has an inconsistency in naming:
- `user_login_v2` **response** returns the field as `login_cookie` (singular)
- All v2 **action** endpoints expect the field as `login_cookies` (plural)
**Always use `login_cookies` (plural) in request bodies.** The value is the same string.
---
## Response schemas
### Tweet object (from search, replies, etc.)
```json
{
"type": "tweet",
"id": "1234567890",
"url": "https://x.com/user/status/1234567890",
"text": "Tweet content...",
"source": "Twitter Web App",
"retweetCount": 5,
"replyCount": 2,
"likeCount": 42,
"quoteCount": 1,
"viewCount":README.md
# twitterapi-io-skill **Make any LLM use Twitter/X.** 67 active endpoints via [TwitterAPI.io](https://twitterapi.io) — search, post, like, retweet, follow, DM, communities, webhooks, profile management. No Twitter developer account needed. Works with any AI assistant. ## How it works `SKILL.md` is a single file that teaches an LLM how to use the Twitter API. It contains: - Every endpoint with method, path, and curl example - Required and optional query parameters for each endpoint - Request body schemas for all POST endpoints - Authentication, pricing, rate limits, pagination patterns - Login flow for write actions (tweet, like, retweet, follow) Drop it into your AI tool's context and it can start making real Twitter API calls. ## Use with OpenClaw ```bash mkdir -p ~/.openclaw/workspace/skills/twitterapi-io curl -o ~/.openclaw/workspace/skills/twitterapi-io/SKILL.md \ https://raw.githubusercontent.com/dorukardahan/twitterapi-io-skill/main/SKILL.md ``` Or install via ClawHub: ``` /install twitterapi-io ``` ## Use with Claude Code / Codex Add to your project context: ```bash curl -o SKILL.md https://raw.githubusercontent.com/dorukardahan/twitterapi-io-skill/main/SKILL.md ``` Then: "Read SKILL.md and search recent tweets about Bitcoin" ## Use with ChatGPT / Gemini / any LLM Paste the contents of `SKILL.md` into your conversation or system prompt. The LLM will understand how to construct curl commands for any Twitter operation. ## Endpoints (67 total) | Category | Count | Examples | |----------|-------|---------| | **Read** | 31 | Search, tweets, users, lists, communities, trends, spaces, account info | | **Write** | 28 | Login, tweet, like, retweet, follow, profile updates, DM, media, communities | | **Webhook + Stream** | 8 | Add/update/delete rules, monitor users | ## Requirements - [TwitterAPI.io](https://twitterapi.io) API key (free tier available) ## Related - [twitterapi-io-mcp](https://github.com/dorukardahan/twitterapi-io-mcp) — MCP server version (for Claude Desktop, Cursor, Windsurf) - [TwitterAPI.io docs](https://docs.twitterapi.io) ## License MIT
_meta.json
{
"ownerId": "kn77b8s4zg9075ey5krxamw24n80xx9b",
"slug": "twitterapi-io",
"version": "3.8.5",
"publishedAt": 1777435584978
}references/endpoint-index.md
# Endpoint Index (67 active endpoints) Note: OpenAPI spec contains 75 total paths. Excluded from this skill: 7 V3 (offline), 1 non-Twitter (`/plants`). ## READ (31 endpoints) | # | Method | Path | Category | |---|--------|------|----------| | 1 | GET | `/twitter/article` | tweet | | 2 | GET | `/twitter/community/get_tweets_from_all_community` | community | | 3 | GET | `/twitter/community/info` | community | | 4 | GET | `/twitter/community/members` | community | | 5 | GET | `/twitter/community/moderators` | community | | 6 | GET | `/twitter/community/tweets` | community | | 7 | GET | `/twitter/get_dm_history_by_user_id` | dm | | 8 | GET | `/twitter/list/followers` | list | | 9 | GET | `/twitter/list/members` | list | | 10 | GET | `/twitter/list/tweets` | list | | 11 | GET | `/twitter/list/tweets_timeline` | list | | 12 | GET | `/twitter/spaces/detail` | other | | 13 | GET | `/twitter/trends` | trend | | 14 | GET | `/twitter/tweet/advanced_search` | tweet | | 15 | GET | `/twitter/tweet/quotes` | tweet | | 16 | GET | `/twitter/tweet/replies` | tweet | | 17 | GET | `/twitter/tweet/replies/v2` | tweet | | 18 | GET | `/twitter/tweet/retweeters` | tweet | | 19 | GET | `/twitter/tweet/thread_context` | tweet | | 20 | GET | `/twitter/tweets` | tweet | | 21 | GET | `/twitter/user/batch_info_by_ids` | user | | 22 | GET | `/twitter/user/check_follow_relationship` | user | | 23 | GET | `/twitter/user/followers` | user | | 24 | GET | `/twitter/user/followings` | user | | 25 | GET | `/twitter/user/info` | user | | 26 | GET | `/twitter/user/last_tweets` | user | | 27 | GET | `/twitter/user/mentions` | user | | 28 | GET | `/twitter/user/search` | user | | 29 | GET | `/twitter/user/tweet_timeline` | user | | 30 | GET | `/twitter/user/verifiedFollowers` | user | | 31 | GET | `/twitter/user_about` | other | ## WRITE (28 endpoints) | # | Method | Path | Category | |---|--------|------|----------| | 32 | POST | `/twitter/bookmark_tweet_v2` | action | | 33 | POST | `/twitter/bookmarks_v2` | action | | 34 | POST | `/twitter/create_community_v2` | community | | 35 | POST | `/twitter/create_tweet` | action | | 36 | POST | `/twitter/create_tweet_v2` | action | | 37 | POST | `/twitter/delete_community_v2` | community | | 38 | POST | `/twitter/delete_tweet_v2` | action | | 39 | POST | `/twitter/follow_user_v2` | action | | 40 | POST | `/twitter/join_community_v2` | community | | 41 | POST | `/twitter/leave_community_v2` | community | | 42 | POST | `/twitter/like_tweet` | action | | 43 | POST | `/twitter/like_tweet_v2` | action | | 44 | POST | `/twitter/list/add_member` | list | | 45 | POST | `/twitter/list/remove_member` | list | | 46 | POST | `/twitter/login_by_2fa` | action | | 47 | POST | `/twitter/login_by_email_or_username` | action | | 48 | POST | `/twitter/retweet_tweet` | action | | 49 | POST | `/twitter/retweet_tweet_v2` | action | | 50 | POST | `/twitter/send_dm_to_user` | dm | | 51 | POST | `/twitter/unbookmark_tweet_v2` | action | | 52 | POST | `/twitter/unfol
references/read-endpoints.md
# READ Endpoints (GET, API key only)
## Tweet Endpoints
**Advanced Search** `GET /twitter/tweet/advanced_search`
```bash
curl -s "https://api.twitterapi.io/twitter/tweet/advanced_search?query=QUERY&queryType=Latest" \
-H "X-API-Key: $TWITTERAPI_IO_KEY"
```
Params: `query` (required), `queryType` (required, `Latest` | `Top`), `cursor`
Returns: `{ tweets[], has_next_page, next_cursor }` -- up to 20 tweets/page
**Get Tweets by IDs** `GET /twitter/tweets`
```bash
curl -s "https://api.twitterapi.io/twitter/tweets?tweet_ids=ID1,ID2,ID3" \
-H "X-API-Key: $TWITTERAPI_IO_KEY"
```
**Get Tweet Replies** `GET /twitter/tweet/replies`
```bash
curl -s "https://api.twitterapi.io/twitter/tweet/replies?tweetId=ID" \
-H "X-API-Key: $TWITTERAPI_IO_KEY"
```
Params: `tweetId` (required), `sinceTime` (unix seconds), `untilTime` (unix seconds), `cursor`
Returns: `{ replies[], has_next_page, next_cursor }` -- up to 20/page, ordered by reply time desc
Note: `has_next_page` may return true even when no more data exists (Twitter platform limitation).
**Get Tweet Replies V2** `GET /twitter/tweet/replies/v2`
```bash
curl -s "https://api.twitterapi.io/twitter/tweet/replies/v2?tweetId=ID&queryType=Latest" \
-H "X-API-Key: $TWITTERAPI_IO_KEY"
```
Params: `tweetId` (required), `queryType` (`Relevance` | `Latest` | `Likes`), `cursor`
Returns: `{ replies[], has_next_page, next_cursor }` -- supports sorting
**Get Tweet Quotations** `GET /twitter/tweet/quotes`
```bash
curl -s "https://api.twitterapi.io/twitter/tweet/quotes?tweetId=ID" \
-H "X-API-Key: $TWITTERAPI_IO_KEY"
```
Params: `tweetId` (required), `sinceTime` (unix seconds, optional), `untilTime` (unix seconds, optional), `includeReplies` (boolean, optional), `cursor` -- 20/page
**Get Tweet Retweeters** `GET /twitter/tweet/retweeters`
```bash
curl -s "https://api.twitterapi.io/twitter/tweet/retweeters?tweetId=ID" \
-H "X-API-Key: $TWITTERAPI_IO_KEY"
```
Params: `tweetId` (required), `cursor` -- ~100/page
**Get Tweet Thread Context** `GET /twitter/tweet/thread_context`
```bash
curl -s "https://api.twitterapi.io/twitter/tweet/thread_context?tweetId=ID" \
-H "X-API-Key: $TWITTERAPI_IO_KEY"
```
Params: `tweetId` (required, can be any tweet in thread), `cursor`
Returns full thread: ancestors + descendants. Page size varies (Twitter limitation).
**Get Article** `GET /twitter/article`
```bash
curl -s "https://api.twitterapi.io/twitter/article?tweet_id=TWEETID" \
-H "X-API-Key: $TWITTERAPI_IO_KEY"
```
Cost: 100 credits. Returns long-form article content from a tweet.
## User Endpoints
**Get User Info** `GET /twitter/user/info`
```bash
curl -s "https://api.twitterapi.io/twitter/user/info?userName=elonmusk" \
-H "X-API-Key: $TWITTERAPI_IO_KEY"
```
Returns: `{ data: UserObject, status, msg }`
**Get User Profile About** `GET /twitter/user_about`
```bash
curl -s "https://api.twitterapi.io/twitter/user_about?userName=USERNAME" \
-H "X-API-Key: $TWITTERAPI_IO_KEY"
```
Returns detailed bio with entities (links,Github ReposUpdated 6h agoRank 70
AionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
MCPOPENCLAW
Github ReposUpdated 6mo agoRank 70
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
OPENCLAW
Github ReposUpdated 6mo agoRank 70
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
MCPOPENCLAW
Github ReposUpdated 7mo agoRank 70
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
OPENCLAW
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/dorukardahan/skills/twitterapi-io",
"sourceUrl": "https://clawhub.ai/dorukardahan/skills/twitterapi-io",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T16:05:50.897Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-dorukardahan-twitterapi-io/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-dorukardahan-twitterapi-io/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-09T16:05:50.897Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "2.3K downloads",
"href": "https://clawhub.ai/dorukardahan/twitterapi-io",
"sourceUrl": "https://clawhub.ai/dorukardahan/twitterapi-io",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-09T16:05:50.897Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "3.8.5",
"href": "https://clawhub.ai/dorukardahan/twitterapi-io",
"sourceUrl": "https://clawhub.ai/dorukardahan/twitterapi-io",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-04-29T04:06:24.978Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-dorukardahan-twitterapi-io/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-dorukardahan-twitterapi-io/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 3.8.5",
"description": "Remove duplicated monitored-users read reference",
"href": "https://clawhub.ai/dorukardahan/twitterapi-io",
"sourceUrl": "https://clawhub.ai/dorukardahan/twitterapi-io",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-04-29T04:06:24.978Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.