[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"api-page:facebook-checker":3},{"status":4,"api":5,"seo":133},"success",{"blocked":6,"description":7,"about":8,"stats":9,"name":11,"title":12,"slug":13,"logo":14,"created_at":15,"agent":16,"user":28,"endpoint_groups":32,"faqs":75,"features":91,"periodic_plans":92,"payasyougo_plans":130,"releases":131,"last_updated":132},false,"Verify Facebook accounts by email, phone, or username. Extract numerical Profile IDs, avatar images, custom photo flags, and linked Instagram accounts.","# Facebook Profile & Account Intelligence Checker API\n\n## ⚡ 100% Real-Time Live Intelligence (Zero Stale Databases)\n\nThe **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.\n\n> [!IMPORTANT]\n> **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.\n\nFor 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).\n\n---\n\n## 🔗 Quick Links\n- **Official Web Platform**: [OSINT Trace — https://osinttrace.com](https://osinttrace.com)\n- **API Dashboard & Studio**: [Jojapi Studio](https://jojapi.com)\n\n---\n\n## ⚡ Key Features\n\n- ✅ **Multi-Identifier Support:** Query by email address (`user@example.com`), international phone number (`+14155552671`), or vanity username (`zuck`).\n- 🆔 **Numerical Profile ID Extraction:** Returns exact Facebook numerical user IDs (`profile_id`) when resolved.\n- 🖼️ **Avatar Picture & Profile Media:** Extracts high-resolution profile image URLs (`photo_url`) and custom avatar status (`is_custom_photo`).\n- 🔗 **Cross-Platform Correlation:** Detects linked Instagram user identifiers (`linked_instagram_id`).\n- ⚡ **Sub-Second Response Times:** Asynchronous distributed worker pool built for high-throughput enterprise workloads.\n\n---\n\n## ⚠️ Input Types & Metadata Availability\n\n> [!NOTE]\n> - **Input Format:** Accepts standard email addresses (`user@domain.com`), E.164 phone numbers (`+14155552671`), or Facebook vanity profile handles (`username`).\n> - **Metadata Availability:** Rich metadata (Profile IDs, avatars, linked Instagram handles) is extracted based on the target account's public privacy settings and input type.\n\n---\n\n## 🎯 Target Use Cases\n\n1. **Fraud Prevention & Sybil Defense:** Verify identity claims and validate the existence of legitimate social profiles during signup or checkout.\n2. **Lead Enrichment & Social Verification:** Enrich customer contact lists with verified Facebook profile data and avatars.\n3. **OSINT & Cybersecurity Investigations:** Correlate suspect emails, usernames, and phone numbers with active Facebook accounts during forensic investigations.\n4. **Account Recovery & Trust & Safety:** Verify customer identity against social profile footprints.\n\n---\n\n## 💻 Visual Examples & Payload Schemas\n\n### Endpoint\n`POST /check`\n\n### Request Body\n```json\n{\n  \"input\": \"target_user@example.com\"\n}\n```\n\n### Response Example: Registered Facebook Account (`200 OK`)\n```json\n{\n  \"live\": true,\n  \"metadata\": {\n    \"profile_id\": \"100012345678901\",\n    \"photo_url\": \"https://scontent.xx.fbcdn.net/v/t39.30808-1/...\",\n    \"is_custom_photo\": true,\n    \"linked_instagram_id\": \"98765432100\",\n    \"profile_url\": \"https://facebook.com/100012345678901\"\n  }\n}\n```\n\n### Response Example: Unregistered Identifier (`200 OK`)\n```json\n{\n  \"live\": false\n}\n```\n\n---\n\n## 🚀 Implementation Guide\n\n### cURL\n```bash\ncurl -X POST \\\n  'https://facebook-checker.jojapi.com/check' \\\n  -H 'Content-Type: application/json' \\\n  -H 'x-api-key: YOUR_JOJAPI_KEY' \\\n  -d '{\"input\": \"target_user@example.com\"}'\n```\n\n### Python (`requests`)\n```python\nimport requests\n\nAPI_KEY = \"YOUR_JOJAPI_KEY\"\nURL = \"https://facebook-checker.jojapi.com/check\"\n\ndef check_facebook(identifier: str):\n    headers = {\n        \"Content-Type\": \"application/json\",\n        \"x-api-key\": API_KEY\n    }\n    payload = {\"input\": identifier}\n    \n    response = requests.post(URL, headers=headers, json=payload)\n    if response.status_code == 200:\n        data = response.json()\n        print(f\"Active on Facebook: {data.get('live')}\")\n        if data.get(\"metadata\"):\n            meta = data[\"metadata\"]\n            print(f\"Profile ID: {meta.get('profile_id')}\")\n            print(f\"Photo URL: {meta.get('photo_url')}\")\n            print(f\"Custom Avatar: {meta.get('is_custom_photo')}\")\n            print(f\"Linked Instagram ID: {meta.get('linked_instagram_id')}\")\n        return data\n    else:\n        print(f\"Error {response.status_code}: {response.text}\")\n        return None\n\ncheck_facebook(\"target_user@example.com\")\n```\n\n### JavaScript / Node.js (`fetch`)\n```javascript\nconst API_KEY = \"YOUR_JOJAPI_KEY\";\nconst URL = \"https://facebook-checker.jojapi.com/check\";\n\nasync function checkFacebook(identifier) {\n  const response = await fetch(URL, {\n    method: \"POST\",\n    headers: {\n      \"Content-Type\": \"application/json\",\n      \"x-api-key\": API_KEY\n    },\n    body: JSON.stringify({ input: identifier })\n  });\n\n  if (!response.ok) {\n    throw new Error(`HTTP error! status: ${response.status}`);\n  }\n\n  const data = await response.json();\n  console.log(\"Facebook Scan Result:\", data);\n  return data;\n}\n\ncheckFacebook(\"target_user@example.com\");\n```\n\n---\n\n## 🚦 Status Codes & Error Reference\n\n| Status Code | Reason | Description |\n|:---|:---|:---|\n| **`200 OK`** | Success | Query completed. Returns registration status and Facebook metadata. |\n| **`400 Bad Request`** | Validation Error | Malformed input or missing request body. |\n| **`401 Unauthorized`** | Auth Failure | Missing or invalid `x-api-key` header. |\n| **`403 Forbidden`** | Quota Exceeded | Monthly subscription quota exhausted. Upgrade your plan. |\n| **`429 Too Many Requests`** | Rate Limit | Exceeded allowable requests/second (1 req/s). |\n| **`500 / 503`** | Service Error | Upstream gateway temporary issue. Retry with exponential backoff. |\n\n---\n\n## ❓ Frequently Asked Questions\n\n**Q: Can I search by phone number or username?**  \nA: Yes! The endpoint supports email addresses, E.164 international phone numbers (`+14155552671`), and Facebook vanity profile usernames.\n\n**Q: Where can I run multi-platform OSINT scans or bulk CSV searches?**  \nA: Visit **[OSINT Trace](https://osinttrace.com)** (`https://osinttrace.com`) for the full unified web workspace, bulk CSV processor, and downloadable intelligence reports.",{"score":10},"1.92","Facebook Checker","Facebook Checker API","facebook-checker","https://cdn.jojapi.com/api/964fa85e-5175-48f1-ab91-bf2e1a627905","2026-10-08 21:09:30",{"enabled":17,"closed":18,"request_enabled":17,"catalog_url":19,"discovery_url":20,"directory_url":21,"rails":22,"networks":25,"docs":27},true,null,"https://facebook-checker.jojapi.net/_jojapi/agent/plans","https://facebook-checker.jojapi.net/.well-known/x402","https://agents.jojapi.net/apis/facebook-checker",[23,24],"x402","mpp",[26],"eip155:8453","https://docs.jojapi.com/consumers/agents",{"nick":29,"name":30,"verified":17,"website":31},"osinttrace","OSINT TRACE","https://osinttrace.com",[33],{"endpoints":34,"name":74,"description":42,"ungrouped":6},[35],{"blocked":6,"hidden":6,"agent_price":36,"credits":18,"flexible_credits_description":18,"consumptions":37,"description":43,"method":44,"name":45,"url_path":46,"root_url":47,"parameters":48,"responses":63,"result_stats":18},0.01,[38],{"name":39,"slug":40,"cost":41,"label":42,"avg":18},"Requests","requests","1","","Verify Facebook account existence by email, phone, or username. Returns live status and, when available depending on the target account and input type, numerical Profile IDs, HD profile photos, custom avatar flags, and linked Instagram accounts.","POST","Single Check","/check","https://facebook-checker.jojapi.net",{"url":49,"header":50,"post":57,"body":58,"path":62},[],[51],{"key":52,"is_auth":17,"example":53,"example_disabled":17,"example_type":54,"name":55,"description":53,"required":17,"always_error":56},"X-JoJAPI-Key","You must log in to get API key","string","JoJ API Key","Please log in to get API key",[],[59],{"key":18,"example":60,"schema":18,"example_disabled":6,"example_type":54,"value_type":54,"enum_values":18,"default_value":42,"required":6,"name":18,"description":61},"{\"input\":\"target_user@gmail.com\"}","''",[],[64,69],{"status":65,"status_code":66,"description":67,"schema":18,"examples":68,"example":42},"200",200,"Facebook account exists. Note: metadata is included when available depending on the target account itself and whether the input is an email, username, or phone.",[],{"status":70,"status_code":71,"description":72,"schema":18,"examples":73,"example":42},"422",422,"Returned when the request body is missing required fields or fails input validation.",[],"check_one_program",[76,79,82,85,88],{"question":77,"answer":78},"What input formats are supported for Facebook lookups?","You can query by email address (user@example.com), international phone number in E.164 format (+14155552671), or Facebook vanity username (e.g. zuck).",{"question":80,"answer":81},"What metadata is returned when an account is found?","When resolved, the API returns the exact numerical Facebook Profile ID (profile_id), high-resolution profile avatar URL (photo_url), custom avatar indicator (is_custom_photo), linked Instagram user ID (linked_instagram_id), and direct profile link (profile_url).",{"question":83,"answer":84},"Are queries executed in real time?","Yes, every query performs live real-time verification directly against Facebook services with zero reliance on stale data dumps.",{"question":86,"answer":87},"How does rate limiting work across plans?","Standard plans allow 1 request per second with burst tolerance. Subscriptions provide monthly quota pools that decrement on successful queries.",{"question":89,"answer":90},"Where can I access a visual dashboard or bulk CSV scanning?","Visit OSINT Trace at https://osinttrace.com for unified single searches, bulk CSV batch jobs, and downloadable OSINT reports.",[],[93,109,120],{"type":94,"slug":95,"blocked":6,"period":96,"currency":97,"pricing":98,"rate_limit":102,"objects":103,"name":107,"display_name":107,"features":108},"periodic","4pd54gxwxxjdmrdapcrpeuvj","1 MONTH","usd",{"price":99,"credits":99,"past_due_timeout_num":100,"past_due_timeout_type":101},0,3,"DAY",{"max_requests":18,"time_window":18},[104],{"id":105,"name":39,"slug":40,"quota":106,"tiers":18},"n428f3104",15,"BASIC",[],{"type":94,"slug":110,"blocked":6,"period":96,"currency":97,"pricing":111,"rate_limit":113,"objects":115,"name":118,"display_name":118,"features":119},"g8nw2f96ns7tqfbvysi0l4ub",{"price":112,"credits":99,"past_due_timeout_num":100,"past_due_timeout_type":101},9.99,{"max_requests":114,"time_window":114},1,[116],{"id":105,"name":39,"slug":40,"quota":117,"tiers":18},6000,"PRO",[],{"type":94,"slug":121,"blocked":6,"period":96,"currency":97,"pricing":122,"rate_limit":124,"objects":125,"name":128,"display_name":128,"features":129},"xuouddw941ld8sthqtys1gtx",{"price":123,"credits":99,"past_due_timeout_num":100,"past_due_timeout_type":101},30,{"max_requests":114,"time_window":114},[126],{"id":105,"name":39,"slug":40,"quota":127,"tiers":18},20000,"ULTRA",[],[],[],"2026-10-09 10:03:54",{"canonical":134,"page_title":135,"meta":136},"https://jojapi.com/hub/api/facebook-checker","Facebook Checker API Documentation & Playground - JoJ API",{"description":7,"keywords":137},"API,API Documentation,API Playground,Plans & Pricing,Facebook Checker,osinttrace"]