Facebook Checker

# Facebook Profile & Account Intelligence Checker API ## ⚡ 100% Real-Time Live Intelligence (Zero Stale Databases) The **Facebook Checker API** delivers high-speed, real-time account verification across Facebook. It verifies whether an identifier (email address, phone number in E.164 format, or vanity username) is registered to an active Facebook profile. When available, it extracts rich profile metadata including numerical Facebook Profile IDs, high-resolution profile picture URLs, custom avatar flags, and linked Instagram account IDs. > [!IMPORTANT] > **Real-Time Verification Guarantee:** Every query executes live protocol probes directly against Facebook services. We **never** rely on cached dumps, leaked records, or stale third-party databases. For direct web access, multi-platform OSINT scans, and high-volume enterprise investigations, visit **[OSINT Trace](https://osinttrace.com)** at [https://osinttrace.com](https://osinttrace.com). --- ## 🔗 Quick Links - **Official Web Platform**: [OSINT Trace — https://osinttrace.com](https://osinttrace.com) - **API Dashboard & Studio**: [Jojapi Studio](https://jojapi.com) --- ## ⚡ Key Features - ✅ **Multi-Identifier Support:** Query by email address (`[email protected]`), international phone number (`+14155552671`), or vanity username (`zuck`). - 🆔 **Numerical Profile ID Extraction:** Returns exact Facebook numerical user IDs (`profile_id`) when resolved. - 🖼️ **Avatar Picture & Profile Media:** Extracts high-resolution profile image URLs (`photo_url`) and custom avatar status (`is_custom_photo`). - 🔗 **Cross-Platform Correlation:** Detects linked Instagram user identifiers (`linked_instagram_id`). - ⚡ **Sub-Second Response Times:** Asynchronous distributed worker pool built for high-throughput enterprise workloads. --- ## ⚠️ Input Types & Metadata Availability > [!NOTE] > - **Input Format:** Accepts standard email addresses (`[email protected]`), E.164 phone numbers (`+14155552671`), or Facebook vanity profile handles (`username`). > - **Metadata Availability:** Rich metadata (Profile IDs, avatars, linked Instagram handles) is extracted based on the target account's public privacy settings and input type. --- ## 🎯 Target Use Cases 1. **Fraud Prevention & Sybil Defense:** Verify identity claims and validate the existence of legitimate social profiles during signup or checkout. 2. **Lead Enrichment & Social Verification:** Enrich customer contact lists with verified Facebook profile data and avatars. 3. **OSINT & Cybersecurity Investigations:** Correlate suspect emails, usernames, and phone numbers with active Facebook accounts during forensic investigations. 4. **Account Recovery & Trust & Safety:** Verify customer identity against social profile footprints. --- ## 💻 Visual Examples & Payload Schemas ### Endpoint `POST /check` ### Request Body ```json { "input": "[email protected]" } ``` ### Response Example: Registered Facebook Account (`200 OK`) ```json { "live": true, "metadata": { "profile_id": "100012345678901", "photo_url": "https://scontent.xx.fbcdn.net/v/t39.30808-1/...", "is_custom_photo": true, "linked_instagram_id": "98765432100", "profile_url": "https://facebook.com/100012345678901" } } ``` ### Response Example: Unregistered Identifier (`200 OK`) ```json { "live": false } ``` --- ## 🚀 Implementation Guide ### cURL ```bash curl -X POST \ 'https://facebook-checker.jojapi.com/check' \ -H 'Content-Type: application/json' \ -H 'x-api-key: YOUR_JOJAPI_KEY' \ -d '{"input": "[email protected]"}' ``` ### Python (`requests`) ```python import requests API_KEY = "YOUR_JOJAPI_KEY" URL = "https://facebook-checker.jojapi.com/check" def check_facebook(identifier: str): headers = { "Content-Type": "application/json", "x-api-key": API_KEY } payload = {"input": identifier} response = requests.post(URL, headers=headers, json=payload) if response.status_code == 200: data = response.json() print(f"Active on Facebook: {data.get('live')}") if data.get("metadata"): meta = data["metadata"] print(f"Profile ID: {meta.get('profile_id')}") print(f"Photo URL: {meta.get('photo_url')}") print(f"Custom Avatar: {meta.get('is_custom_photo')}") print(f"Linked Instagram ID: {meta.get('linked_instagram_id')}") return data else: print(f"Error {response.status_code}: {response.text}") return None check_facebook("[email protected]") ``` ### JavaScript / Node.js (`fetch`) ```javascript const API_KEY = "YOUR_JOJAPI_KEY"; const URL = "https://facebook-checker.jojapi.com/check"; async function checkFacebook(identifier) { const response = await fetch(URL, { method: "POST", headers: { "Content-Type": "application/json", "x-api-key": API_KEY }, body: JSON.stringify({ input: identifier }) }); if (!response.ok) { throw new Error(`HTTP error! status: ${response.status}`); } const data = await response.json(); console.log("Facebook Scan Result:", data); return data; } checkFacebook("[email protected]"); ``` --- ## 🚦 Status Codes & Error Reference | Status Code | Reason | Description | |:---|:---|:---| | **`200 OK`** | Success | Query completed. Returns registration status and Facebook metadata. | | **`400 Bad Request`** | Validation Error | Malformed input or missing request body. | | **`401 Unauthorized`** | Auth Failure | Missing or invalid `x-api-key` header. | | **`403 Forbidden`** | Quota Exceeded | Monthly subscription quota exhausted. Upgrade your plan. | | **`429 Too Many Requests`** | Rate Limit | Exceeded allowable requests/second (1 req/s). | | **`500 / 503`** | Service Error | Upstream gateway temporary issue. Retry with exponential backoff. | --- ## ❓ Frequently Asked Questions **Q: Can I search by phone number or username?** A: Yes! The endpoint supports email addresses, E.164 international phone numbers (`+14155552671`), and Facebook vanity profile usernames. **Q: Where can I run multi-platform OSINT scans or bulk CSV searches?** A: Visit **[OSINT Trace](https://osinttrace.com)** (`https://osinttrace.com`) for the full unified web workspace, bulk CSV processor, and downloadable intelligence reports.