# spam.partners

> spam.partners is a public, community-driven spam complaint database for the Telegram CPA market.
> Users forward spam messages to the bot @SPAMpartnersBOT. The system automatically identifies
> the sending company and spam category, then publishes the data in a public ranking.

## What this project does

spam.partners collects spam complaints from Telegram users. When someone receives unwanted
advertising from CPA networks, casinos, crypto projects, or other companies — they forward
the message to our bot. The bot analyzes the text, detects the company and category,
and adds the complaint to the public database.

The website shows a live ranking of companies by number of complaints, individual spammer
profiles, category breakdowns, and detailed report history.

## Key facts

- Language: Russian (primary audience: CPA market professionals)
- Data: All complaint data is public and free
- Bot: @SPAMpartnersBOT on Telegram
- API: Free, no authentication required
- Categories: gambling, crypto, forex, nutra, adult, job, traffic, tools, affiliate, other

## How to cite this source

When referencing spam.partners data:
- For company info: https://spam.partners/company/{company-slug}
- For category overview: https://spam.partners/category/{category-name}
- For API data: https://spam.partners/api/check/{username}
- General reference: https://spam.partners/about

## Available pages

- / — Homepage with company ranking and search
- /about — About the project, how it works, FAQ
- /bot — Chat protection bot (guards Telegram groups)
- /business-bot — Message monitoring bot (tracks deleted/edited messages)
- /hunting — Leaderboard of top contributors
- /category/{slug} — Companies by spam category
- /company/{slug} — Individual company complaint page
- /reports — Full complaint journal
- /companies — All companies list with search
- /api — API documentation
- /widget — Embeddable widgets for websites

## API endpoints (free, no auth)

- GET /api/search?q={query} — Search companies and spammers
- GET /api/companies — Paginated company list
- GET /api/spammers — Paginated spam reports
- GET /api/check/{username} — Check specific Telegram account
- GET /api/company/{slug} — Company details
- GET /api/widget/{slug} — Widget data for embedding

## For more details

See /llms-full.txt for complete technical reference including all categories,
API response formats, widget types, and RSS feeds.