twitter-developer-api 2.5.3

package/skills/x-twitter-scraper/references/api-endpoints-tweet-style-cache.md

@@ -0,0 +1,155 @@
+# Xquik REST API Endpoints: Tweet Style Cache
+
+### Analyze & Cache Style
+
+`POST /styles`
+
+Fetch recent tweets from an X account and cache them for style analysis. **Consumes metered API usage.**
+
+**Request body:**
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `username` | string | Yes | X username to analyze (without @) |
+
+**Response (201):**
+
+```json
+{
+  "xUsername": "elonmusk",
+  "tweetCount": 20,
+  "isOwnAccount": false,
+  "fetchedAt": "2026-02-24T10:30:00.000Z",
+  "tweets": [
+    {
+      "id": "1893456789012345678",
+      "text": "The future is now.",
+      "authorUsername": "elonmusk",
+      "createdAt": "2026-02-24T14:22:00.000Z"
+    }
+  ]
+}
+```
+
+---
+
+### List Cached Styles
+
+`GET /styles`
+
+List all cached tweet style profiles. Max 200 results, ordered by fetch date.
+
+**Response (200):**
+
+```json
+{
+  "styles": [
+    {
+      "xUsername": "elonmusk",
+      "tweetCount": 20,
+      "isOwnAccount": false,
+      "fetchedAt": "2026-02-24T10:30:00.000Z"
+    }
+  ]
+}
+```
+
+---
+
+### Save Custom Style
+
+`PUT /styles/{id}`
+
+Save a custom style profile from tweet texts. The body `label` controls the saved style label and replaces any existing style with that label.
+
+**Body:**
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `label` | string | Yes | Style label name (1-30 characters) |
+| `tweets` | object[] | Yes | Array of tweet objects (1-100). Each must have a `text` field |
+
+**Response (200):** Style object with label, `tweetCount`, `isOwnAccount: false`, `fetchedAt`, and `tweets` array.
+
+**Errors:** `400 invalid_input`
+
+---
+
+### Get Cached Style
+
+`GET /styles/{id}`
+
+Get a cached style profile with full tweet data. `id` is the cached style label or username.
+
+**Response (200):** Full style object with `tweets` array.
+
+**Errors:** `404 style_not_found`
+
+---
+
+### Delete Cached Style
+
+delete request to `/styles/{id}`
+
+Delete a cached style by label or username. Returns `204 No Content`.
+
+**Errors:** `404 style_not_found`
+
+---
+
+### Compare Styles
+
+`GET /styles/compare?username1=A&username2=B`
+
+Compare two cached tweet style profiles side by side.
+
+**Query parameters:**
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `username1` | string | Yes | First X username |
+| `username2` | string | Yes | Second X username |
+
+**Response (200):**
+
+```json
+{
+  "style1": { "xUsername": "user1", "tweetCount": 20, "isOwnAccount": true, "fetchedAt": "...", "tweets": [...] },
+  "style2": { "xUsername": "user2", "tweetCount": 15, "isOwnAccount": false, "fetchedAt": "...", "tweets": [...] }
+}
+```
+
+**Errors:** `400 missing_params`, `404 style_not_found`
+
+---
+
+### Analyze Performance
+
+`GET /styles/{id}/performance`
+
+Get live engagement metrics for cached tweets for a cached style label or username. **Consumes metered API usage.**
+
+**Response (200):**
+
+```json
+{
+  "xUsername": "elonmusk",
+  "tweetCount": 20,
+  "tweets": [
+    {
+      "id": "1893456789012345678",
+      "text": "The future is now.",
+      "likeCount": 42000,
+      "retweetCount": 8500,
+      "replyCount": 3200,
+      "quoteCount": 1100,
+      "viewCount": 5000000,
+      "bookmarkCount": 2400
+    }
+  ]
+}
+```
+
+**Errors:** `404 style_not_found`
+
+---

package/skills/x-twitter-scraper/references/api-endpoints-webhooks.md

