⚡ Публичный API · Без ключей · Бесплатно

API spam.partners

Подключай к своим сервисам, ботам или CRM-системам. Проверяй спамеров и компании в реальном времени.

📊 0 жалоб в базе 🏢 1461 компаний 👤 0 спамеров

Base URL

https://spam.partners

Все запросы — GET, без авторизации. Формат ответа — JSON.

GET

/api/check/{username}

— проверить спамера

Самый быстрый способ проверить, есть ли пользователь в базе спамеров. Передай Telegram username (с @ или без). Если найден — вернёт статистику и компании.

Параметры пути

Параметр	Тип	Описание
`username`	string	Telegram username. Знак @ необязателен.

Пример запроса curl

curl https://spam.partners/api/check/spammer_username

200 — найден

{
  "found": true,
  "username": "spammer_username",
  "reports_count": 7,
  "confidence_max": 75,
  "first_seen": "2026-01-15T10:23:00Z",
  "last_seen": "2026-03-10T18:41:00Z",
  "categories": ["gambling", "crypto"],
  "companies": ["Mostbet", "1xBet"],
  "url": "https://spam.partners/spammer/spammer_username"
}

404 — не найден

{
  "found": false,
  "username": "clean_user",
  "reports_count": 0
}

GET

/api/companies

— рейтинг компаний

Список компаний, отсортированных по числу жалоб. Поддерживает пагинацию и фильтрацию по slug.

Query параметры

Параметр	Тип	По умолчанию	Описание
`limit`	integer	50	Записей на страницу. Макс. 200.
`page`	integer	1	Номер страницы.
`slug`	string	—	Фильтр по конкретной компании.

Примеры

curl "https://spam.partners/api/companies?limit=10&page=1"
curl "https://spam.partners/api/companies?slug=mostbet"

200 OK

{
  "data": [
    {
      "id": 1,
      "name": "Mostbet",
      "slug": "mostbet",
      "reports_count": 142,
      "url": "https://spam.partners/company/mostbet"
    },
    ...
  ],
  "total": 87,
  "page": 1,
  "pages": 2
}

GET

/api/spammers

— список спамеров

Список спамеров с username в базе, сгруппированных по аккаунту. Фильтрация по username, категории и пагинация.

Query параметры

Параметр	Тип	По умолчанию	Описание
`limit`	integer	50	Записей на страницу. Макс. 200.
`username`	string	—	Поиск конкретного пользователя.
`category`	string	—	Фильтр по категории: `gambling` `crypto` `nutra` `traffic` `affiliate` `job` `adult`

Примеры

curl "https://spam.partners/api/spammers?limit=20"
curl "https://spam.partners/api/spammers?category=gambling"
curl "https://spam.partners/api/spammers?username=someuser"

200 OK

{
  "data": [
    {
      "username": "spammer123",
      "reports_count": 14,
      "last_seen": "2026-03-10T18:41:00Z",
      "category": "gambling",
      "url": "https://spam.partners/spammer/spammer123"
    },
    ...
  ],
  "total": 312
}

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

Telegram бот на Python

import requests

def is_spammer(username):
    r = requests.get(
        f"https://spam.partners/api/check/{username}"
    )
    data = r.json()
    return data.get("found", False)

# В хэндлере нового участника:
if is_spammer(new_member.username):
    await bot.ban_chat_member(chat_id, new_member.id)

JavaScript / Node.js

async function checkSpammer(username) {
  const res = await fetch(
    `https://spam.partners/api/check/${username}`
  );
  const data = await res.json();
  return {
    isSpammer: data.found,
    reports: data.reports_count,
    companies: data.companies ?? [],
  };
}

PHP

function checkSpammer(string $username): bool {
    $response = file_get_contents(
        "https://spam.partners/api/check/{$username}"
    );
    $data = json_decode($response, true);
    return $data['found'] ?? false;
}

Google Sheets / Apps Script

function CHECK_SPAM(username) {
  const url = "https://spam.partners/api/check/"
    + username.replace("@", "");
  const r = UrlFetchApp.fetch(url);
  const d = JSON.parse(r.getContentText());
  return d.found ? d.reports_count : 0;
}

📋 Ограничения и заметки

✓ Без ключей. API публичный, авторизация не нужна.
✓ Rate limit. Мягкий лимит ~60 запросов/минуту с одного IP. При злоупотреблении IP блокируется.
✓ CORS. Разрешены запросы из браузера (CORS открыт).
⚠ 404 ≠ чистый. Отсутствие записи означает только то, что жалоб не поступало. Данные краудсорсинговые.
⚠ Не для автобана. Используй данные как сигнал, не как автоматическое решение.

Нашёл спамера — добавь в базу через бота

📩 Открыть @SPAMpartnersBOT