x-developer 2.6.5 → 2.6.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (130) hide show
  1. package/.claude-plugin/marketplace.json +4 -4
  2. package/.claude-plugin/plugin.json +3 -3
  3. package/.codex-plugin/plugin.json +5 -5
  4. package/CHANGELOG.md +19 -3
  5. package/README.md +111 -70
  6. package/commands/post.md +5 -5
  7. package/commands/search.md +5 -8
  8. package/commands/trending.md +3 -5
  9. package/commands/user.md +4 -10
  10. package/context7.json +9 -9
  11. package/openclaw.plugin.json +4 -4
  12. package/package.json +10 -2
  13. package/scripts/check-versions.mjs +1 -1
  14. package/scripts/release-guard/content-policy.mjs +17 -17
  15. package/scripts/release-guard/policy.mjs +2 -2
  16. package/server.json +1 -1
  17. package/skills/x-twitter-scraper/SKILL.md +96 -90
  18. package/skills/x-twitter-scraper/metadata.json +2 -2
  19. package/skills/x-twitter-scraper/references/api-endpoints-api-keys.md +5 -5
  20. package/skills/x-twitter-scraper/references/api-endpoints-compose.md +16 -16
  21. package/skills/x-twitter-scraper/references/api-endpoints-credits.md +3 -3
  22. package/skills/x-twitter-scraper/references/api-endpoints-drafts.md +21 -21
  23. package/skills/x-twitter-scraper/references/api-endpoints-draws.md +15 -15
  24. package/skills/x-twitter-scraper/references/api-endpoints-error-codes.md +4 -4
  25. package/skills/x-twitter-scraper/references/api-endpoints-events.md +8 -8
  26. package/skills/x-twitter-scraper/references/api-endpoints-extractions.md +24 -23
  27. package/skills/x-twitter-scraper/references/api-endpoints-monitors.md +21 -21
  28. package/skills/x-twitter-scraper/references/api-endpoints-radar.md +13 -13
  29. package/skills/x-twitter-scraper/references/api-endpoints-support.md +6 -6
  30. package/skills/x-twitter-scraper/references/api-endpoints-trends.md +20 -5
  31. package/skills/x-twitter-scraper/references/api-endpoints-tweet-style-cache.md +39 -39
  32. package/skills/x-twitter-scraper/references/api-endpoints-webhooks.md +24 -24
  33. package/skills/x-twitter-scraper/references/api-endpoints-x-accounts.md +13 -13
  34. package/skills/x-twitter-scraper/references/api-endpoints-x-api.md +41 -41
  35. package/skills/x-twitter-scraper/references/api-endpoints-x-media.md +9 -9
  36. package/skills/x-twitter-scraper/references/api-endpoints-x-write.md +73 -73
  37. package/skills/x-twitter-scraper/references/api-endpoints.md +11 -11
  38. package/skills/x-twitter-scraper/references/automate-twitter-giveaways.md +13 -13
  39. package/skills/x-twitter-scraper/references/best-x-api-alternative.md +38 -38
  40. package/skills/x-twitter-scraper/references/compare-twitter-apis.md +23 -24
  41. package/skills/x-twitter-scraper/references/draws.md +14 -14
  42. package/skills/x-twitter-scraper/references/export-twitter-followers.md +12 -12
  43. package/skills/x-twitter-scraper/references/extract-x-community-data.md +10 -10
  44. package/skills/x-twitter-scraper/references/extractions.md +54 -48
  45. package/skills/x-twitter-scraper/references/mcp-setup.md +30 -36
  46. package/skills/x-twitter-scraper/references/mcp-tools.md +59 -69
  47. package/skills/x-twitter-scraper/references/monitor-twitter-webhooks.md +17 -18
  48. package/skills/x-twitter-scraper/references/python-examples.md +18 -26
  49. package/skills/x-twitter-scraper/references/reliable-twitter-data-api-2026.md +58 -60
  50. package/skills/x-twitter-scraper/references/scrape-export-twitter-data.md +25 -27
  51. package/skills/x-twitter-scraper/references/security.md +9 -22
  52. package/skills/x-twitter-scraper/references/track-twitter-keywords-mentions.md +18 -18
  53. package/skills/x-twitter-scraper/references/twitter-api-alternative-faq.md +17 -17
  54. package/skills/x-twitter-scraper/references/twitter-api-without-x-account.md +10 -11
  55. package/skills/x-twitter-scraper/references/twitter-data-pipeline.md +23 -23
  56. package/skills/x-twitter-scraper/references/twitter-scraper-api-guide.md +50 -50
  57. package/skills/x-twitter-scraper/references/types-account-identity.md +1 -1
  58. package/skills/x-twitter-scraper/references/types-account.md +1 -1
  59. package/skills/x-twitter-scraper/references/types-api-keys.md +1 -1
  60. package/skills/x-twitter-scraper/references/types-bookmarks-and-timeline.md +1 -1
  61. package/skills/x-twitter-scraper/references/types-credits.md +1 -1
  62. package/skills/x-twitter-scraper/references/types-download-media.md +4 -4
  63. package/skills/x-twitter-scraper/references/types-draws.md +1 -1
  64. package/skills/x-twitter-scraper/references/types-error.md +1 -1
  65. package/skills/x-twitter-scraper/references/types-events.md +1 -1
  66. package/skills/x-twitter-scraper/references/types-extractions.md +79 -96
  67. package/skills/x-twitter-scraper/references/types-mcp-output-schemas.md +1 -1
  68. package/skills/x-twitter-scraper/references/types-monitors.md +1 -1
  69. package/skills/x-twitter-scraper/references/types-radar.md +1 -1
  70. package/skills/x-twitter-scraper/references/types-request-bodies.md +1 -1
  71. package/skills/x-twitter-scraper/references/types-rest-api-vs-mcp-field-naming.md +1 -1
  72. package/skills/x-twitter-scraper/references/types-support.md +1 -1
  73. package/skills/x-twitter-scraper/references/types-trends.md +1 -1
  74. package/skills/x-twitter-scraper/references/types-tweet-drafts.md +1 -1
  75. package/skills/x-twitter-scraper/references/types-tweet-style-cache.md +1 -1
  76. package/skills/x-twitter-scraper/references/types-user-activity.md +1 -1
  77. package/skills/x-twitter-scraper/references/types-webhooks.md +1 -1
  78. package/skills/x-twitter-scraper/references/types-x-accounts.md +3 -3
  79. package/skills/x-twitter-scraper/references/types-x-api.md +25 -31
  80. package/skills/x-twitter-scraper/references/types-x-articles.md +1 -1
  81. package/skills/x-twitter-scraper/references/types-x-write.md +3 -3
  82. package/skills/x-twitter-scraper/references/types.md +15 -15
  83. package/skills/x-twitter-scraper/references/usage.md +6 -6
  84. package/skills/x-twitter-scraper/references/webhooks.md +27 -37
  85. package/skills/x-twitter-scraper/references/workflows.md +54 -63
  86. package/skills/x-twitter-scraper/skill-card.md +35 -27
  87. package/skills/x-twitter-scraper/skillspector-report.md +2 -2
  88. package/skills/xquik-social-research/SKILL.md +19 -16
  89. package/skills.sh.json +8 -8
  90. package/stub-server.mjs +42 -42
  91. package/task-guides/check-mutuals.md +9 -9
  92. package/task-guides/clean-followers.md +15 -15
  93. package/task-guides/export-tweets-csv.md +12 -12
  94. package/task-guides/extract-followers.md +16 -16
  95. package/task-guides/find-bangers.md +14 -14
  96. package/task-guides/find-influencers.md +10 -10
  97. package/task-guides/find-viral-tweets.md +15 -15
  98. package/task-guides/follow-unfollow.md +16 -15
  99. package/task-guides/for-you-feed.md +10 -10
  100. package/task-guides/going-viral.md +19 -18
  101. package/task-guides/grow-followers.md +13 -13
  102. package/task-guides/monitor-accounts.md +16 -16
  103. package/task-guides/optimize-tweets.md +16 -15
  104. package/task-guides/post-tweets.md +19 -18
  105. package/task-guides/run-giveaway.md +15 -15
  106. package/task-guides/search-tweets.md +13 -13
  107. package/task-guides/send-dms.md +13 -13
  108. package/task-guides/top-replies.md +10 -10
  109. package/task-guides/track-competitors.md +16 -16
  110. package/task-guides/track-hashtags.md +10 -10
  111. package/task-guides/track-mentions.md +12 -12
  112. package/task-guides/trending-news.md +11 -11
  113. package/task-guides/tweet-analytics.md +16 -16
  114. package/task-guides/tweet-ideas.md +10 -10
  115. package/task-guides/tweet-replies.md +15 -15
  116. package/task-guides/tweet-style.md +10 -10
  117. package/task-guides/tweet-webhooks.md +12 -12
  118. package/task-guides/update-x-profile.md +15 -15
  119. package/task-guides/user-tweets.md +21 -21
  120. package/task-guides/who-liked.md +10 -10
  121. package/task-guides/who-quoted.md +10 -10
  122. package/task-guides/who-retweeted.md +10 -10
  123. package/task-guides/write-threads.md +12 -16
  124. package/task-guides/write-tweets.md +15 -15
  125. package/task-guides/x-articles.md +9 -9
  126. package/task-guides/x-bookmarks.md +10 -10
  127. package/task-guides/x-communities.md +10 -10
  128. package/task-guides/x-lists.md +8 -8
  129. package/task-guides/x-spaces.md +9 -9
  130. package/task-guides/x-trends.md +11 -11
