API: OPERATIONAL
API Reference
Full guide to integrating Fsociety Search API. REST API with key authentication.
$ curl -X POST "https://fsocietyapi.cc.cd/api/search" \
-H "X-API-Key: Fsociety_xxx" \
-H "Content-Type: application/json" \
-d '{"query":"79001234567","search_type":"phone"}'
-H "X-API-Key: Fsociety_xxx" \
-H "Content-Type: application/json" \
-d '{"query":"79001234567","search_type":"phone"}'
How it works
Fsociety Search API. One request — aggregated results from all connected sources.
01
Get API key
Create an app in the Telegram bot
Create an app in the Telegram bot
02
Add header
X-API-Key: Fsociety_your_key
X-API-Key: Fsociety_your_key
03
Make request
POST /api/search
POST /api/search
Authentication
All requests require header:
X-API-Key: Fsociety_ваш_ключ
Request parameters
query — required — search string
search_type — optional — phone / email / fio / vk / tg / ip / snils / inn / car / passport
include — optional
Endpoints
POST /api/search
Main search. Returns raw data from all sources.
{"query": "79001234567", "search_type": "phone"}GET /api/status
API status and sources list.
GET /api/types
Supported search types.
Search methods
| Type | Description | Example |
|---|---|---|
phone | Phone number | 79001234567 |
email | user@example.com | |
fio | Full name | Иванов Иван |
vk | VKontakte | id123456 |
tg | Telegram ID | 123456789 |
ip | IP address | 8.8.8.8 |
snils | SNILS | 12345678901 |
inn | INN | 771234567890 |
car | Car / VIN | А123ВС77 |
passport | Passport | 4512 123456 |
Response example
{
"status": "success",
"query": "79001234567",
"search_type": "phone",
"sources": [ ... ],
"total_found": 3,
"summary": { "total_sources": 3, "sources_with_data": 3 }
}Error codes
| Code | Description |
|---|---|
| 200 | Success |
| 400 | Missing query |
| 401 | Invalid / inactive key or low balance |
| 500 | Server error |
Python
import requests
r = requests.post("https://fsocietyapi.cc.cd/api/search",
headers={"X-API-Key": "Fsociety_ваш_ключ", "Content-Type": "application/json"},
json={"query": "79001234567", "search_type": "phone"})
print(r.json())cURL
curl -X POST https://fsocietyapi.cc.cd/api/search \
-H "X-API-Key: Fsociety_ваш_ключ" \
-H "Content-Type: application/json" \
-d '{"query":"79001234567","search_type":"phone"}'Node.js
const r = await fetch("https://fsocietyapi.cc.cd/api/search", {
method: "POST",
headers: { "X-API-Key": "Fsociety_ваш_ключ", "Content-Type": "application/json" },
body: JSON.stringify({ query: "79001234567", search_type: "phone" })
});
console.log(await r.json());