@@ -0,0 +1,74 @@
+# Xquik REST API Endpoints: Webhooks
+
+### Create Webhook
+
+```
+POST /webhooks
+```
+
+**Body:**
+```json
+{
+  "url": "https://your-server.com/webhook",
+  "eventTypes": ["tweet.new", "tweet.reply"]
+}
+```
+
+**Response** includes a `secret` field (shown only once). Store it for signature verification.
+
+### List Webhooks
+
+```
+GET /webhooks
+```
+
+Returns all webhooks (up to 200). Secret is never exposed in list responses.
+
+### Update Webhook
+
+```
+PATCH /webhooks/{id}
+```
+
+**Body:** `{ "url": "...", "eventTypes": [...], "isActive": true|false }` (all optional)
+
+### Delete Webhook
+
+```
+delete request to `/webhooks/{id}`
+```
+
+Permanently removes the webhook. All future deliveries are stopped.
+
+### Test Webhook
+
+```
+POST /webhooks/{id}/test
+```
+
+Sends a `webhook.test` event to the webhook endpoint, HMAC-signed with the webhook's secret. Returns success or failure status with HTTP response details.
+
+**Payload delivered to your endpoint:**
+```json
+{
+  "eventType": "webhook.test",
+  "data": {
+    "message": "Test delivery from Xquik"
+  },
+  "timestamp": "2026-02-27T12:00:00.000Z"
+}
+```
+
+The delivery includes the `X-Xquik-Signature` header, identical to production deliveries.
+
+Returns `400 webhook_inactive` if the webhook is disabled. Reactivate via `PATCH /webhooks/{id}` before testing.
+
+### List Deliveries
+
+```
+GET /webhooks/{id}/deliveries
+```
+
+View delivery attempts and statuses for a webhook. Statuses: `pending`, `delivered`, `failed`, `exhausted`.
+
+---

package/skills/x-twitter-scraper/references/api-endpoints-x-accounts.md

@@ -0,0 +1,42 @@
+# Xquik REST API Endpoints: X Accounts (Connected)
+
+Manage connected X accounts for confirmation-gated write actions.
+
+**Connecting or re-authenticating an X account is done by the user in the Xquik dashboard**, not via this skill. The skill never handles X login material. The agent should direct the user to the dashboard account page when a new account needs to be connected or an existing session needs to be refreshed.
+
+The OpenAPI surface includes dashboard-owned account connection routes:
+
+```
+POST /x/accounts
+POST /x/account-connection-challenges/{id}/submit
+POST /x/accounts/{id}/reauth
+POST /x/accounts/bulk-retry
+```
+
+Do not call these from this skill. They are listed here only so the skill docs match the public API surface and keep the dashboard-only boundary explicit.
+
+### List X Accounts
+
+```
+GET /x/accounts
+```
+
+Returns all connected X accounts. Response: `{ accounts: [{ id, username, displayName, isActive, createdAt }] }`.
+
+### Get X Account
+
+```
+GET /x/accounts/{id}
+```
+
+Returns `{ id, username, displayName, isActive, createdAt }`.
+
+### Disconnect X Account
+
+```
+delete request to `/x/accounts/{id}`
+```
+
+Permanently removes the account from Xquik. Returns `{ success: true }`. Before calling, confirm with the user.
+
+---

package/skills/x-twitter-scraper/references/api-endpoints-x-api.md

