API Documentation
Comprehensive guide to using the PhishStats API for accessing phishing data
Base URL
https://api.phishstats.info/api/phishing
Parameters
Filtering
_where=(field,operator,value) Filter results based on field conditions
Operators
eq equals
ne not equals
gt greater than
lt less than
like contains
and logical AND
or logical OR
Sorting
_sort=field Sort by field (use -field for descending order)
Pagination
_p=page_number _size=records_per_page Examples
Basic Queries
By ID
/api/phishing?_where=(id,eq,3296584)
Get specific record by ID
By ASN
/api/phishing?_where=(asn,eq,AS14061)
Get records from specific ASN
By IP Address
/api/phishing?_where=(ip,eq,148.228.16.3)
Get records from specific IP
By Country
/api/phishing?_where=(countrycode,eq,US)
Get records from specific country
By TLD
/api/phishing?_where=(tld,eq,BR)
Get records with specific top-level domain
Advanced Queries
Latest by Date
/api/phishing?_sort=-date
Get most recent records
Title Contains "apple"
/api/phishing?_where=(title,like,apple)&_sort=-id
Search for records with "apple" in title
URL Contains "login"
/api/phishing?_where=(url,like,login)&_sort=-id
Search for records with "login" in URL
Title OR URL Contains "bank"
/api/phishing?_where=(title,like,bank)~or(url,like,bank)&_sort=-id
Search for "bank" in either title or URL
Score > 5 and Country ≠ BR
/api/phishing?_where=(score,gt,5)~and(countrycode,ne,BR)&_sort=-id
High score records not from Brazil
High Score with .com TLD
/api/phishing?_where=(score,gt,8)~and(tld,eq,com)&_sort=-date
High confidence .com domains
Complex Query
/api/phishing?_where=(countrycode,eq,BR)~and(url,like,login)~and(score,gt,4)&_sort=-date
Brazilian login pages with score > 4
Pagination Examples
Page 1, 50 Results
/api/phishing?_p=1&_size=50
Get first 50 records
Page 2, 100 Results
/api/phishing?_p=2&_size=100
Get next 100 records
Recent .xyz Domains
/api/phishing?_where=(tld,eq,xyz)&_sort=-date&_p=1&_size=100
Latest 100 .xyz domain records
Rate Limits
Users can make up to 20 requests per minute. If you need higher limits, please contact us for a custom plan.
Support
For any questions or support regarding the API, please send an email to [email protected]