Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/xquik-api-support-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
openapi: 3.2.0
info:
title: Xquik Support API
version: '1.0'
description: "Xquik is an independent third-party service. Not affiliated with X Corp. \"Twitter\" and \"X\" are trademarks of X Corp. Look up tweets, users, and X trends. Search tweets, check follow relationships, download media, and monitor accounts. 33 paid-read endpoints accept prepaid credits without a subscription. 7 fixed-price lookups also accept direct MPP payments. Write and automation endpoints require an API key or OAuth 2.1 bearer token.\n\n## Xquik SDKs\n\nStainless generates each SDK from this OpenAPI schema. Pick a language:\n\n- TypeScript / Node.js: `npm i x-twitter-scraper` -\n [Xquik-dev/x-twitter-scraper-typescript](https://github.com/Xquik-dev/x-twitter-scraper-typescript)\n\n- Python: `pip install x-twitter-scraper` -\n [Xquik-dev/x-twitter-scraper-python](https://github.com/Xquik-dev/x-twitter-scraper-python)\n\n- Go: `go get github.com/Xquik-dev/x-twitter-scraper-go` -\n [Xquik-dev/x-twitter-scraper-go](https://github.com/Xquik-dev/x-twitter-scraper-go)\n\n- Ruby: `gem install x-twitter-scraper` -\n [Xquik-dev/x-twitter-scraper-ruby](https://github.com/Xquik-dev/x-twitter-scraper-ruby)\n\n- Java (source build; Maven Central pending) -\n [Xquik-dev/x-twitter-scraper-java](https://github.com/Xquik-dev/x-twitter-scraper-java)\n\n- Kotlin (source build; Maven Central pending) -\n [Xquik-dev/x-twitter-scraper-kotlin](https://github.com/Xquik-dev/x-twitter-scraper-kotlin)\n\n- C# / .NET: `dotnet add package XTwitterScraper` -\n [Xquik-dev/x-twitter-scraper-csharp](https://github.com/Xquik-dev/x-twitter-scraper-csharp)\n\n- PHP: `composer require xquik/x-twitter-scraper` -\n [Xquik-dev/x-twitter-scraper-php](https://github.com/Xquik-dev/x-twitter-scraper-php)\n\n- CLI: `go install github.com/Xquik-dev/x-twitter-scraper-cli/cmd/x-twitter-scraper@latest` -\n [Xquik-dev/x-twitter-scraper-cli](https://github.com/Xquik-dev/x-twitter-scraper-cli)\n\n- Terraform Provider (Terraform Registry) -\n [Xquik-dev/terraform-provider-x-twitter-scraper](https://github.com/Xquik-dev/terraform-provider-x-twitter-scraper)\n\n\nOpenClaw plugin: [Xquik-dev/tweetclaw](https://github.com/Xquik-dev/tweetclaw) (`openclaw plugins install clawhub:@xquik/tweetclaw`)."
x-guidance: '## Common tasks
**Find a tweet** - GET /x/tweets/{id} with a numeric tweet ID. Returns full tweet data: text, author, metrics (likes, retweets, replies, views), media URLs, and creation timestamp. Cost: $0.00015 per lookup.
**Search tweets** - GET /x/tweets/search?q={query}&limit={n}. Supports X search operators, structured filters like fromUser, mediaType, minFaves, hashtags, and verifiedOnly, plus exact lookup for a pasted Tweet ID or X status URL. Plain from:user date windows are optimized for timeline completeness. Returns up to 200 tweets per page with cursor-based pagination. Cost: $0.00015 per tweet returned.
**Find a user** - GET /x/users/{id} where {id} is a numeric user ID or @username. Returns profile data: name, bio, follower/following counts, verification status, join date. Cost: $0.00015 per lookup.
**Check if A follows B** - GET /x/followers/check?source={a}&target={b} where source and target are usernames, @usernames, or X or Twitter profile URLs. Cost: $0.00075.
**Get trending topics** - GET /trends?woeid={region}&count={n}. WOEID 1 = worldwide, 23424977 = US, 23424975 = UK, 23424969 = Turkey. Cost: $0.00045.
**Download media** - POST /x/media/download with {"tweetIds": ["123", "456"]} body. Returns download URLs for images and videos. Cost: 1 credit per fresh tweet processed with media; cached repeat downloads are free.
**Read an article** - GET /x/articles/{tweetId} for long-form X Articles. Returns full article HTML, cover image, and metadata. Cost: $0.00075.
## Pagination
Default v1 responses keep their existing pagination fields for compatibility. Platform list endpoints return `hasMore` and `nextCursor`; X data endpoints return `has_next_page` and `next_cursor`. Send `xquik-api-contract: 2026-04-29` to receive the unified best-practice fields `has_more` and `next_cursor`. Pass the cursor back as `?cursor={cursor}`; legacy `?after={cursor}` still works. Dynamic-priced endpoints charge per item returned, not per request.
## Authentication
Eligible paid read endpoints accept accountless prepaid credit wallets. Fixed-price lookups also accept direct MPP payments. Media downloads, write endpoints, and automation features require authentication. Send an Xquik API key through `x-api-key`, `Xquik-Api-Key`, or `Authorization: Bearer xq_...`. Send an OAuth 2.1 access token through `Authorization: Bearer`.
## Best-Practice Response Contract
v1 keeps its original response contract by default so existing integrations do not break. Send `xquik-api-contract: 2026-04-29` to opt in to the best-practice contract: snake_case response fields, Unix timestamps in seconds, structured error objects, `has_more` and `next_cursor` pagination fields, `object` resource identifiers, and prefixed IDs where available. Dependency failures that returned 502 in default v1 return 424 in the opt-in contract. Future major API versions should make this contract the default.'
contact:
name: Xquik
url: https://xquik.com
email: support@xquik.com
servers:
- url: https://xquik.com
security:
- apiKey: []
- oauthBearer: []
tags:
- name: Support
description: Support ticket management
paths:
/api/v1/support/attachments/{id}:
get:
operationId: downloadSupportAttachment
summary: Download support ticket media
description: 'Streams an authenticated user''s support image or video. Video requests support one standard byte range for seeking and resumable playback.
'
tags:
- Support
security:
- apiKey: []
- oauthBearer: []
parameters:
- name: id
in: path
required: true
schema:
type: string
description: Support attachment public ID
example: att_a1b2c3d4e5f6a1b2c3d4e5f6
- name: Range
in: header
required: false
schema:
type: string
pattern: ^bytes=(?:[0-9]+-[0-9]*|-[0-9]+)$
description: Optional single byte range
example: bytes=0-1048575
responses:
'200':
description: Complete image or video bytes
content:
application/octet-stream:
schema:
type: string
format: binary
'206':
description: Requested partial video bytes
content:
application/octet-stream:
schema:
type: string
format: binary
'401':
$ref: '#/components/responses/Unauthenticated'
'404':
$ref: '#/components/responses/NotFound'
'416':
description: Invalid or unsatisfiable byte range
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: invalid_range
message: Use one valid byte range.
'429':
$ref: '#/components/responses/RateLimitExceeded'
default:
content:
application/json:
example:
error: internal_error
message: Unexpected error. Try again.
schema:
$ref: '#/components/schemas/Error'
description: Unexpected error.
/api/v1/support/tickets:
post:
operationId: createTicket
summary: Create a support ticket
tags:
- Support
security:
- apiKey: []
- oauthBearer: []
parameters:
- $ref: '#/components/parameters/SupportIdempotencyKey'
requestBody:
required: true
description: Ticket subject and message body.
content:
application/json:
schema:
type: object
required:
- subject
- body
properties:
subject:
type: string
minLength: 1
maxLength: 500
pattern: .*\S.*
example: Cannot connect X account
body:
type: string
minLength: 1
maxLength: 10000
pattern: .*\S.*
title: TicketContent
example: I am unable to connect my X account. Please help.
example:
subject: Cannot connect X account
body: I am unable to connect my X account. Please help.
multipart/form-data:
example:
subject: Cannot connect X account
body: I am unable to connect my X account.
attachments:
- screen.png
schema:
type: object
required:
- subject
anyOf:
- required:
- body
- required:
- attachments
properties:
subject:
type: string
minLength: 1
maxLength: 500
pattern: .*\S.*
example: Cannot connect X account
body:
type: string
minLength: 1
maxLength: 10000
pattern: .*\S.*
example: I am unable to connect my X account.
attachments:
type: array
minItems: 1
maxItems: 4
example:
- screen.png
items:
type: string
format: binary
responses:
'200':
description: Original ticket replayed after a safe retry
headers:
Idempotency-Replayed:
description: Present as true when replaying the same request.
schema:
type: string
const: 'true'
content:
application/json:
schema:
type: object
required:
- publicId
- attachments
properties:
publicId:
type: string
example: tkt_a1b2c3d4e5f6a1b2c3d4e5f6
attachments:
type: array
example: []
items:
$ref: '#/components/schemas/SupportAttachmentReceipt'
example:
publicId: tkt_a1b2c3d4e5f6a1b2c3d4e5f6
attachments: []
'201':
description: Ticket created
content:
application/json:
schema:
type: object
required:
- publicId
- attachments
properties:
publicId:
type: string
example: tkt_a1b2c3d4e5f6a1b2c3d4e5f6
attachments:
type: array
example: []
items:
$ref: '#/components/schemas/SupportAttachmentReceipt'
example:
publicId: tkt_a1b2c3d4e5f6a1b2c3d4e5f6
attachments: []
'400':
$ref: '#/components/responses/InvalidInput'
'401':
$ref: '#/components/responses/Unauthenticated'
'409':
description: Idempotency-Key was reused with different content.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: idempotency_key_conflict
message: Reuse this Idempotency-Key only with the original request.
'429':
$ref: '#/components/responses/RateLimitExceeded'
default:
content:
application/json:
example:
error: internal_error
message: Unexpected error. Try again.
schema:
$ref: '#/components/schemas/Error'
description: Unexpected error.
description: Create a support ticket.
get:
operationId: listTickets
summary: List user's support tickets
tags:
- Support
security:
- apiKey: []
- oauthBearer: []
responses:
'200':
description: List of tickets
content:
application/json:
schema:
type: object
required:
- tickets
properties:
tickets:
type: array
items:
type: object
required:
- publicId
- subject
- status
- messageCount
- createdAt
- updatedAt
properties:
publicId:
type: string
example: tkt_a1b2c3d4e5f6a1b2c3d4e5f6
subject:
type: string
example: Cannot connect X account
status:
type: string
enum:
- open
- in_progress
- resolved
- closed
example: open
messageCount:
type: integer
minimum: 1
example: 2
createdAt:
type: string
format: date-time
example: '2025-01-15T12:00:00Z'
updatedAt:
type: string
format: date-time
example: '2025-01-16T09:30:00Z'
example:
- publicId: tkt_a1b2c3d4e5f6a1b2c3d4e5f6
subject: Cannot connect X account
status: open
messageCount: 2
createdAt: '2025-01-15T12:00:00Z'
updatedAt: '2025-01-16T09:30:00Z'
example:
tickets:
- publicId: tkt_a1b2c3d4e5f6a1b2c3d4e5f6
subject: Cannot connect X account
status: open
messageCount: 2
createdAt: '2025-01-15T12:00:00Z'
updatedAt: '2025-01-16T09:30:00Z'
'401':
$ref: '#/components/responses/Unauthenticated'
'429':
$ref: '#/components/responses/RateLimitExceeded'
default:
content:
application/json:
example:
error: internal_error
message: Unexpected error. Try again.
schema:
$ref: '#/components/schemas/Error'
description: Unexpected error.
description: List user's support tickets.
/api/v1/support/tickets/{id}:
get:
operationId: getTicket
summary: Get ticket with all messages
tags:
- Support
security:
- apiKey: []
- oauthBearer: []
parameters:
- name: id
in: path
required: true
schema:
type: string
description: Support ticket public ID
example: tkt_a1b2c3d4e5f6a1b2c3d4e5f6
responses:
'200':
description: Ticket detail
content:
application/json:
schema:
type: object
required:
- publicId
- subject
- status
- createdAt
- updatedAt
- messages
properties:
publicId:
type: string
example: tkt_a1b2c3d4e5f6a1b2c3d4e5f6
subject:
type: string
example: Cannot connect X account
status:
type: string
enum:
- open
- in_progress
- resolved
- closed
example: open
createdAt:
type: string
format: date-time
example: '2025-01-15T12:00:00Z'
updatedAt:
type: string
format: date-time
example: '2025-01-16T09:30:00Z'
messages:
type: array
items:
type: object
required:
- body
- sender
- createdAt
- attachments
properties:
body:
type: string
example: I am unable to connect my X account.
sender:
type: string
enum:
- user
- support
- system
example: user
createdAt:
type: string
format: date-time
example: '2025-01-15T12:00:00Z'
attachments:
type: array
items:
$ref: '#/components/schemas/SupportAttachment'
example:
- body: I am unable to connect my X account.
sender: user
createdAt: '2025-01-15T12:00:00Z'
attachments: []
example:
publicId: tkt_a1b2c3d4e5f6a1b2c3d4e5f6
subject: Cannot connect X account
status: open
createdAt: '2025-01-15T12:00:00Z'
updatedAt: '2025-01-16T09:30:00Z'
messages:
- body: I am unable to connect my X account.
sender: user
createdAt: '2025-01-15T12:00:00Z'
attachments: []
'401':
$ref: '#/components/responses/Unauthenticated'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimitExceeded'
default:
content:
application/json:
example:
error: internal_error
message: Unexpected error. Try again.
schema:
$ref: '#/components/schemas/Error'
description: Unexpected error.
description: Get ticket with all messages.
patch:
operationId: updateTicketStatus
summary: Update ticket status
tags:
- Support
security:
- apiKey: []
- oauthBearer: []
parameters:
- name: id
in: path
required: true
schema:
type: string
description: Support ticket public ID to update
example: tkt_a1b2c3d4e5f6a1b2c3d4e5f6
requestBody:
required: true
description: New ticket status (open, resolved, or closed).
content:
application/json:
schema:
type: object
required:
- status
properties:
status:
type: string
enum:
- open
- resolved
- closed
example: resolved
example:
status: resolved
responses:
'200':
description: Status updated
content:
application/json:
schema:
type: object
required:
- publicId
- status
properties:
publicId:
type: string
example: tkt_a1b2c3d4e5f6a1b2c3d4e5f6
status:
type: string
enum:
- open
- resolved
- closed
example: resolved
example:
publicId: tkt_a1b2c3d4e5f6a1b2c3d4e5f6
status: resolved
'400':
$ref: '#/components/responses/InvalidInput'
'401':
$ref: '#/components/responses/Unauthenticated'
'404':
$ref: '#/components/responses/NotFound'
'429':
$ref: '#/components/responses/RateLimitExceeded'
default:
content:
application/json:
example:
error: internal_error
message: Unexpected error. Try again.
schema:
$ref: '#/components/schemas/Error'
description: Unexpected error.
description: Update ticket status.
/api/v1/support/tickets/{id}/messages:
post:
operationId: addTicketMessage
summary: Reply to a support ticket
tags:
- Support
security:
- apiKey: []
- oauthBearer: []
parameters:
- name: id
in: path
required: true
schema:
type: string
description: Support ticket public ID for the reply
example: tkt_a1b2c3d4e5f6a1b2c3d4e5f6
- $ref: '#/components/parameters/SupportIdempotencyKey'
requestBody:
required: true
description: Reply message body (max 10,000 characters).
content:
application/json:
schema:
type: object
required:
- body
properties:
body:
type: string
minLength: 1
maxLength: 10000
pattern: .*\S.*
title: MessageContent
example: Thank you for the update.
example:
body: Thank you for the update.
multipart/form-data:
example:
body: Thank you for the update.
attachments:
- details.png
schema:
type: object
anyOf:
- required:
- body
- required:
- attachments
properties:
body:
type: string
minLength: 1
maxLength: 10000
pattern: .*\S.*
example: Thank you for the update.
attachments:
type: array
minItems: 1
maxItems: 4
example:
- details.png
items:
type: string
format: binary
responses:
'200':
description: Original message replayed after a safe retry
headers:
Idempotency-Replayed:
description: Set to true when this message replays.
schema:
type: string
const: 'true'
content:
application/json:
schema:
type: object
required:
- publicId
- attachments
properties:
publicId:
type: string
example: tkt_a1b2c3d4e5f6a1b2c3d4e5f6
attachments:
type: array
example: []
items:
$ref: '#/components/schemas/SupportAttachmentReceipt'
example:
publicId: tkt_a1b2c3d4e5f6a1b2c3d4e5f6
attachments: []
'201':
description: Message added
content:
application/json:
schema:
type: object
required:
- publicId
- attachments
properties:
publicId:
type: string
example: tkt_a1b2c3d4e5f6a1b2c3d4e5f6
attachments:
type: array
example: []
items:
$ref: '#/components/schemas/SupportAttachmentReceipt'
example:
publicId: tkt_a1b2c3d4e5f6a1b2c3d4e5f6
attachments: []
'400':
$ref: '#/components/responses/InvalidInput'
'401':
$ref: '#/components/responses/Unauthenticated'
'404':
$ref: '#/components/responses/NotFound'
'409':
description: Reply key was reused with different message content.
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
example:
error: idempotency_key_conflict
message: Reuse this Idempotency-Key only with the original request.
'429':
$ref: '#/components/responses/RateLimitExceeded'
default:
content:
application/json:
example:
error: internal_error
message: Unexpected error. Try again.
schema:
$ref: '#/components/schemas/Error'
description: Unexpected error.
description: Reply to a support ticket.
components:
schemas:
SupportAttachment:
description: Downloadable image or video attached to a support message.
type: object
required:
- publicId
- filename
- contentType
- kind
- sizeBytes
- status
- url
properties:
publicId:
type: string
example: att_a1b2c3d4e5f6a1b2c3d4e5f6
filename:
type: string
example: screen.png
contentType:
type: string
description: Validated media type.
enum:
- image/jpeg
- image/png
- image/gif
- image/webp
- video/mp4
- video/quicktime
- video/webm
kind:
type: string
description: Attachment media class.
enum:
- image
- video
example: image
sizeBytes:
type: integer
format: int64
example: 204800
status:
type: string
description: Storage processing state.
enum:
- pending
- ready
- failed
example: ready
url:
type: string
example: /api/v1/support/attachments/att_a1b2c3d4e5f6a1b2c3d4e5f6
Error:
description: 'Error response. Default v1 returns a legacy string error code. Send `xquik-api-contract: 2026-04-29` to receive the structured best-practice error object.
'
type: object
required:
- error
properties:
error:
x-stainless-naming:
python:
type_name: ErrorValue
java:
type_name: ErrorValue
example: invalid_input
oneOf:
- type: string
title: LegacyErrorCode
enum:
- internal_error
- account_already_connected
- account_needs_reauth
- account_not_found
- account_required
- account_restricted
- api_key_limit_reached
- article_not_found
- dm_not_permitted
- invalid_format
- invalid_id
- invalid_input
- invalid_params
- invalid_tool_type
- invalid_tweet_id
- invalid_tweet_url
- invalid_user_id
- invalid_user_ids
- invalid_username
- invalid_json
- insufficient_credits
- login_cooldown
- login_failed
- media_download_failed
- missing_params
- missing_query
- monitor_already_exists
- no_media
- no_credits
- no_subscription
- not_found
- payment_failed
- rate_limit_exceeded
- service_unavailable
- style_not_found
- subscription_inactive
- tweet_not_found
- unauthenticated
- unsupported_field
- user_not_found
- body_too_large
- checkout_unavailable
- connection_challenge_expired
- connection_challenge_inactive
- draft_not_found
- favoriters_unavailable
- forbidden
- guest_wallet_unavailable
- guest_wallets_disabled
- guest_wallets_unavailable
- idempotency_conflict
- idempotency_key_conflict
- invalid_community_id
- invalid_idempotency_key
- invalid_list_id
- invalid_payment_amount
- invalid_range
- login_rate_limited
- missing_idempotency_key
- missing_ids
- no_cached_style
- passkey_required
- rate_limited
- read_request_timeout
- replies_incomplete
- support_media_rate_limit
- support_request_rate_limit
- too_many_ids
- unknown_field
- unsupported_media_type
- webhook_inactive
- write_tracking_unavailable
- x_write_unconfirmed
- x_account_feature_required
- x_account_protected
- x_account_suspended
- x_api_rate_limited
- x_api_unavailable
- x_api_unauthorized
- x_auth_failure
- x_content_too_long
- x_daily_limit
- x_dm_not_allowed
- x_duplicate_action
- x_login_auth_failed
- x_login_challenge
- x_login_denied
- x_login_failed
- x_login_proxy_error
- x_login_rate_limited
- x_login_service_unavailable
- x_login_suspended
- x_rate_limited
- x_rejected
- x_target_not_found
- x_transient_error
- x_user_lookup_failed
- x_write_ambiguous
- x_write_failed
example: invalid_input
- type: object
title: StructuredError
required:
- message
- type
- code
properties:
message:
type: string
example: Invalid input. Check the request body.
type:
type: string
enum:
- api_error
- authentication_error
- billing_error
- dependency_error
- invalid_request_error
- permission_error
- rate_limit_error
example: invalid_request_error
code:
type: string
title: ErrorCode
enum:
- internal_error
- account_already_connected
- account_needs_reauth
- account_not_found
- account_required
- account_restricted
- api_key_limit_reached
- article_not_found
- dm_not_permitted
- invalid_format
- invalid_id
- invalid_input
- invalid_params
- invalid_tool_type
- invalid_tweet_id
- invalid_tweet_url
- invalid_user_id
- invalid_user_ids
- invalid_username
- invalid_json
- insufficient_credits
- login_cooldown
- login_failed
- media_downlo
# --- truncated at 32 KB (38 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/xquik-api/refs/heads/main/openapi/xquik-api-support-api-openapi.yml