@@ -0,0 +1,206 @@
+# Xquik REST API Endpoints: X API (Direct Lookups)
+
+Metered operations that require account access.
+
+### Get Tweet
+
+```
+GET /x/tweets/{id}
+```
+
+Returns full tweet with engagement metrics (likes, retweets, replies, quotes, views, bookmarks), author info (username, followers, verified status, profile picture), and optional attached media (photos/videos with URLs).
+
+### Get Article
+
+```
+GET /x/articles/{tweetId}
+```
+
+Retrieve the full content of an X Article (long-form post) by numeric tweet ID. If the user gives an article URL, use the final status ID as `tweetId`. Returns title, body text with block-level formatting, cover image, inline images, and engagement metrics. Metered.
+
+**Response:**
+```json
+{
+  "title": "Why AI Will Transform Everything",
+  "coverImage": "https://pbs.twimg.com/...",
+  "bodyHtml": "<p>The future of AI...</p>",
+  "likeCount": 5200,
+  "retweetCount": 890,
+  "replyCount": 245,
+  "viewCount": 150000,
+  "bookmarkCount": 1200,
+  "author": {
+    "id": "44196397",
+    "username": "elonmusk",
+    "name": "Elon Musk"
+  }
+}
+```
+
+### Search Tweets
+
+```
+GET /x/tweets/search?q={query}
+```
+
+Search using X syntax: keywords, `#hashtags`, `from:user`, `to:user`, `"exact phrases"`, `OR`, `-exclude`.
+
+Returns tweet info with optional engagement metrics (likeCount, retweetCount, replyCount) and optional attached media. Some fields may be omitted if unavailable.
+
+### Get User
+
+```
+GET /x/users/{id}
+```
+
+Returns profile info. `id` accepts either an X username without `@` or a numeric user ID. Fields `id`, `username`, `name` are always present. All other fields (`description`, `followers`, `following`, `verified`, `profilePicture`, `location`, `createdAt`, `statusesCount`) are optional and omitted when unavailable.
+
+### Batch & Search Users
+
+```
+GET /x/users/batch?ids=44196397,783214
+GET /x/users/search?q=founder
+```
+
+Batch lookup accepts up to 100 comma-separated numeric user IDs. User search returns matching profiles and may include a pagination cursor.
+
+### Check Follower
+
+```
+GET /x/followers/check?source={username}&target={username}
+```
+
+Returns `isFollowing` and `isFollowedBy` for both directions.
+
+### Get User Tweets
+
+```
+GET /x/users/{id}/tweets
+```
+
+Get a user's recent tweets by user ID. Metered per returned tweet.
+
+### Batch Tweets
+
+```
+GET /x/tweets?ids=1893456789012345678,1893456789012345679
+```
+
+Get multiple tweets by comma-separated tweet IDs. Maximum 100 IDs.
+
+### Get User Likes
+
+```
+GET /x/users/{id}/likes
+```
+
+Get tweets liked by a user. Metered per returned result.
+
+### Get User Media
+
+```
+GET /x/users/{id}/media
+```
+
+Get a user's media tweets (tweets containing photos/videos). Metered per returned result.
+
+### Get Tweet Favoriters
+
+```
+GET /x/tweets/{id}/favoriters
+```
+
+Get users who liked a tweet. Metered per returned result.
+
+### Tweet Conversation & Engagement Lists
+
+```
+GET /x/tweets/{id}/quotes
+GET /x/tweets/{id}/replies
+GET /x/tweets/{id}/retweeters
+GET /x/tweets/{id}/thread
+```
+
+Read quote tweets, replies, retweeters, or the conversation thread for a tweet. These are paginated read operations.
+
+### User Social Graph Reads
+
+```
+GET /x/users/{id}/followers
+GET /x/users/{id}/following
+GET /x/users/{id}/mentions
+GET /x/users/{id}/verified-followers
+```
+
+Read followers, following, mentions, and verified followers for a username or numeric user ID. These are paginated read operations.
+
+### Get Mutual Followers
+
+```
+GET /x/users/{id}/followers-you-know
+```
+
+Get mutual followers (followers you know). Metered per returned result.
+
+### X Lists
+
+```
+GET /x/lists/{id}/followers
+GET /x/lists/{id}/members
+GET /x/lists/{id}/tweets
+```
+
+Read list followers, members, or list timeline tweets by list ID.
+
+### X Communities
+
+```
+GET /x/communities/search
+GET /x/communities/tweets
+GET /x/communities/{id}/info
+GET /x/communities/{id}/members
+GET /x/communities/{id}/moderators
+GET /x/communities/{id}/tweets
+```
+
+Search communities and read community metadata, members, moderators, or tweets. Community writes are listed under X Write and require confirmation.
+
+### Get Bookmarks
+
+```
+GET /x/bookmarks
+```
+
+Get bookmarked tweets. Requires a connected X account. Metered per returned result.
+
+**Sensitive:** Returns private data. Confirm with user before calling.
+
+### Get Bookmark Folders
+
+```
+GET /x/bookmarks/folders
+```
+
+Get bookmark folders. Requires a connected X account. Metered.
+
+### Get Notifications
+
+```
+GET /x/notifications
+```
+
+Get notifications with type filter. Requires a connected X account. Metered per returned result.
+
+**Sensitive:** Returns private data. Confirm with user before calling.
+
+### Get Home Timeline
+
+```
+GET /x/timeline
+```
+
+Get home timeline. Requires a connected X account. Metered per returned result.
+
+**Sensitive:** Returns private data. Confirm with user before calling.
+
+---

package/skills/x-twitter-scraper/references/api-endpoints-x-media.md

@@ -0,0 +1,40 @@
+# Xquik REST API Endpoints: X Media (Download)
+
+### Download Media
+
+```
+POST /x/media/download
+```
+
+Download images, videos, and GIFs from tweets. Single or bulk (up to 50). Returns a shareable gallery URL.
+
+**Body:** Provide either `tweetInput` (single tweet) or `tweetIds` (bulk). Exactly 1 is required.
+
+| Field | Type | Description |
+|-------|------|-------------|
+| `tweetInput` | string | Tweet URL or numeric tweet ID for a single download. Accepts `x.com` and `twitter.com` URL formats |
+| `tweetIds` | string[] | Array of tweet URLs or IDs for bulk download. Maximum 50 items. Returns a single combined gallery |
+
+**Response (single):**
+```json
+{
+  "tweetId": "1893456789012345678",
+  "galleryUrl": "https://xquik.com/g/abc123",
+  "cacheHit": false
+}
+```
+
+**Response (bulk):**
+```json
+{
+  "galleryUrl": "https://xquik.com/g/def456",
+  "totalTweets": 3,
+  "totalMedia": 7
+}
+```
+
+First download is metered. Subsequent requests for the same tweet return cached URLs when `cacheHit: true`. All downloads are saved to shareable gallery pages under `https://xquik.com/g/{token}`.
+
+Returns `400 no_media` if the tweet has no downloadable media. Returns `400 too_many_tweets` if bulk array exceeds 50 items.
+
+---