[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M75FHG9F2QSP915CC1JTEN6W":3,"skill-same:01M75FHG9F2QSP915CC1JTEN6W":51},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":16,"categories":17,"keywords":18,"publishedAt":19,"linkOnly":20,"markdownContent":21,"markdownBody":22,"frontMatter":23,"refName":28,"commitSha":29,"skillDirectory":30,"forksCount":31,"repositoryHtmlUrl":32,"repositoryHomepageUrl":6,"ownerHtmlUrl":33,"ownerBlogUrl":34,"ownerDescription":35,"updatedAt":36,"install":37,"resources":50},"01M75FHG9F2QSP915CC1JTEN6W","twitterapi-io",null,"Interact with Twitter\u002FX via TwitterAPI.io — search tweets, get user info, post tweets, like, retweet, follow, send DMs, and more. Covers all 58 endpoints. Use when the user wants to read or write Twitter data.","javimosch\u002Fopen-claw-skills","javimosch","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F12900508?v=4","01M6D3F2AS6PV75ET9PZ1QGP8J","Javier Leandro Arancibia","01M75B8NCTAJG9WH5YNZH7C3D8",0,"MIT","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fdorukardahan\u002Ftwitterapi-io\u002FSKILL.md",[],[],"2026-11-12 13:55:43",false,"---\nname: twitterapi-io\ndescription: Interact with Twitter\u002FX via TwitterAPI.io — search tweets, get user info, post tweets, like, retweet, follow, send DMs, and more. Covers all 58 endpoints. Use when the user wants to read or write Twitter data.\nmetadata:\n  version: 3.5.0\n  updated: 2026-03-16\n  author: dorukardahan\n---\n\n# TwitterAPI.io skill v3.5.0\n\nAccess Twitter\u002FX data and perform actions via [TwitterAPI.io](https:\u002F\u002Ftwitterapi.io) REST API.\nUse TwitterAPI.io REST API for read, write, webhook, and stream operations.\n\nDocs: https:\u002F\u002Fdocs.twitterapi.io | Dashboard: https:\u002F\u002Ftwitterapi.io\u002Fdashboard\n\n---\n\n## Setup\n\n1. Get API key: https:\u002F\u002Ftwitterapi.io\u002Fdashboard ($0.10 free credits, no CC)\n2. 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).\n3. For write actions, you also need `login_cookies` from v2 login + residential `proxy`.\n\nBase URL: `https:\u002F\u002Fapi.twitterapi.io`\nAuth header: `X-API-Key: $TWITTERAPI_IO_KEY` (all requests)\n\n---\n\n## Pricing (credit-based, 1 USD = 100,000 credits)\n\n| Resource | Credits | Approx $\u002F1K |\n|----------|---------|-------------|\n| Tweets (per returned tweet) | 15 | $0.15 |\n| Profiles (per returned profile) | 18 | $0.18 |\n| Profiles batch 100+ (per profile) | 10 | $0.10 |\n| Followers (per returned follower) | 15 | $0.15 |\n| Verified followers (per follower) | 30 | $0.30 |\n| Minimum per API call | 15 | $0.00015 |\n| List endpoint calls | 150 | $0.0015 |\n| Check follow relationship | 100 | $0.001 |\n| Get article | 100 | $0.001 |\n| Community info | 20 | $0.0002 |\n| Write actions (tweet, like, RT, follow) | 200-300 | $0.002-0.003 |\n| Login | 300 | $0.003 |\n\nNote: If the API returns 0 or 1 item, you are still charged the minimum (15 credits).\n\n---\n\n## QPS (rate limits) -- balance-based\n\n| Account Balance (Credits) | QPS Limit |\n|---------------------------|-----------|\n| \u003C 1,000 (free tier) | 1 req \u002F 5 sec |\n| >= 1,000 | 3 |\n| >= 5,000 | 6 |\n| >= 10,000 | 10 |\n| >= 50,000 | 20 |\n\n---\n\n## API Version Note\n\nAll V1 endpoints have been removed from the API. Use only V2 endpoints (`_v2` suffix) for write operations.\nV2 requires `login_cookies` (from `user_login_v2`) + residential `proxy`.\n\n### login_cookie vs login_cookies -- API Inconsistency\n\nThe API has an inconsistency in naming:\n- `user_login_v2` **response** returns the field as `login_cookie` (singular)\n- All v2 **action** endpoints expect the field as `login_cookies` (plural)\n\n**Always use `login_cookies` (plural) in request bodies.** The value is the same string.\n\n---\n\n## Response schemas\n\n### Tweet object (from search, replies, etc.)\n```json\n{\n  \"type\": \"tweet\",\n  \"id\": \"1234567890\",\n  \"url\": \"https:\u002F\u002Fx.com\u002Fuser\u002Fstatus\u002F1234567890\",\n  \"text\": \"Tweet content...\",\n  \"source\": \"Twitter Web App\",\n  \"retweetCount\": 5,\n  \"replyCount\": 2,\n  \"likeCount\": 42,\n  \"quoteCount\": 1,\n  \"viewCount\": 1500,\n  \"bookmarkCount\": 3,\n  \"createdAt\": \"Sun Feb 08 12:00:00 +0000 2026\",\n  \"lang\": \"en\",\n  \"isReply\": false,\n  \"inReplyToId\": null,\n  \"inReplyToUserId\": null,\n  \"inReplyToUsername\": null,\n  \"conversationId\": \"1234567890\",\n  \"displayTextRange\": [0, 280],\n  \"isLimitedReply\": false,\n  \"author\": { \"...User Object...\" },\n  \"entities\": {\n    \"hashtags\": [{ \"text\": \"AI\", \"indices\": [10, 13] }],\n    \"urls\": [{ \"display_url\": \"example.com\", \"expanded_url\": \"https:\u002F\u002Fexample.com\", \"url\": \"https:\u002F\u002Ft.co\u002Fxxx\" }],\n    \"user_mentions\": [{ \"id_str\": \"123\", \"name\": \"Someone\", \"screen_name\": \"someone\" }]\n  },\n  \"quoted_tweet\": null,\n  \"retweeted_tweet\": null\n}\n```\n\n### User object\n```json\n{\n  \"type\": \"user\",\n  \"id\": \"999888777\",\n  \"userName\": \"elonmusk\",\n  \"name\": \"Elon Musk\",\n  \"url\": \"https:\u002F\u002Fx.com\u002Felonmusk\",\n  \"isBlueVerified\": true,\n  \"verifiedType\": \"none\",\n  \"profilePicture\": \"https:\u002F\u002Fpbs.twimg.com\u002F...\",\n  \"coverPicture\": \"https:\u002F\u002Fpbs.twimg.com\u002F...\",\n  \"description\": \"Bio text...\",\n  \"location\": \"Mars\",\n  \"followers\": 200000000,\n  \"following\": 800,\n  \"canDm\": false,\n  \"favouritesCount\": 50000,\n  \"mediaCount\": 2000,\n  \"statusesCount\": 30000,\n  \"createdAt\": \"Tue Jun 02 20:12:29 +0000 2009\",\n  \"pinnedTweetIds\": [\"1234567890\"],\n  \"isAutomated\": false,\n  \"possiblySensitive\": false,\n  \"profile_bio\": {\n    \"description\": \"Bio text...\",\n    \"entities\": {\n      \"description\": { \"urls\": [] },\n      \"url\": { \"urls\": [{ \"display_url\": \"example.com\", \"expanded_url\": \"https:\u002F\u002Fexample.com\" }] }\n    }\n  }\n}\n```\n\n### Paginated list response\n```json\n{\n  \"tweets\": [ \"...array of Tweet Objects...\" ],\n  \"has_next_page\": true,\n  \"next_cursor\": \"cursor_string...\",\n  \"status\": \"success\",\n  \"msg\": null\n}\n```\n\n---\n\n## Endpoint reference\n\nFor detailed endpoint documentation with curl examples, consult the reference files:\n\n- For READ endpoint documentation (33 endpoints), consult `references\u002Fread-endpoints.md`\n- For WRITE V2 endpoint documentation (19 endpoints), consult `references\u002Fwrite-endpoints.md`\n- For Webhook and Stream endpoint documentation (6 endpoints), consult `references\u002Fwebhook-stream-endpoints.md`\n- For the complete endpoint index table (all 58 endpoints), consult `references\u002Fendpoint-index.md`\n\n---\n\n## X\u002FTwitter platform degradation notice (March 2026)\n\n**CRITICAL**: Around March 5, 2026, Twitter\u002FX disabled or degraded several advanced search features due to high platform usage. This affects ALL Twitter API providers (not just TwitterAPI.io) because TwitterAPI.io proxies Twitter's own search infrastructure.\n\n### What's broken\n\n| Feature | Status | Impact |\n|---------|--------|--------|\n| `since:DATE` \u002F `until:DATE` in search | **DEGRADED** | Returns incomplete results (often only 7-20 tweets per query regardless of actual volume) |\n| Search pagination | **BROKEN** | Cursor-based pagination returns the SAME page of results repeatedly instead of advancing |\n| `since_time:UNIX` \u002F `until_time:UNIX` | **WORKS** | Alternative date format using Unix timestamps -- returns correct date range |\n| `within_time:Nh` | **WORKS** | Relative time filter (e.g., `within_time:72h`) |\n| `get_user_last_tweets` pagination | **WORKS** | User timeline cursor pagination is unaffected |\n| `get_user_mentions` sinceTime\u002FuntilTime | **WORKS** | Server-side Unix timestamp parameters (not search operators) |\n| Webhook filter rules | **WORKS** | Real-time collection unaffected (but webhook URL may be lost during API key rotation) |\n\n### Workarounds for date-range queries\n\n**Instead of** (broken):\n```\n$BTC since:2026-03-06_00:00:00_UTC until:2026-03-07_00:00:00_UTC\n```\n\n**Use** (working):\n```\n$BTC since_time:1741219200 until_time:1741305600\n```\n\nConvert dates to Unix timestamps: `date -d \"2026-03-06T00:00:00Z\" +%s` or use Python: `int(datetime(2026,3,6,tzinfo=timezone.utc).timestamp())`\n\n**Pagination workaround**: Since pagination is broken, use **hourly time windows** instead of paginating through a large result set. Each 1-hour window returns a unique set of ~7-16 tweets (page 1 only). This gives ~250 unique tweets per coin per day across 24 windows.\n\n**For user timelines**: Use `GET \u002Ftwitter\u002Fuser\u002Flast_tweets` with cursor pagination (works normally). Paginate backwards through the user's timeline, then client-side filter by `createdAt` date. This completely bypasses search operators.\n\n### Webhook URL gotcha\n\nWhen a TwitterAPI.io API key is rotated (e.g., after account data reset), the webhook filter rules may be restored but the **webhook URL is NOT automatically restored**. You must manually re-set the webhook URL in the dashboard at https:\u002F\u002Ftwitterapi.io\u002Ftweet-filter-rules after any key rotation event.\n\n**Monitoring tip**: Check that `collection_type='webhook'` tweets are still arriving. If rules are active but zero webhook tweets arrive for 30+ minutes, verify the webhook URL is configured.\n\n---\n\n## Twitter search syntax (for `query` param in advanced_search)\n\n| Operator | Example | Description | Status (Mar 2026) |\n|----------|---------|-------------|-------------------|\n| `from:` | `from:elonmusk` | Tweets by user | Working |\n| `to:` | `to:elonmusk` | Replies to user | Working |\n| `\"...\"` | `\"exact phrase\"` | Exact match | Working |\n| `OR` | `cat OR dog` | Either term | Working |\n| `-` | `-spam` | Exclude term | Working |\n| `since:` \u002F `until:` | `since:2026-01-01_00:00:00_UTC` | Date range (UTC) | **DEGRADED** -- use `since_time:` instead |\n| `since_time:` \u002F `until_time:` | `since_time:1741219200` | Date range (Unix timestamp) | **Working** |\n| `within_time:` | `within_time:24h` | Relative time window | **Working** |\n| `min_faves:` | `min_faves:100` | Min likes | Working |\n| `min_retweets:` | `min_retweets:50` | Min RTs | Working |\n| `filter:media` | `filter:media` | Has media | Working |\n| `filter:links` | `filter:links` | Has links | Working |\n| `lang:` | `lang:en` | Language | Working |\n| `is:reply` | `is:reply` | Only replies | Working |\n| `-is:retweet` | `-is:retweet` | Exclude RTs | Working |\n\nMore examples: https:\u002F\u002Fgithub.com\u002Figorbrigadir\u002Ftwitter-advanced-search\n\n---\n\n## Pagination\n\nMost list endpoints return:\n```json\n{ \"has_next_page\": true, \"next_cursor\": \"cursor_string...\" }\n```\nPass `cursor=NEXT_CURSOR` to get next page. First page: omit cursor or `cursor=\"\"`.\n\n**Known issues (March 2026)**:\n- `advanced_search` pagination is **broken** -- returns the same results on every page. Use hourly time windows (1 page per window) instead of deep pagination.\n- `get_user_last_tweets` pagination **works normally** -- cursor advances through the user's timeline chronologically.\n- `has_next_page` may return `true` even when no more data exists (Twitter API limitation). If a subsequent request returns empty or identical results, stop paginating.\n\n---\n\n## Error handling\n\n```json\n{ \"status\": \"error\", \"msg\": \"Error message\" }\n```\n\n| Error | Cause | Fix |\n|-------|-------|-----|\n| Invalid API key | Wrong or missing `X-API-Key` header | Check key in dashboard |\n| Invalid login_cookie | Expired or faulty cookie | Re-login via `user_login_v2` with valid `totp_secret` |\n| 400 on v2 actions | Faulty cookie from login without proper `totp_secret` | Re-login with 16-char string `totp_secret` |\n| Proxy error | Bad proxy format or dead proxy | Format: `http:\u002F\u002Fuser:pass@host:port`, use residential |\n| Rate limited | Exceeded QPS for your balance tier | Back off, add balance for higher QPS |\n| Account suspended | Twitter account banned | Use different account |\n| 404 on endpoint | Wrong path | Check correct path in this doc |\n\n---\n\n## Common workflows\n\n### Get user ID from username (needed for follow, DM)\n1. `GET \u002Ftwitter\u002Fuser\u002Finfo?userName=TARGET` -> extract `data.id`\n2. Use that numeric ID in follow\u002FDM calls\nNote: `get_user_mentions` accepts `userName` directly -- no ID lookup needed.\n\n### Post tweet with image\n1. Upload: `POST \u002Ftwitter\u002Fupload_media_v2` -> get `media_id`\n2. Tweet: `POST \u002Ftwitter\u002Fcreate_tweet_v2` with `media_ids: [\"media_id\"]`\n\n### Reply to a tweet\n`POST \u002Ftwitter\u002Fcreate_tweet_v2` with `tweet_text` + `reply_to_tweet_id`\n\n### Quote tweet\n`POST \u002Ftwitter\u002Fcreate_tweet_v2` with `tweet_text` + `attachment_url` (full tweet URL)\n\n### Post to community\n`POST \u002Ftwitter\u002Fcreate_tweet_v2` with `tweet_text` + `community_id`\n\n### Monitor accounts for new tweets (cheapest method)\nUse Stream endpoints instead of polling `\u002Ftwitter\u002Fuser\u002Flast_tweets`:\n1. `POST \u002Foapi\u002Fx_user_stream\u002Fadd_user_to_monitor_tweet` for each account\n2. Set up webhook to receive notifications\n\n---\n\n## MCP server\n\n```bash\nclaude mcp add twitterapi-io -- npx -y twitterapi-io-mcp\n```\nnpm: https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Ftwitterapi-io-mcp\nGitHub: https:\u002F\u002Fgithub.com\u002Fdorukardahan\u002Ftwitterapi-io-mcp\n\nAlso available: `twitterapi-docs` MCP server for querying this documentation programmatically.\n\n---\n\n## Important notes\n\n- **Read endpoints** need only API key. No Twitter account needed.\n- **Write endpoints** need `login_cookies` from v2 login + residential proxy.\n- **V2 cookies only work with v2 endpoints** (`_v2` suffix).\n- **2FA strongly recommended** -- use 16-character string `totp_secret` for reliable login.\n- **Proxy mandatory** for all write actions. Use high-quality residential proxies.\n- **Credits never expire** once recharged. Bonus credits valid 30 days.\n","# TwitterAPI.io skill v3.5.0\n\nAccess Twitter\u002FX data and perform actions via [TwitterAPI.io](https:\u002F\u002Ftwitterapi.io) REST API.\nUse TwitterAPI.io REST API for read, write, webhook, and stream operations.\n\nDocs: https:\u002F\u002Fdocs.twitterapi.io | Dashboard: https:\u002F\u002Ftwitterapi.io\u002Fdashboard\n\n---\n\n## Setup\n\n1. Get API key: https:\u002F\u002Ftwitterapi.io\u002Fdashboard ($0.10 free credits, no CC)\n2. 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).\n3. For write actions, you also need `login_cookies` from v2 login + residential `proxy`.\n\nBase URL: `https:\u002F\u002Fapi.twitterapi.io`\nAuth header: `X-API-Key: $TWITTERAPI_IO_KEY` (all requests)\n\n---\n\n## Pricing (credit-based, 1 USD = 100,000 credits)\n\n| Resource | Credits | Approx $\u002F1K |\n|----------|---------|-------------|\n| Tweets (per returned tweet) | 15 | $0.15 |\n| Profiles (per returned profile) | 18 | $0.18 |\n| Profiles batch 100+ (per profile) | 10 | $0.10 |\n| Followers (per returned follower) | 15 | $0.15 |\n| Verified followers (per follower) | 30 | $0.30 |\n| Minimum per API call | 15 | $0.00015 |\n| List endpoint calls | 150 | $0.0015 |\n| Check follow relationship | 100 | $0.001 |\n| Get article | 100 | $0.001 |\n| Community info | 20 | $0.0002 |\n| Write actions (tweet, like, RT, follow) | 200-300 | $0.002-0.003 |\n| Login | 300 | $0.003 |\n\nNote: If the API returns 0 or 1 item, you are still charged the minimum (15 credits).\n\n---\n\n## QPS (rate limits) -- balance-based\n\n| Account Balance (Credits) | QPS Limit |\n|---------------------------|-----------|\n| \u003C 1,000 (free tier) | 1 req \u002F 5 sec |\n| >= 1,000 | 3 |\n| >= 5,000 | 6 |\n| >= 10,000 | 10 |\n| >= 50,000 | 20 |\n\n---\n\n## API Version Note\n\nAll V1 endpoints have been removed from the API. Use only V2 endpoints (`_v2` suffix) for write operations.\nV2 requires `login_cookies` (from `user_login_v2`) + residential `proxy`.\n\n### login_cookie vs login_cookies -- API Inconsistency\n\nThe API has an inconsistency in naming:\n- `user_login_v2` **response** returns the field as `login_cookie` (singular)\n- All v2 **action** endpoints expect the field as `login_cookies` (plural)\n\n**Always use `login_cookies` (plural) in request bodies.** The value is the same string.\n\n---\n\n## Response schemas\n\n### Tweet object (from search, replies, etc.)\n```json\n{\n  \"type\": \"tweet\",\n  \"id\": \"1234567890\",\n  \"url\": \"https:\u002F\u002Fx.com\u002Fuser\u002Fstatus\u002F1234567890\",\n  \"text\": \"Tweet content...\",\n  \"source\": \"Twitter Web App\",\n  \"retweetCount\": 5,\n  \"replyCount\": 2,\n  \"likeCount\": 42,\n  \"quoteCount\": 1,\n  \"viewCount\": 1500,\n  \"bookmarkCount\": 3,\n  \"createdAt\": \"Sun Feb 08 12:00:00 +0000 2026\",\n  \"lang\": \"en\",\n  \"isReply\": false,\n  \"inReplyToId\": null,\n  \"inReplyToUserId\": null,\n  \"inReplyToUsername\": null,\n  \"conversationId\": \"1234567890\",\n  \"displayTextRange\": [0, 280],\n  \"isLimitedReply\": false,\n  \"author\": { \"...User Object...\" },\n  \"entities\": {\n    \"hashtags\": [{ \"text\": \"AI\", \"indices\": [10, 13] }],\n    \"urls\": [{ \"display_url\": \"example.com\", \"expanded_url\": \"https:\u002F\u002Fexample.com\", \"url\": \"https:\u002F\u002Ft.co\u002Fxxx\" }],\n    \"user_mentions\": [{ \"id_str\": \"123\", \"name\": \"Someone\", \"screen_name\": \"someone\" }]\n  },\n  \"quoted_tweet\": null,\n  \"retweeted_tweet\": null\n}\n```\n\n### User object\n```json\n{\n  \"type\": \"user\",\n  \"id\": \"999888777\",\n  \"userName\": \"elonmusk\",\n  \"name\": \"Elon Musk\",\n  \"url\": \"https:\u002F\u002Fx.com\u002Felonmusk\",\n  \"isBlueVerified\": true,\n  \"verifiedType\": \"none\",\n  \"profilePicture\": \"https:\u002F\u002Fpbs.twimg.com\u002F...\",\n  \"coverPicture\": \"https:\u002F\u002Fpbs.twimg.com\u002F...\",\n  \"description\": \"Bio text...\",\n  \"location\": \"Mars\",\n  \"followers\": 200000000,\n  \"following\": 800,\n  \"canDm\": false,\n  \"favouritesCount\": 50000,\n  \"mediaCount\": 2000,\n  \"statusesCount\": 30000,\n  \"createdAt\": \"Tue Jun 02 20:12:29 +0000 2009\",\n  \"pinnedTweetIds\": [\"1234567890\"],\n  \"isAutomated\": false,\n  \"possiblySensitive\": false,\n  \"profile_bio\": {\n    \"description\": \"Bio text...\",\n    \"entities\": {\n      \"description\": { \"urls\": [] },\n      \"url\": { \"urls\": [{ \"display_url\": \"example.com\", \"expanded_url\": \"https:\u002F\u002Fexample.com\" }] }\n    }\n  }\n}\n```\n\n### Paginated list response\n```json\n{\n  \"tweets\": [ \"...array of Tweet Objects...\" ],\n  \"has_next_page\": true,\n  \"next_cursor\": \"cursor_string...\",\n  \"status\": \"success\",\n  \"msg\": null\n}\n```\n\n---\n\n## Endpoint reference\n\nFor detailed endpoint documentation with curl examples, consult the reference files:\n\n- For READ endpoint documentation (33 endpoints), consult `references\u002Fread-endpoints.md`\n- For WRITE V2 endpoint documentation (19 endpoints), consult `references\u002Fwrite-endpoints.md`\n- For Webhook and Stream endpoint documentation (6 endpoints), consult `references\u002Fwebhook-stream-endpoints.md`\n- For the complete endpoint index table (all 58 endpoints), consult `references\u002Fendpoint-index.md`\n\n---\n\n## X\u002FTwitter platform degradation notice (March 2026)\n\n**CRITICAL**: Around March 5, 2026, Twitter\u002FX disabled or degraded several advanced search features due to high platform usage. This affects ALL Twitter API providers (not just TwitterAPI.io) because TwitterAPI.io proxies Twitter's own search infrastructure.\n\n### What's broken\n\n| Feature | Status | Impact |\n|---------|--------|--------|\n| `since:DATE` \u002F `until:DATE` in search | **DEGRADED** | Returns incomplete results (often only 7-20 tweets per query regardless of actual volume) |\n| Search pagination | **BROKEN** | Cursor-based pagination returns the SAME page of results repeatedly instead of advancing |\n| `since_time:UNIX` \u002F `until_time:UNIX` | **WORKS** | Alternative date format using Unix timestamps -- returns correct date range |\n| `within_time:Nh` | **WORKS** | Relative time filter (e.g., `within_time:72h`) |\n| `get_user_last_tweets` pagination | **WORKS** | User timeline cursor pagination is unaffected |\n| `get_user_mentions` sinceTime\u002FuntilTime | **WORKS** | Server-side Unix timestamp parameters (not search operators) |\n| Webhook filter rules | **WORKS** | Real-time collection unaffected (but webhook URL may be lost during API key rotation) |\n\n### Workarounds for date-range queries\n\n**Instead of** (broken):\n```\n$BTC since:2026-03-06_00:00:00_UTC until:2026-03-07_00:00:00_UTC\n```\n\n**Use** (working):\n```\n$BTC since_time:1741219200 until_time:1741305600\n```\n\nConvert dates to Unix timestamps: `date -d \"2026-03-06T00:00:00Z\" +%s` or use Python: `int(datetime(2026,3,6,tzinfo=timezone.utc).timestamp())`\n\n**Pagination workaround**: Since pagination is broken, use **hourly time windows** instead of paginating through a large result set. Each 1-hour window returns a unique set of ~7-16 tweets (page 1 only). This gives ~250 unique tweets per coin per day across 24 windows.\n\n**For user timelines**: Use `GET \u002Ftwitter\u002Fuser\u002Flast_tweets` with cursor pagination (works normally). Paginate backwards through the user's timeline, then client-side filter by `createdAt` date. This completely bypasses search operators.\n\n### Webhook URL gotcha\n\nWhen a TwitterAPI.io API key is rotated (e.g., after account data reset), the webhook filter rules may be restored but the **webhook URL is NOT automatically restored**. You must manually re-set the webhook URL in the dashboard at https:\u002F\u002Ftwitterapi.io\u002Ftweet-filter-rules after any key rotation event.\n\n**Monitoring tip**: Check that `collection_type='webhook'` tweets are still arriving. If rules are active but zero webhook tweets arrive for 30+ minutes, verify the webhook URL is configured.\n\n---\n\n## Twitter search syntax (for `query` param in advanced_search)\n\n| Operator | Example | Description | Status (Mar 2026) |\n|----------|---------|-------------|-------------------|\n| `from:` | `from:elonmusk` | Tweets by user | Working |\n| `to:` | `to:elonmusk` | Replies to user | Working |\n| `\"...\"` | `\"exact phrase\"` | Exact match | Working |\n| `OR` | `cat OR dog` | Either term | Working |\n| `-` | `-spam` | Exclude term | Working |\n| `since:` \u002F `until:` | `since:2026-01-01_00:00:00_UTC` | Date range (UTC) | **DEGRADED** -- use `since_time:` instead |\n| `since_time:` \u002F `until_time:` | `since_time:1741219200` | Date range (Unix timestamp) | **Working** |\n| `within_time:` | `within_time:24h` | Relative time window | **Working** |\n| `min_faves:` | `min_faves:100` | Min likes | Working |\n| `min_retweets:` | `min_retweets:50` | Min RTs | Working |\n| `filter:media` | `filter:media` | Has media | Working |\n| `filter:links` | `filter:links` | Has links | Working |\n| `lang:` | `lang:en` | Language | Working |\n| `is:reply` | `is:reply` | Only replies | Working |\n| `-is:retweet` | `-is:retweet` | Exclude RTs | Working |\n\nMore examples: https:\u002F\u002Fgithub.com\u002Figorbrigadir\u002Ftwitter-advanced-search\n\n---\n\n## Pagination\n\nMost list endpoints return:\n```json\n{ \"has_next_page\": true, \"next_cursor\": \"cursor_string...\" }\n```\nPass `cursor=NEXT_CURSOR` to get next page. First page: omit cursor or `cursor=\"\"`.\n\n**Known issues (March 2026)**:\n- `advanced_search` pagination is **broken** -- returns the same results on every page. Use hourly time windows (1 page per window) instead of deep pagination.\n- `get_user_last_tweets` pagination **works normally** -- cursor advances through the user's timeline chronologically.\n- `has_next_page` may return `true` even when no more data exists (Twitter API limitation). If a subsequent request returns empty or identical results, stop paginating.\n\n---\n\n## Error handling\n\n```json\n{ \"status\": \"error\", \"msg\": \"Error message\" }\n```\n\n| Error | Cause | Fix |\n|-------|-------|-----|\n| Invalid API key | Wrong or missing `X-API-Key` header | Check key in dashboard |\n| Invalid login_cookie | Expired or faulty cookie | Re-login via `user_login_v2` with valid `totp_secret` |\n| 400 on v2 actions | Faulty cookie from login without proper `totp_secret` | Re-login with 16-char string `totp_secret` |\n| Proxy error | Bad proxy format or dead proxy | Format: `http:\u002F\u002Fuser:pass@host:port`, use residential |\n| Rate limited | Exceeded QPS for your balance tier | Back off, add balance for higher QPS |\n| Account suspended | Twitter account banned | Use different account |\n| 404 on endpoint | Wrong path | Check correct path in this doc |\n\n---\n\n## Common workflows\n\n### Get user ID from username (needed for follow, DM)\n1. `GET \u002Ftwitter\u002Fuser\u002Finfo?userName=TARGET` -> extract `data.id`\n2. Use that numeric ID in follow\u002FDM calls\nNote: `get_user_mentions` accepts `userName` directly -- no ID lookup needed.\n\n### Post tweet with image\n1. Upload: `POST \u002Ftwitter\u002Fupload_media_v2` -> get `media_id`\n2. Tweet: `POST \u002Ftwitter\u002Fcreate_tweet_v2` with `media_ids: [\"media_id\"]`\n\n### Reply to a tweet\n`POST \u002Ftwitter\u002Fcreate_tweet_v2` with `tweet_text` + `reply_to_tweet_id`\n\n### Quote tweet\n`POST \u002Ftwitter\u002Fcreate_tweet_v2` with `tweet_text` + `attachment_url` (full tweet URL)\n\n### Post to community\n`POST \u002Ftwitter\u002Fcreate_tweet_v2` with `tweet_text` + `community_id`\n\n### Monitor accounts for new tweets (cheapest method)\nUse Stream endpoints instead of polling `\u002Ftwitter\u002Fuser\u002Flast_tweets`:\n1. `POST \u002Foapi\u002Fx_user_stream\u002Fadd_user_to_monitor_tweet` for each account\n2. Set up webhook to receive notifications\n\n---\n\n## MCP server\n\n```bash\nclaude mcp add twitterapi-io -- npx -y twitterapi-io-mcp\n```\nnpm: https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002Ftwitterapi-io-mcp\nGitHub: https:\u002F\u002Fgithub.com\u002Fdorukardahan\u002Ftwitterapi-io-mcp\n\nAlso available: `twitterapi-docs` MCP server for querying this documentation programmatically.\n\n---\n\n## Important notes\n\n- **Read endpoints** need only API key. No Twitter account needed.\n- **Write endpoints** need `login_cookies` from v2 login + residential proxy.\n- **V2 cookies only work with v2 endpoints** (`_v2` suffix).\n- **2FA strongly recommended** -- use 16-character string `totp_secret` for reliable login.\n- **Proxy mandatory** for all write actions. Use high-quality residential proxies.\n- **Credits never expire** once recharged. Bonus credits valid 30 days.\n",{"name":5,"metadata":24,"description":7},{"author":25,"updated":26,"version":27},"dorukardahan",1773619200000,"3.5.0","main","f9d3fe7cf9ac8f1ea63a0d96e98e1f510a3814db","skills\u002Fdorukardahan\u002Ftwitterapi-io",1,"https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills","https:\u002F\u002Fgithub.com\u002Fjavimosch","intrane.fr","Building robust, open-source infrastructure for the commons. AI-leveraged, self-hosted, built to last.","2026-06-07 03:34:58",{"source":8,"skillName":5,"commands":38,"prompt":48,"zipAvailable":49},[39,42,45],{"tool":40,"command":41},"npx","npx skills add javimosch\u002Fopen-claw-skills --skill twitterapi-io",{"tool":43,"command":44},"bunx","bunx skills add javimosch\u002Fopen-claw-skills --skill twitterapi-io",{"tool":46,"command":47},"pnpm","pnpm dlx skills add javimosch\u002Fopen-claw-skills --skill twitterapi-io","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fdorukardahan\u002Ftwitterapi-io\u002FSKILL.md",true,[],[52,60,67,74,81,88],{"skillNo":53,"name":54,"nameZh":6,"description":55,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":56,"categories":57,"keywords":58,"publishedAt":59},"01M778GGXG2VQ0YF31W2MKGMQZ","crowd-prompting","A marketplace where AI agents improve prompts, system instructions, tool descriptions, and other text-based content with domain expertise from real-world operations — and earn tokens for valuable contributions.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzzadrian\u002Fcrowd-prompting\u002FSKILL.md",[],[],"2026-11-15 14:19:17",{"skillNo":61,"name":62,"nameZh":6,"description":63,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":64,"categories":65,"keywords":66,"publishedAt":59},"01M778G7BH8SBJ9FJ6C3G7CB1K","ceaser","Interact with the Ceaser privacy protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- shield, unshield, note management, and protocol queries. All ceaser tool calls use CLI subcommands (npx -y ceaser-mcp \u003Csubcommand>). Ceaser is a privacy-preserving ETH wrapper using Noir\u002FUltraHonk zero-knowledge proofs on Base L2 (chain ID 8453).","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyra-v21\u002Fceaser\u002FSKILL.md",[],[],{"skillNo":68,"name":69,"nameZh":6,"description":70,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":71,"categories":72,"keywords":73,"publishedAt":59},"01M778FYCJQZWFKKX5FYMK3S47","ceaser-send","Fully automated private ETH transfer via Ceaser Protocol on Base L2 using the ceaser-mcp MCP tools. This skill uses the ceaser-mcp npm package for ALL operations -- all ceaser tool calls use CLI subcommands (npx -y ceaser-mcp \u003Csubcommand>). WARNING -- creates observable on-chain links between user wallet and hot wallet (see Privacy Warning). Generates an ephemeral hot wallet with BIP-39 mnemonic recovery, user funds it, agent signs and broadcasts the Shield TX automatically. Exactly one manual step required (funding the hot wallet with ETH). Uses Noir\u002FUltraHonk zero-knowledge proofs.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyra-v21\u002Fceaser-send\u002FSKILL.md",[],[],{"skillNo":75,"name":76,"nameZh":6,"description":77,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":78,"categories":79,"keywords":80,"publishedAt":59},"01M778FQQNSEYA3HJKZBPQ4M9Z","dilemm-ai","Compete in DilemmAI, the prisoner's dilemma AI arena at dilemm.ai. Use when an OpenClaw agent wants to create an account, design and submit strategy prompts for their bot, enter matchmaking, analyze historical matches and leaderboards, and iterate on bot strategy. Requires headless browser automation (no API available yet).","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyori\u002Fdilemm-ai\u002FSKILL.md",[],[],{"skillNo":82,"name":83,"nameZh":6,"description":84,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":85,"categories":86,"keywords":87,"publishedAt":59},"01M778FGVZX7QA2TF9BFMM37FY","moldium","Post and manage content on the Moldium blog platform. Triggered by \"post to Moldium\", \"write a blog post\", \"publish an article\", etc.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzyom45\u002Fmoldium\u002FSKILL.md",[],[],{"skillNo":89,"name":90,"nameZh":6,"description":91,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":12,"repositoryNo":13,"starsCount":14,"licenseSpdxId":15,"licenseFileUrl":6,"sourceHtmlUrl":92,"categories":93,"keywords":94,"publishedAt":59},"01M778F88D8PQ9MQ0KNW2TJ8ZH","arxiv-paper-reviews","Interact with arXiv Crawler API to fetch papers, read reviews, submit comments, search papers, and import papers. Use when working with arXiv papers, fetching paper lists by date\u002Fcategory\u002Finterest, viewing paper details with comments, submitting paper reviews, searching papers by title, or importing papers from arXiv URLs via API at http:\u002F\u002Fweakaccept.top:8000\u002F.","https:\u002F\u002Fgithub.com\u002Fjavimosch\u002Fopen-claw-skills\u002Fblob\u002Fmain\u002Fskills\u002Fzxrys\u002Farxiv-paper-reviews\u002FSKILL.md",[],[]]