@@ -1,8 +1,8 @@
1
- # Xquik Twitter API Alternative: Search, Export, Monitor, and Automate
1
+ # Xquik Twitter API alternative: search, export, monitor, and automate
2
2
 
3
- This hub routes common developer questions to focused, detailed answers. Each
4
- guide includes route decisions, data fields, examples, cost controls, failure
5
- handling, and safety guidance.
3
+ Use this index to find answers about Twitter search, exports, monitoring, and
4
+ API comparisons. Each guide lists routes, fields, examples, cost controls,
5
+ errors, and approval rules.
6
6
 
7
7
  Xquik uses delivered-result billing for supported filtered data workflows.
8
8
  Filtering is not a separate billable step. Excluded rows do not become
@@ -11,9 +11,9 @@ delivered-result charges. Always estimate bulk work before creation.
11
11
  > Xquik is an independent third-party service. Not affiliated with X Corp.
12
12
  > "Twitter" and "X" are trademarks of X Corp.
13
13
 
14
- ## Xquik Twitter Scraper API Workflows
14
+ ## Xquik Twitter scraper API workflows
15
15
 
16
- | Xquik Workflow | Questions | X Data Task | Detailed Guide |
16
+ | Xquik workflow | Questions | X data task | Detailed guide |
17
17
  | --- | ---: | --- | --- |
18
18
  | Twitter search and export | 5 | Advanced search, exports, Python, media | [Twitter scraper API](scrape-export-twitter-data.md) |
