Facebook Account Checker & Intelligence API

An enterprise-grade OSINT API to verify Facebook account existence and extract rich profile intelligence (numerical User IDs, HD avatar photos, custom avatar indicators, profile URLs, and Meta Accounts Center linked accounts) by email address, username, or phone number.

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 personal and professional Facebook profiles.
✅ Multi-Identifier Input: Query using email addresses, usernames, and E.164 phone numbers.
✅ Deep Metadata Extraction: Returns numerical User IDs, full display names, HD profile picture URLs, custom avatar flags, direct profile URLs, and Meta Accounts Center linked identities.
✅ 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 Facebook Checker.
• RapidAPI: Subscribe via RapidAPI Facebook 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/facebook
API.Market	https://prod.api.market/api/v1/osint-trace-1/facebook-checker	X-Api-Key: YOUR_API_KEY	POST /check/facebook
RapidAPI	https://facebook-checker.p.rapidapi.com	X-RapidAPI-Key: YOUR_API_KEY X-RapidAPI-Host: facebook-checker.p.rapidapi.com	POST /check

---

API Endpoints

Single Account Check

Endpoint (OSINT Trace Direct - Recommended):

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

Request Body:

{
  "input": "target@example.com"
}

Code Examples

OSINT Trace Direct API (cURL) — Recommended

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

API.Market (cURL)

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

RapidAPI (cURL)

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

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": {
    "name": "Jane Doe",
    "user_id": "100012345678901",
    "avatar_url": "https://scontent.xx.fbcdn.net/v/t39.30808-1/example_avatar.jpg",
    "has_custom_avatar": true,
    "profile_url": "https://www.facebook.com/janedoe",
    "linked_accounts": [
      {
        "name": "janedoe_ig",
        "avatar_url": "https://scontent.cdninstagram.com/v/t51.2885-19/example_ig.jpg",
        "account_type": "Instagram"
      }
    ]
  }
}

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:
  • Email addresses (user@example.com)
  • Usernames (john.doe.official)
  • Phone numbers (E.164 standard recommended: +1234567890)
• 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, compliance auditing, and threat intelligence. Users must:

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

This service is independently operated by OSINT Trace and is not affiliated with or endorsed by Meta Platforms, Inc.