X (Twitter) Account Checker & Intelligence API

An enterprise-grade OSINT API to verify X (formerly Twitter) account existence and retrieve rich profile intelligence (account creation date, follower/following statistics, biography, avatar photos, verification badges, custom avatar flags, and direct profile URLs) by username or email address.

Table of Contents

• Features
• Getting Started
  • 1. Get API Key
  • 2. Base URL & Authentication
• API Endpoints
  • Single Account Check
  • Code Examples
• Response Format
• HTTP Status Codes
• Requirements
• Pricing
• Support
• Legal Compliance

---

Features

✅ Instant Verification: Real-time presence verification for X / Twitter profiles.
✅ Multi-Identifier Input: Query using usernames or email addresses.
✅ Deep Metadata Extraction: Returns display names, handles, biographies, follower & following counts, account creation date (created_at), verified status badges, custom avatar indicators, and profile URLs.
✅ High Performance: Asynchronous architecture with high-speed proxy cycling and anti-bot bypass.
✅ Developer-Friendly: Available via direct REST API on OSINT Trace (Recommended) and major developer marketplaces.

---

Getting Started

1. Get API Key

• OSINT Trace Direct (Recommended): Create an account on OSINT Trace and generate your API Key from the Workspace Dashboard.
• API.Market: Subscribe via API.Market X Checker.
• RapidAPI: Subscribe via RapidAPI X Checker.

2. Base URL & Authentication

Authentication headers and endpoints vary by provider:

Provider	Base URL	Auth Header	Endpoint
OSINT Trace (Direct - Recommended)	https://api.osinttrace.com/v1	x-osint-key: YOUR_OSINT_KEY	POST /check/x
API.Market	https://prod.api.market/api/v1/osint-trace-1/x-checker	X-Api-Key: YOUR_API_KEY	POST /check/x
RapidAPI	https://x-checker.p.rapidapi.com	X-RapidAPI-Key: YOUR_API_KEY X-RapidAPI-Host: x-checker.p.rapidapi.com	POST /check

---

API Endpoints

Single Account Check

Endpoint (OSINT Trace Direct - Recommended):

POST https://api.osinttrace.com/v1/check/x

Request Body:

{
  "input": "target_handle"
}

Code Examples

OSINT Trace Direct API (cURL) — Recommended

curl --request POST \
     --url https://api.osinttrace.com/v1/check/x \
     --header 'x-osint-key: YOUR_OSINT_KEY' \
     --header 'Content-Type: application/json' \
     --data '{"input": "target_handle"}'

API.Market (cURL)

curl --request POST \
     --url https://prod.api.market/api/v1/osint-trace-1/x-checker/check/x \
     --header 'X-Api-Key: YOUR_API_KEY' \
     --header 'Content-Type: application/json' \
     --data '{"input": "target_handle"}'

RapidAPI (cURL)

curl --request POST \
     --url https://x-checker.p.rapidapi.com/check \
     --header 'X-RapidAPI-Host: x-checker.p.rapidapi.com' \
     --header 'X-RapidAPI-Key: YOUR_API_KEY' \
     --header 'Content-Type: application/json' \
     --data '{"input": "target_handle"}'

Additional code snippets for Python, Node.js, Go, PHP, C#, Java, and Shell are available in the examples/ directory.

---

Response Format

Account Found (With Metadata)

{
  "live": true,
  "note": null,
  "metadata": {
    "username": "osint_specialist",
    "name": "Jane Analyst",
    "bio": "Threat intelligence, digital forensics, and cybersecurity research 🛡️",
    "avatar_url": "https://pbs.twimg.com/profile_images/example_avatar.jpg",
    "followers": 5820,
    "following": 410,
    "created_at": "2018-04-12T10:15:00Z",
    "is_verified": true,
    "has_custom_avatar": true,
    "profile_url": "https://x.com/osint_specialist"
  }
}

Account Not Found

{
  "live": false,
  "note": null,
  "metadata": null
}

---

HTTP Status Codes

Status Code	Description	Rationale
200 OK	Success	Query processed and presence/metadata returned.
400 Bad Request	Validation Error	Malformed request body or input under minimum length.
401 Unauthorized	Authentication Required	Missing, invalid, or expired API key header.
403 Forbidden	Quota / Subscription Error	Quota balance exhausted or subscription inactive.
408 Request Timeout	Timeout	Upstream verification exceeded maximum execution window.
429 Too Many Requests	Rate Limit Exceeded	Exceeded 1 request/second limit.

---

Requirements

• Minimum input length: 3 characters
• Supported input formats:
  • Usernames / handles (target_handle)
  • Email addresses (user@example.com)
• Rate Limit: 1 request per second per active API key.

---

Pricing

• Direct Plans (Recommended): Flexible subscription tiers and bulk volume pricing available on OSINT Trace Pricing.
• Marketplace Plans: Subscriptions also available through API.Market and RapidAPI.
• Free Tier: Free tier available for evaluation and testing.

---

Support

For technical inquiries, enterprise SLA plans, or integration assistance:
📧 Email: support@osinttrace.com
🌐 Website: osinttrace.com

---

Legal Compliance

This API is designed for legitimate cybersecurity investigation, fraud prevention, brand safety, and threat intelligence. Users must:

• Comply with applicable local and international data protection regulations (e.g., GDPR, CCPA).
• Adhere to X's Terms of Service and developer guidelines.
• Ensure lawful basis for investigative data processing.

This service is independently operated by OSINT Trace and is not affiliated with or endorsed by X Corp.