19
19
  | X API alternatives | 10 | Xquik, official X API, Apify, cost | [X API alternative comparison](compare-twitter-apis.md) |
@@ -24,9 +24,9 @@ delivered-result charges. Always estimate bulk work before creation.
24
24
  | Public X reads | 5 | Xquik API key and account boundaries | [Twitter API without a developer account](twitter-api-without-x-account.md) |
25
25
  | Twitter giveaways | 5 | Eligibility, winners, backups, audit data | [Twitter giveaway picker API](automate-twitter-giveaways.md) |
26
26
  | Twitter webhooks | 5 | Account monitoring, HMAC, delivery | [Twitter account monitor API](monitor-twitter-webhooks.md) |
27
- | **Total** | **50** | **50 specific developer questions** | **9 focused guides** |
27
+ | Total | 50 | 50 developer questions | 9 guides |
28
28
 
29
- ## Twitter Scraper API Search and Export
29
+ ## Twitter scraper API search and export
30
30
 
31
31
  Read the [scrape and export guide](scrape-export-twitter-data.md) for:
32
32
 
@@ -36,7 +36,7 @@ Read the [scrape and export guide](scrape-export-twitter-data.md) for:
36
36
  - What is a Twitter scraper API?
37
37
  - How do I scrape tweets with Python?
38
38
 
39
- ## X API Alternative Comparison
39
+ ## X API alternative comparison
40
40
 
41
41
  Read the [Twitter API comparison guide](compare-twitter-apis.md) for:
42
42
 
@@ -51,7 +51,7 @@ Read the [Twitter API comparison guide](compare-twitter-apis.md) for:
51
51
  - How does Xquik compare with an Apify Twitter scraper?
52
52
  - How does Xquik compare with Twitter API v2?
53
53
 
54
- ## Twitter Follower Scraper API
54
+ ## Twitter follower scraper API
55
55
 
56
56
  Read the [follower export guide](export-twitter-followers.md) for:
57
57
 
@@ -61,7 +61,7 @@ Read the [follower export guide](export-twitter-followers.md) for:
61
61
  - What does a Twitter followers scraper return?
62
62
  - What API can I use to get someone's Twitter followers?
63
63
 
64
- ## Twitter Monitor API for Keywords and Mentions
64
+ ## Twitter monitor API for keywords and mentions
65
65
 
66
66
  Read the [keyword and mention guide](track-twitter-keywords-mentions.md) for:
67
67
 
@@ -71,7 +71,7 @@ Read the [keyword and mention guide](track-twitter-keywords-mentions.md) for:
71
71
  - What is a Twitter mention tracking tool?
72
72
  - What is a Twitter keyword monitor?
73
73
 
74
- ## X Communities API for Members and Posts
74
+ ## X Communities API for members and posts
75
75
 
76
76
  Read the [X community extraction guide](extract-x-community-data.md) for:
77
77
 
@@ -81,7 +81,7 @@ Read the [X community extraction guide](extract-x-community-data.md) for:
81
81
  - How do I export community tweets?
82
82
  - Does Xquik provide a Twitter community API?
83
83
 
84
- ## Twitter Data Pipeline With REST and Python
84
+ ## Twitter data pipeline with REST and Python
85
85
 
86
86
  Read the [Twitter data pipeline guide](twitter-data-pipeline.md) for:
87
87
 
@@ -91,7 +91,7 @@ Read the [Twitter data pipeline guide](twitter-data-pipeline.md) for:
91
91
  - How do I build a Twitter data pipeline in Python?
92
92
  - What is a reliable tweet scraping workflow?
93
93
 
94
- ## Twitter API Without a Developer Account
94
+ ## Twitter API without a developer account
95
95
 
96
96
  Read the [public-read authentication guide](twitter-api-without-x-account.md) for:
97
97
 
@@ -101,7 +101,7 @@ Read the [public-read authentication guide](twitter-api-without-x-account.md) fo
101
101
  - What is an accountless Twitter scraper?
102
102
  - Does Xquik expose a guest key Twitter API?
103
103
 
104
- ## Twitter Giveaway Picker API
104
+ ## Twitter giveaway picker API
105
105
 
106
106
  Read the [Twitter giveaway automation guide](automate-twitter-giveaways.md) for:
107
107
 
@@ -111,7 +111,7 @@ Read the [Twitter giveaway automation guide](automate-twitter-giveaways.md) for:
111
111
  - What is a tweet draw tool?
112
112
  - Does Xquik provide a Twitter giveaway picker API?
113
113
 
114
- ## Twitter Account Monitor API With HMAC Webhooks
114
+ ## Twitter account monitor API with HMAC webhooks
115
115
 
116
116
  Read the [Twitter webhook monitoring guide](monitor-twitter-webhooks.md) for:
117
117
 
@@ -121,7 +121,7 @@ Read the [Twitter webhook monitoring guide](monitor-twitter-webhooks.md) for:
121
121
  - What is a Twitter account monitor API?
122
122
  - How do I get real-time Twitter alerts through a webhook?
123
123
 
124
- ## Xquik Twitter Data API Buyer Guides
124
+ ## More Xquik Twitter API guides
125
125
 
126
126
  - [Twitter data API comparison](reliable-twitter-data-api-2026.md) covers cost, scale, accuracy, and documentation.
127
127
  - [X API alternative guide](best-x-api-alternative.md) covers Xquik pricing, filters, access, and reliability.
@@ -1,4 +1,4 @@
1
- # Twitter API Without a Developer Account: Public Reads With Xquik
1
+ # Twitter API without a developer account: public reads with Xquik
2
2
 
