Referência detalhada da API e guia de uso
Check your account service status, current credit balance, plan, monthly usage, and live rate-limit counters. Authenticate with X-API-Key or a Bearer token.
This excerpt highlights the key fields. Live responses may include additional raw Twitter/X fields.
{
"code": 200,
"msg": "success",
"data": {
"service": "ok",
"account_status": "active",
"credits": 2400.5,
"plan": "Ultra",
"plan_key": "ultra",
"active_until": "2026-08-01T00:00:00+00:00",
"rate_limit_per_second": 100,
"rate_limit_per_hour": null,
"rps_current": 2,
"rph_current": 12,
"monthly_limit": 50000,
"month_calls": 1234,
"monthly_remaining": 48766,
"quota_period_start": "2026-07-01T00:00:00+00:00"
}
}| 字段 | 类型 | 说明 |
|---|---|---|
| code | number | Business status code. 200 means the request succeeded. |
| msg | string | Response message. |
| data | object | Response data object. |
| service | string | Service availability flag inside the data object. ok means the API service is healthy. |
| account_status | string | Account status inside the data object, for example active. |
| credits | number | Current credit balance inside the data object. |
| plan | string | Display name of the current plan inside the data object. |
| plan_key | string | null | Stable plan key inside the data object, for example ultra; may be null when no plan is active. |
| active_until | string | null | Plan expiration time inside the data object in ISO 8601 format; null when not applicable. |
| rate_limit_per_second | number | null | Allowed requests per second inside the data object; null when not configured. |
| rate_limit_per_hour | number | null | Allowed requests per hour inside the data object; null when not configured. |
| rps_current | number | Requests used in the current per-second window inside the data object. |
| rph_current | number | Requests used in the current per-hour window inside the data object. |
| monthly_limit | number | Monthly request quota for the current plan inside the data object. |
| month_calls | number | Requests used in the current quota period inside the data object. |
| monthly_remaining | number | null | Requests remaining in the current quota period inside the data object; null when there is no fixed monthly cap. |
| quota_period_start | string | Start time of the current quota period inside the data object in ISO 8601 format. |
Common business error codes returned by the backend. All APIs use the unified response format: { code, msg, data }.
Note: `code` is the business status code in response body and may differ from HTTP status.
| Code | Name | Description | Recommendation |
|---|---|---|---|
| 200 | Success | Request processed successfully. | Use `data` for business payload. |
| 400 | Bad Request | Invalid parameters or business validation failed. | Check required fields, value ranges, and request format. |
| 401 | Unauthorized | Authentication failed (login required, missing/invalid API key). | Re-login or provide a valid `X-API-Key`. |
| 402 | Insufficient Balance | Insufficient balance or call quota for this request. | Recharge or upgrade your plan and retry. |
| 403 | Forbidden | You do not have permission or account status is restricted. | Check account status and endpoint permission. |
| 404 | Not Found | Requested resource does not exist. | Verify IDs/order numbers and whether data exists. |
| 429 | Rate Limit Exceeded | Request frequency exceeded per-second/per-hour/monthly limits. | Use retry with backoff or lower request frequency. |
| 500 | Internal Server Error | Server-side processing failed. | Retry later and contact support if it persists. |
| 502 | Service Temporarily Unavailable | The service request failed to be processed. | Please try again later. |
| 503 | Service Busy | System is busy or global protection limit is triggered. | Retry after a short wait. |
From docs to a live request
Account Status shows credits, plan, monthly usage, and live rate-limit counters. Response Fields help you see what n8n, Sheets, alerts, or AI workflows will receive before you wire the endpoint into production.
curl -X GET "https://www.twtapi.com/api-proxy/myapi/status?lang=pt" \ -H "X-API-Key: YOUR_API_KEY" \ -H "X-Lang: pt"
If you do not have an API key yet, start by creating an account or opening the API dashboard to check your current plan, quota, and key-management entry points.