Fsociety API Docs

Fsociety Search API — Полное описание всех эндпоинтов

⚠️ Важно: Поиск по Telegram принимает только числовой ID (например: 123456789). Поиск по username не поддерживается.

🔑 Авторизация

Все API запросы требуют заголовок X-API-Key с валидным ключом:

X-API-Key: Fsociety_66beac29ce86f915b184a9ddde7aecbfc6177ab265cf5c1f579ce53219422234

📡 Эндпоинты

POST /api/search

Основной поисковый эндпоинт. Принимает JSON с параметрами запроса.

{
    "query": "+79991234567",
    "search_type": "phone",
    "include": ["depsearch", "nightsearch"]
}

GET /api/search

Поиск через GET параметры.

GET /api/search?query=Иванов Иван&search_type=fio

GET /api/status

Проверка статуса API и доступности источников.

GET /api/types

Получить список всех поддерживаемых типов поиска.

GET /docs

Эта страница документации.

📋 Поддерживаемые типы поиска

phone

Номер телефона

+79991234567

Email адрес

user@example.com

fio

ФИО человека

Иван Петров

VK профиль

id12345678

ТОЛЬКО ID Telegram

123456789

IP адрес

8.8.8.8

snils

СНИЛС

12345678901

inn

ИНН

771234567890

car

Номер авто/VIN

JTHBF5C14A503481

instagram

Instagram

instagram.com/username

tiktok

TikTok

tiktok.com/@username

passport

Паспорт

1234 567890

💻 Примеры использования

cURL

curl -X POST https://fsocietyapi.duckdns.org/api/search \
  -H "X-API-Key: Fsociety_66beac29ce86f915b184a9ddde7aecbfc6177ab265cf5c1f579ce53219422234" \
  -H "Content-Type: application/json" \
  -d '{"query": "Иванов Иван", "search_type": "fio"}'

Python

import requests

API_KEY = "Fsociety_66beac29ce86f915b184a9ddde7aecbfc6177ab265cf5c1f579ce53219422234"

response = requests.post(
    "https://fsocietyapi.duckdns.org/api/search",
    headers={"X-API-Key": API_KEY},
    json={"query": "Иванов Иван", "search_type": "fio"}
)
print(response.json())

JavaScript (fetch)

const API_KEY = "Fsociety_66beac29ce86f915b184a9ddde7aecbfc6177ab265cf5c1f579ce53219422234";

fetch('https://fsocietyapi.duckdns.org/api/search', {
    method: 'POST',
    headers: {
        'X-API-Key': API_KEY,
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({ query: 'Иванов Иван', search_type: 'fio' })
})
.then(r => r.json())
.then(data => console.log(data));

📦 Структура ответа

{
    "status": "success",
    "query": "Иванов Иван",
    "search_type": "fio",
    "timestamp": "2024-01-01T12:00:00",
    "sources": [...],
    "total_found": 3,
    "summary": {
        "total_sources": 4,
        "sources_with_data": 3,
        "total_names": 5,
        "total_phones": 2,
        "total_emails": 1
    }
}

Документация API