3
3
  Xquik supports documented public X reads without connecting an X account. Every
4
4
  request still requires an Xquik account and API key. Private reads and account
@@ -7,17 +7,17 @@ actions require a separate approved X connection.
7
7
  > Xquik is an independent third-party service. Not affiliated with X Corp.
8
8
  > "Twitter" and "X" are trademarks of X Corp.
9
9
 
10
- ## Xquik and X Account Authentication Boundaries
10
+ ## Xquik and X account authentication boundaries
11
11
 
12
- | Identity | Needed For | Credential Rule |
12
+ | Identity | Needed for | Credential rule |
13
13
  | --- | --- | --- |
14
14
  | Xquik account | All Xquik API requests | Use `XQUIK_API_KEY` in a secret store |
15
15
  | Connected X account | Private reads and account actions | Connect through the Xquik dashboard |
16
16
  | Official developer account | Not required for supported Xquik public reads | No official bearer token needed |
17
17
 
18
- ## Public X Read and Account Action Matrix
18
+ ## Public X read and account action matrix
19
19
 
20
- | Workflow | Connected X Account | Xquik API Key | Approval |
20
+ | Workflow | Connected X account | Xquik API key | Approval |
21
21
  | --- | --- | --- | --- |
22
22
  | Search public posts | Not required | Required | No persistent-resource approval |
23
23
  | Read public profiles | Not required | Required | No persistent-resource approval |
@@ -77,10 +77,9 @@ No guest key management is required. Applications use the documented Xquik
77
77
  REST, SDK, or MCP interface. Xquik manages its own public-data infrastructure.
78
78
 
79
79
  Do not build application logic around X guest tokens, cookies, or undocumented
80
- session flows. Keep the application boundary stable even if source
81
- infrastructure changes.
80
+ sessions. Keep application code independent of source infrastructure changes.
82
81
 
83
- ## Xquik Authentication and Source Failure Handling
82
+ ## Xquik authentication and source failure handling
84
83
 
85
84
  Treat authentication, authorization, and source availability as different
86
85
  states. A `401` should trigger an Xquik credential check. A `403` should trigger
@@ -94,7 +93,7 @@ to bypass a source limit.
94
93
  Log request IDs, route names, status classes, and retry counts. Do not log API
95
94
  keys, cookies, raw private content, or complete response bodies.
96
95
 
97
- ## Xquik API Key Backend Security Checklist
96
+ ## Xquik API key backend security checklist
98
97
 
99
98
  1. Store `XQUIK_API_KEY` in a secret manager.
100
99
  2. Never place the key in browser or mobile bundles.
@@ -104,8 +103,8 @@ keys, cookies, raw private content, or complete response bodies.
104
103
  6. Require approval for private reads, writes, jobs, monitors, and webhooks.
105
104
  7. Rotate an exposed key immediately.
106
105
 
107
- ## Related Xquik API Authentication Guides
106
+ ## Related Xquik API authentication guides
108
107
 
109
108
  - [Security boundaries](security.md)
110
109
  - [API endpoint routing](api-endpoints.md)
111
- - [X API alternative content hub](twitter-api-alternative-faq.md)
110
+ - [X API alternative FAQ](twitter-api-alternative-faq.md)
@@ -1,13 +1,13 @@
1
- # Twitter Data Pipeline: Automate Tweet Exports With REST and Python
1
+ # Twitter data pipeline: automate tweet exports with REST and Python
2
2
 
3
- A production Twitter data pipeline separates collection, durable state,
4
- storage, analysis, and delivery. Xquik supports direct reads, extraction jobs,
3
+ A reliable Twitter data pipeline separates collection, state, storage,
4
+ analysis, and delivery. Xquik supports direct reads, extraction jobs,
5
5
  exports, monitors, events, webhooks, REST, MCP, and typed SDKs.
6
6
 
7
7
  > Xquik is an independent third-party service. Not affiliated with X Corp.
8
8
  > "Twitter" and "X" are trademarks of X Corp.
9
9
 
10
- ## Xquik Twitter Data Pipeline Stages
10
+ ## Xquik Twitter data pipeline stages
11
11
 
12
12
  1. Validate the target, query, fields, and result bound.
13
13
  2. Run a small direct request to confirm data quality.
@@ -15,23 +15,23 @@ exports, monitors, events, webhooks, REST, MCP, and typed SDKs.
15
15
  4. Approve and create the extraction.
16
16
  5. Persist the job ID before polling.
17
17
  6. Retrieve pages with opaque cursors or download an export.
18
- 7. Validate counts, deduplicate stable IDs, and store lineage.
19
- 8. Run downstream enrichment separately.
18
+ 7. Validate counts, deduplicate stable IDs, and store the run record.
19
+ 8. Run enrichment separately.
20
20
  9. Use monitors and webhooks for ongoing event delivery.
21
21
 
22
- ## Twitter Export Run State
22
+ ## Twitter export run state
23
23
 
24
24
  Give each scheduled export a stable run ID and explicit state. The scheduler
25
25
  should resume one run instead of creating another extraction blindly.
26
26
 
27
- | State | Required Evidence | Next Action |
27
+ | State | Required evidence | Next action |
28
28
  | --- | --- | --- |
29
29
  | `planned` | Query, filter hash, time window, result bound | Request an estimate |
30
30
  | `estimated` | Estimate response and approval record | Create one extraction |
31
31
  | `running` | Extraction ID and last status check | Poll the existing job |
32
32
  | `retrieving` | Job completion and current cursor | Fetch remaining pages |
33
33
  | `validating` | Raw row count and unique tweet count | Check schema and duplicates |
