flowxapi overview

The high-performance, developer-first REST API for X (formerly Twitter) data and automation. 73 production endpoints, transparent micro-dollar metering, real-time push webhooks, and official Python & TypeScript client SDKs.

73 production endpoints From $0.001 / request ~180ms standard latency Proxy rotation Real-time webhooks No X developer account required

Instant API keys

Generate a Bearer key instantly. No application forms, delays, or enterprise contracts.

Interactive playground

Execute requests live in your browser, inspect headers and payloads, and export ready-to-run code.

Micro-dollar metering

Pay only for the data you query from $0.001. Clear pay-per-use economics.

Real-time webhooks

Push new tweets from target profiles directly into your server within seconds. Zero polling needed.

Quickstart (30 Seconds)

Query user profiles, fetch recent tweets, or search conversations in seconds using standard HTTP tools or official SDKs.

curl -X GET "https://api.flowxapi.dev/v1/twitter/user/info?username=NASA" \
  -H "Authorization: Bearer fxa_your_api_key"

import { FlowX } from '@flowxapi/sdk';

const client = new FlowX({
  apiKey: 'fxa_your_api_key'
});

// Fetch NASA user profile info
const user = await client.getUser('NASA');
console.log(`Followers: ${user.followers_count}`);

from flowxapi import FlowX

client = FlowX(api_key="fxa_your_api_key")

# Fetch NASA user profile info
user = client.get_user("NASA")
print(f"Followers: {user['followers_count']}")

{
  "ok": true,
  "data": {
    "id": "11348282",
    "username": "NASA",
    "name": "NASA",
    "description": "There's space for everybody.",
    "followers_count": 80450120,
    "following_count": 312,
    "tweet_count": 74920,
    "verified": true,
    "profile_image_url": "https://pbs.twimg.com/profile_images/.../nasa.jpg"
  }
}

Authentication

All requests to /v1/* require an API key passed in the standard HTTP Authorization header:

Authorization: Bearer fxa_live_948f2b10a8c2...

API keys are prefixed with fxa_ and can be generated, labeled, or revoked anytime from your Developer Dashboard.

Transparent Micro-Dollar Metering

flowxapi charges exactly per call in micro-dollars ($0.000001 USD). No recurring monthly commitments are forced upon developers.

Operation	Endpoint Category	Cost (Micros)	Cost (USD)
User Info / Profile	`GET /v1/twitter/user/info`	1,000 micros	$0.001
User Tweets & Media	`GET /v1/twitter/user/tweets`	2,000 micros	$0.002
Advanced Search	`GET /v1/twitter/tweet/advanced_search`	5,000 micros	$0.005
Followers / Following	`GET /v1/twitter/user/followers`	5,000 micros	$0.005
Direct Messages	`POST /v1/twitter/dm/send`	5,000 micros	$0.005
Real-Time Webhooks	`POST /v1/twitter/monitor/add`	0 micros	Included

Core Endpoints Directory (73 Available)

Filter and explore live production routes. Click any endpoint to test it instantly in the Request Playground.

GET /v1/twitter/user/info Fetch full profile metrics, bio, avatar, and counts by username

$0.001 Playground →

GET /v1/twitter/user/tweets Retrieve latest tweets, retweets, and impressions for any handle

$0.002 Playground →

GET /v1/twitter/tweet/advanced_search Execute complex boolean queries, sentiment filters, and date ranges

$0.005 Playground →

GET /v1/twitter/tweet/detail Inspect conversation tree, media URLs, view counts, and quotes

$0.001 Playground →

GET /v1/twitter/tweet/replies Extract all public replies and parent context under a tweet

$0.002 Playground →

GET /v1/twitter/user/followers Paginated extraction of follower list with cursor resume tokens

$0.005 Playground →

POST /v1/twitter/monitor/add Register an account handle for real-time webhook push delivery

Included Playground →

Official Client SDKs

Official typed clients provide auto-pagination, automatic token refresh, retries with exponential backoff, and transparent rate-limit headers handling.

TypeScript / Node.js

v1.0.0

Fully typed definitions, ESM & CommonJS support, native fetch runtime.

npm install @flowxapi/sdk

Python SDK

v1.0.0

Async/await support, Pydantic models, rate-limit backoff handler.

pip install flowxapi

Response Envelope & Error Codes

Every response returns a structured envelope. Successful queries return ok: true, while errors return standardized machine-readable error codes.

Standard Error Envelope (HTTP 429)

{
  "ok": false,
  "error": {
    "code": "RATE_LIMITED",
    "message": "Rate limit exceeded. Try again in 12 seconds.",
    "retry_after": 12
  }
}

Code	Meaning	What to do
`400 Bad Request`	Missing or invalid query/body parameters	Verify required parameters against the endpoint schema and check parameter formatting.
`401 Unauthorized`	Missing, malformed, or revoked API key	Supply a valid `Authorization: Bearer fxa_...` header generated from the Console.
`402 Payment Required`	Zero credit balance or exhausted account funds	Top up your developer balance or subscribe to a monthly plan in Billing.
`429 Too Many Requests`	Operation rate limit or concurrency cap reached	Inspect the `retry_after` response header and back off before repeating the request.
`503 Service Unavailable`	Upstream network or rotation pool temporary disruption	Retry with exponential backoff. flowxapi auto-rotates active upstream sessions.