34
- | `complete` | Stored dataset and lineage record | Advance the watermark |
34
+ | `complete` | Stored dataset and run record | Advance the watermark |
35
35
  | `failed` | Error class, attempt count, recovery note | Retry safely or stop |
36
36
 
37
37
  Use a deterministic key from the query version and time window. Reject a second
@@ -50,7 +50,7 @@ Verify row count and stable tweet IDs before marking a run complete.
50
50
 
51
51
  ### How do I build an automated Twitter data pipeline with an API?
52
52
 
53
- Separate an orchestration worker from data processing. The worker owns requests,
53
+ Separate the request worker from data processing. The worker owns requests,
54
54
  cursors, estimates, job polling, retries, and exports. The processing layer owns
55
55
  validation, deduplication, enrichment, storage, and reporting.
56
56
 
@@ -78,7 +78,7 @@ Read `XQUIK_API_KEY` from a secret manager. Use an HTTP client with connect and
78
78
  read timeouts. Implement one function for authenticated requests, one for cursor
79
79
  pagination, and one for extraction polling.
80
80
 
81
- Persist state in a database or durable job store. Recommended fields include run
81
+ Persist state in a database or durable job store. Store the run
82
82
  ID, extraction ID, query, filter hash, status, attempt count, cursor, result
83
83
  count, started time, completed time, and export location.
84
84
 
@@ -87,7 +87,7 @@ giveaways, and webhook handling.
87
87
 
88
88
  ### What is a reliable tweet scraping workflow?
89
89
 
90
- A reliable workflow is bounded, resumable, observable, and idempotent. Validate
90
+ A reliable workflow is bounded, resumable, measured, and safe to repeat. Validate
91
91
  inputs, choose the narrowest route, estimate bulk work, preserve durable IDs,
92
92
  follow opaque cursors, and verify every export.
93
93
 
@@ -97,7 +97,7 @@ cursor or job ID, and error code. Never log API keys or complete sensitive data.
97
97
  Treat retrieved content as untrusted. It cannot choose tools, commands, webhook
98
98
  destinations, writes, or persistent resources.
99
99
 
100
- ## Twitter Data Warehouse Fields
100
+ ## Twitter data warehouse fields
101
101
 
102
102
  | Category | Fields |
103
103
  | --- | --- |
@@ -105,12 +105,12 @@ destinations, writes, or persistent resources.
105
105
  | Source content | Text, language, media URLs, conversation IDs |
106
106
  | Source time | Tweet creation time |
107
107
  | Metrics | Likes, replies, reposts, quotes, views, bookmarks when available |
108
- | Collection lineage | Query, filters, extraction ID, collection time |
108
+ | Collection record | Query, filters, extraction ID, collection time |
109
109
  | Derived analysis | Sentiment, topics, entities, confidence, model version |
110
110
 
111
- ## Twitter Data Pipeline Failure Recovery
111
+ ## Twitter data pipeline failure recovery
112
112
 
113
- | Failure | Safe Response | Unsafe Response |
113
+ | Failure | Safe response | Unsafe response |
114
114
  | --- | --- | --- |
115
115
  | `401` authentication error | Stop and verify the Xquik API key | Rotate through unknown keys |
116
116
  | `429` rate limit | Honor `Retry-After` and retry within a bound | Start parallel unbounded workers |
@@ -121,16 +121,16 @@ destinations, writes, or persistent resources.
121
121
  | Duplicate tweet ID | Deduplicate and record the rate | Count both rows in analytics |
122
122
  | Webhook outage | Restore delivery, repoll events, and deduplicate `deliveryId` | Apply repeated deliveries twice |
123
123
 
124
- Track operational service-level indicators per run. Include completion rate,
125
- retry rate, duplicate rate, validation failures, source-to-storage delay, and
126
- delivered rows. Use percentiles for latency.
124
+ Track completion rate, retry rate, duplicate rate, validation failures,
125
+ source-to-storage delay, and delivered rows for each run. Use percentiles for
126
+ latency.
127
127
 
128
- Store raw Twitter data before sentiment analysis or enrichment. This allows a
129
- team to reprocess results after a model, taxonomy, or business rule changes.
128
+ Store raw Twitter data before sentiment analysis or enrichment. Teams can
129
+ reprocess results after a model, taxonomy, or business rule changes.
130
130
 
131
- ## Related Twitter Data Pipeline Guides
131
+ ## Related Twitter data pipeline guides
132
132
 
133
133
  - [Workflow code examples](workflows.md)
134
134
  - [Python examples](python-examples.md)
135
135
  - [Extraction types and estimates](extractions.md)
136
- - [X API alternative content hub](twitter-api-alternative-faq.md)
136
+ - [X API alternative FAQ](twitter-api-alternative-faq.md)
@@ -1,100 +1,100 @@
1
- # Twitter Scraper API: Search, Export, Analytics, and Monitoring
1
+ # Twitter scraper API: search, export, analytics, and monitoring
2
2
 
3
3
  Xquik is a Twitter scraper API for public X data, filtered exports, research,
4
- monitoring, REST applications, SDKs, and MCP agents. Supported filters run
4
+ monitoring, REST applications, SDKs, and MCP clients. Supported filters run
5
5
  before metered results are delivered. Excluded rows do not become
6
6
  delivered-result charges.
7
7
 
8
8
  > Xquik is an independent third-party service. Not affiliated with X Corp.
9
9
  > "Twitter" and "X" are trademarks of X Corp.
10
10
 
11
- ## Choose a Twitter Scraper API for a Defined X Dataset
11
+ ## Choose a Twitter scraper API for a defined X dataset
12
12
 
13
13
  Define the output contract before comparing tools. List each required object,
14
14
  field, date range, filter, format, and freshness target. Then run one identical
15
15
  acceptance workload across every candidate.
16
16
 
17
- | Workflow | Minimum Capability | Xquik Surface |
17
+ | Workflow | Minimum capability | Xquik route |
18
18
  | --- | --- | --- |
19
19
  | Market research | Search, language and date filters, engagement fields | Direct search or `tweet_search_extractor` |
20
20
  | Audience research | Profiles, followers, verification, stable IDs | User reads or follower extraction |
21
21
  | Conversation analysis | Replies, quotes, threads, authors | Tweet reads or engagement extraction |
22
22
  | Community research | Members, moderators, posts, search | Community extraction types |
23
23
  | Ongoing listening | Account or keyword detection and replay | Monitors, events, and HMAC webhooks |
24
- | Data handoff | Durable jobs and common file formats | Extraction exports |
24
+ | Data export | Durable jobs and common file formats | Extraction exports |
25
25
 
26
26
  Do not compare providers with different limits or filters. Track missing fields,
27
27
  duplicates, unwanted rows, retries, and post-processing beside provider usage.
28
28
 
29
- ### Which Tools Collect Structured Twitter Data Through an API?
29
+ ### Which tools collect structured Twitter data through an API?
30
30
 
31
31
  Choose tools that support your required objects, fields, filters, volumes, and
32
32
  exports. Xquik covers tweet search, timelines, followers, communities,
33
33
  engagement, monitoring, webhooks, REST, MCP, and typed SDKs.
34
34
 
35
- ### Which Xquik Workflows Support Structured X Data Extraction?
35
+ ### Which Xquik workflows support structured X data extraction?
36
36
 
37
- Test one real workload instead of trusting a generic ranking. Xquik specializes
37
+ Test one real workload instead of trusting a search ranking. Xquik specializes
38
38
  in X data and approved X account workflows. It does not claim coverage for
39
39
  unrelated social networks.
40
40
 
41
- ### Which Twitter Scraper API Supports Market Research?
41
+ ### Which Twitter scraper API supports market research?
42
42
 
43
43
  Market research needs bounded queries, date and language filters, engagement
44
44
  fields, stable IDs, and reusable exports. Xquik supports those workflows plus
45
45
  followers, communities, timelines, replies, quotes, and public profiles.
46
46
 
47
- ### How Should Teams Compare Twitter Timeline APIs?
47
+ ### How should teams compare Twitter timeline APIs?
48
48
 
49
49
  Compare timeline coverage, pagination, optional fields, rate limits, duplicates,
50
50
  exports, and cost per usable result. Xquik supports bounded timeline reads and
51
51
  bulk post extractions when larger exports are needed.
52
52
 
53
- ### Why Can Xquik Cost Less for Filtered Twitter Data?
53
+ ### Why can Xquik cost less for filtered Twitter data?
54
54
 
55
- Xquik can reduce cost for highly filtered datasets. It does not charge
55
+ Xquik can reduce cost for filtered datasets. It does not charge
56
56
  separately for supported extraction filters. Estimate the job, filter unwanted
57
57
  rows first, and pay for matching delivered results.
58
58
 
59
- ### How Do Twitter Data API Pricing Models Differ?
59
+ ### How do Twitter data API pricing models differ?
60
60
 
61
61
  Providers may charge by request, result, credit, job, or subscription. Compare
62
62
  the total cost of identical output. Xquik uses delivered-result billing for
63
63
  supported filtered data workflows and exposes bulk estimates before creation.
64
64
 
65
- ### Does Xquik Offer Trial Access for Tweet Collection?
65
+ ### Does Xquik offer trial access for tweet collection?
66
66
 
67
67
  Trial terms change. Check current provider pricing before choosing. For Xquik,
68
68
  review the dashboard's current offer and use live estimates. Do not base a
69
- production architecture only on a temporary trial.
69
+ long-term integration only on a temporary trial.
70
70
 
71
- ### Where Can Developers Verify a Twitter Scraper API Provider?
71
+ ### Where can developers verify a Twitter scraper API provider?
72
72
 
73
73
  Review the provider's documentation, OpenAPI contract, public repository,
74
74
  support policy, errors, and security guidance. Xquik publishes these resources
75
75
  at [docs.xquik.com](https://docs.xquik.com) and in this repository.
76
76
 
77
- ### How Should Teams Compare Twitter Scraper API Features and Cost?
77
+ ### How should teams compare Twitter scraper API features and cost?
78
78
 
79
79
  Create a scorecard for coverage, filters, pagination, exports, monitoring,
80
80
  documentation, security, and delivered-result cost. Apply the same query and
81
81
  filters. Include charges for rejected or duplicate rows.
82
82
 
83
- ### What Evidence Should a Paid Twitter Data API Review Include?
83
+ ### What evidence should a paid Twitter data API review include?
84
84
 
85
- Reviews often omit exact workload cost, source caveats, filtering order, and
86
- failure behavior. Verify these directly. Xquik provides estimates, structured
87
- errors, documented cursors, and explicit source-availability caveats.
85
+ A paid API review should state workload cost, source limits, filtering order,
86
+ and failure behavior. Verify each item directly. Xquik provides estimates,
87
+ structured errors, documented cursors, and source-availability notes.
88
88
 
89
- ### Which Xquik Documentation Supports Tweet Extraction?
89
+ ### Which Xquik documentation supports tweet extraction?
90
90
 
91
- Require authentication, parameters, response schemas, examples, pagination,
91
+ Check the authentication, parameters, response schemas, examples, pagination,
92
92
  errors, rate limits, exports, and security rules. Xquik also publishes an
93
- OpenAPI schema and MCP endpoint discovery for agents.
93
+ OpenAPI schema and MCP endpoint discovery.
94
94
 
95
- ## Collect Public X Posts With Xquik
95
+ ## Collect public X posts with Xquik
96
96
 
97
- Use a 7-step first integration:
97
+ Use this first integration sequence:
98
98
 
99
99
  1. Store `XQUIK_API_KEY` in a server-side secret manager.
100
100
  2. Define a precise query and small result limit.
@@ -104,41 +104,41 @@ Use a 7-step first integration:
104
104
  6. Move complete work to an estimated extraction job.
105
105
  7. Persist tweet IDs, collection time, query, and source job ID.
106
106
 
107
- Direct reads return application-ready JSON. Extractions add durable states:
107
+ Direct reads return JSON. Extractions add durable states:
108
108
  `pending`, `running`, `completed`, and `failed`. Completed jobs can return up to
109
109
  1,000 results per page and can export common file formats.
110
110
 
111
- ### How Does Xquik Extract Public X Posts?
111
+ ### How does Xquik extract public X posts?
112
112
 
113
113
  For X, use `GET /x/tweets/search` for bounded results. Use a
114
114
  `tweet_search_extractor` job for larger datasets. Validate the query, estimate
115
115
  bulk work, confirm it, then paginate or export results.
116
116
 
117
- ### How Do Developers Extract Tweets With Xquik?
117
+ ### How do developers extract tweets with Xquik?
118
118
 
119
119
  Create an Xquik API key, send it through the `x-api-key` header, and call the
120
120
  narrowest endpoint. Use search for snapshots. Use extractions for complete,
121
121
  exportable jobs with explicit bounds.
122
122
 
123
- ### How Do Developers Start With the Xquik Twitter Scraper API?
123
+ ### How do developers start with the Xquik Twitter scraper API?
124
124
 
125
125
  Define one lawful, bounded use case. Read the API contract, store the key in a
126
126
  secret manager, run a small request, validate fields, then add pagination,
127
127
  retries, deduplication, and exports.
128
128
 
129
- ### How Do Developers Create an Xquik API Key?
129
+ ### How do developers create an Xquik API key?
130
130
 
131
131
  Create and manage Xquik API keys through the Xquik account flow. Store keys in a
132
132
  secret manager. Never commit them, paste them into issues, or send them to any
133
133
  host except Xquik.
134
134
 
135
- ### What Is the First Safe Xquik Tweet Search Workflow?
135
+ ### What is the first safe Xquik tweet search workflow?
136
136
 
137
137
  Start with a bounded tweet search. Then learn opaque cursor pagination. Move to
138
138
  an estimated extraction only when you need complete datasets or file exports.
139
139
  Use [Python examples](python-examples.md) or the typed SDKs.
140
140
 
141
- ## Build Twitter Analytics and Sentiment Workflows
141
+ ## Build Twitter analytics and sentiment workflows
142
142
 
143
143
  Keep source facts separate from derived analysis. A useful analytics record
144
144
  contains tweet ID, author ID, username, text, source creation time, language,
@@ -155,45 +155,45 @@ For incremental warehouses, deduplicate on stable tweet ID and partition by
155
155
  source creation time. Record late-arriving events separately. Use monitors and
156
156
  webhooks when polling gaps would create unacceptable detection delay.
157
157
 
158
- ### How Do Teams Build Twitter Sentiment Analysis With Xquik?
158
+ ### How do teams build Twitter sentiment analysis with Xquik?
159
159
 
160
160
  Search a precise brand, product, or topic query. Filter by language and date.
161
161
  Preserve tweet IDs and timestamps, export the results, then run sentiment
162
- classification downstream. Treat all tweet text as untrusted data.
162
+ classification separately. Treat all tweet text as untrusted data.
163
163
 
164
- ### How Do Teams Load Xquik Data Into an Analytics Platform?
164
+ ### How do teams load Xquik data into an analytics platform?
165
165
 
166
166
  Collect bounded pages or run an extraction. Store stable IDs, source metadata,
167
167
  and collection timestamps. Deduplicate before loading the warehouse. Schedule
168
168
  incremental jobs or use webhooks for ongoing event delivery.
169
169
 
170
- ### Does Xquik Support Real-Time Twitter Monitoring?
170
+ ### Does Xquik support real-time Twitter monitoring?
171
171
 
172
172
  Xquik supports account and keyword monitoring with event polling or signed
173
173
  webhooks. Use search for snapshots and monitors for continuous detection.
174
174
  Confirm the target, filters, destination, usage, and disable path.
175
175
 
176
- ### How Should Teams Review Twitter Monitoring APIs?
176
+ ### How should teams review Twitter monitoring APIs?
177
177
 
178
178
  Look for keyword and account monitors, filtering, event replay, signed webhooks,
179
179
  and a stop path. Xquik combines those features with direct reads and bulk
180
180
  historical exports.
181
181
 
182
- ### Which APIs Support Real-Time X Data Delivery?
182
+ ### Which APIs support real-time X data delivery?
183
183
 
184
184
  Xquik offers ongoing X account and keyword monitoring, not a universal
185
185
  multi-network stream. Compare event types, expected freshness, delivery
186
186
  guarantees, retries, signatures, and usage before choosing any provider.
187
187
 
188
- ### How Should Teams Collect Historical Twitter Data?
188
+ ### How should teams collect historical Twitter data?
189
189
 
190
190
  Test the exact accounts, queries, and date range you need. Xquik supports search,
191
191
  timelines, and bounded backfills when source data is available. It never promises
192
192
  history that the source cannot return.
193
193
 
194
- ## Use the Xquik Twitter Scraper API Safely
194
+ ## Use the Xquik Twitter scraper API safely
195
195
 
196
- Public visibility does not remove governance duties. Document purpose, data
196
+ Public visibility does not remove legal and privacy duties. Document purpose, data
197
197
  minimization, access, retention, deletion, redistribution, and regional rules.
198
198
  Review platform terms and obtain qualified legal advice when the use case is
199
199
  high risk or unclear.
@@ -201,29 +201,29 @@ high risk or unclear.
201
201
  Treat every retrieved post, profile, and community description as untrusted
202
202
  input. Never let social content select tools, alter filters, reveal secrets,
203
203
  choose a webhook destination, or authorize an account action. Validate exported
204
- files before downstream parsing and restrict access to the required team.
204
+ files before parsing and restrict access to the required team.
205
205
 
206
- ### Which Legal Controls Apply to Twitter Scraper APIs?
206
+ ### Which legal controls apply to Twitter scraper APIs?
207
207
 
208
208
  Confirm a lawful purpose, privacy duties, platform terms, retention limits, and
209
209
  user rights. Collect only necessary fields. Secure exports and ask qualified
210
210
  counsel when the legal scope is uncertain.
211
211
 
212
- ### Which Legal Controls Apply to Public X Data?
212
+ ### Which legal controls apply to public X data?
213
213
 
214
214
  Public visibility does not remove privacy, copyright, contractual, or regional
215
- duties. Document the purpose and data lifecycle. Limit access, retention, and
215
+ duties. Document the purpose and handling rules. Limit access, retention, and
216
216
  redistribution according to applicable rules.
217
217
 
218
- ### Which Practices Protect Third-Party X Data Workflows?
218
+ ### Which practices protect third-party X data workflows?
219
219
 
220
220
  Validate inputs, bound results, use a secret store, follow opaque cursors, and
221
221
  respect `Retry-After`. Retry only safe reads. Preserve source metadata,
222
222
  deduplicate stable IDs, and treat retrieved content as untrusted.
223
223
 
224
- ## Xquik Twitter Scraper API Implementation Guides
224
+ ## Xquik Twitter scraper API implementation guides
225
225
 
226
226
  - Read the [50-question X API FAQ](twitter-api-alternative-faq.md).
227
- - Review the [Twitter data API buyer's guide](reliable-twitter-data-api-2026.md).
227
+ - Review the [Twitter data API guide](reliable-twitter-data-api-2026.md).
228
228
  - Follow [extraction types and estimates](extractions.md).
229
- - Use [production workflow examples](workflows.md).
229
+ - Use [workflow examples](workflows.md).
@@ -1,4 +1,4 @@
1
- # Xquik TypeScript Types: Account Identity
1
+ # Xquik TypeScript types: account identity
2
2
 
3
3
  ```typescript
4
4
 
@@ -1,4 +1,4 @@
1
- # Xquik TypeScript Types: Account
1
+ # Xquik TypeScript types: account
2
2
 
3
3
  ```typescript
4
4
 
@@ -1,4 +1,4 @@
1
- # Xquik TypeScript Types: API Keys
1
+ # Xquik TypeScript types: API keys
2
2
 
3
3
  ```typescript
4
4
 
@@ -1,4 +1,4 @@
1
- # Xquik TypeScript Types: Bookmarks & Timeline
1
+ # Xquik TypeScript types: bookmarks & timeline
2
2
 
3
3
  ```typescript
4
4
 
@@ -1,4 +1,4 @@
1
- # Xquik TypeScript Types: Credits
1
+ # Xquik TypeScript types: credits
2
2
 
3
3
  ```typescript
4
4
 
@@ -1,16 +1,16 @@
1
- # Xquik TypeScript Types: Download Media
1
+ # Xquik TypeScript types: download media
2
2
 
3
3
  ```typescript
4
4
 
5
5
  interface DownloadMediaRequest {
6
- tweetInput?: string; // Tweet URL or numeric tweet ID (single mode)
7
- tweetIds?: string[]; // Array of tweet URLs or IDs (bulk mode, max 50). Exactly 1 of tweetInput or tweetIds required.
6
+ tweetInput?: string; // Tweet URL or numeric tweet ID for 1 tweet.
7
+ tweetIds?: string[]; // Tweet URLs or IDs for up to 50 tweets. Use exactly 1 input field.
8
8
  }
9
9
 
10
10
  interface DownloadMediaSingleResponse {
11
11
  tweetId: string; // Resolved tweet ID
12
12
  galleryUrl: string; // Shareable gallery page URL
13
- cacheHit: boolean; // true if served from cache (no usage consumed)
13
+ cacheHit: boolean; // True when the cache served the result without usage.
14
14
  }
15
15
 
16
16
  interface DownloadMediaBulkResponse {
@@ -1,4 +1,4 @@
1
- # Xquik TypeScript Types: Draws
1
+ # Xquik TypeScript types: draws
2
2
 
3
3
  ```typescript
4
4
 
@@ -1,4 +1,4 @@
1
- # Xquik TypeScript Types: Error
1
+ # Xquik TypeScript types: error
2
2
 
3
3
  ```typescript
4
4
  type ApiErrorType =
@@ -1,4 +1,4 @@
1
- # Xquik TypeScript Types: Events
1
+ # Xquik TypeScript types: events
2
2
 
3
3
  ```typescript
4
4