800notes.com API800notes.com ↗
Access phone number scam reports, user comments, area code listings, forum threads, and articles from 800notes.com via a structured REST API.
curl -X GET 'https://api.parse.bot/scraper/c712b340-cc00-44af-bcbd-b0f361e2c3e5/get_phone_number_report?phone_number=%2B1+%28555%29+012-3456' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieve the full report for a specific phone number including user-submitted comments about calls received from that number. Accepts phone numbers in various formats (with or without dashes, with or without country code prefix).
| Param | Type | Description |
|---|---|---|
| phone_numberrequired | string | Phone number to lookup. Accepts formats like '1-800-266-2278', '800-266-2278', '8002662278', or '18002662278'. |
{
"type": "object",
"fields": {
"title": "string, page title (typically the phone number without country code)",
"comments": "array of comment objects with author, text, date, call_type, and vote_score",
"phone_number": "string, formatted as 1-AAA-BBB-CCCC",
"report_count": "integer, number of comments on the page"
},
"sample": {
"data": {
"title": "+1 (555) 012-3456",
"comments": [
{
"date": "2016-08-15T18:17:10Z",
"text": "Google search shows it is a NYC PD Number. I know no one in NYC. The phone rings 4 times and no message. Sound familiar?",
"author": "angus",
"call_type": "",
"vote_score": "+1"
}
],
"phone_number": "+1 (555) 012-3456",
"report_count": 18
},
"status": "success"
}
}About the 800notes.com API
The 800notes API exposes 6 endpoints for retrieving community-submitted call reports from 800notes.com, the crowd-sourced phone number reputation database. The get_phone_number_report endpoint returns the full comment history for any US phone number — including caller type classifications, vote scores, and author metadata — while companion endpoints cover area code browsing, recent reports, forum threads, and scam articles.
Phone Number Lookups
The get_phone_number_report endpoint accepts a phone number in any common format — dashes optional, country code optional — and returns a structured response with a comments array. Each comment object includes author, text, date, call_type, and vote_score, letting you assess community consensus on whether a number is a scammer, telemarketer, debt collector, or legitimate business. The report_count field tells you how many submissions exist for that number. The search_phone_number endpoint handles the same lookup by query string and also accepts a bare 3-digit area code to return area-level listings.
Area Code and Recent Activity
get_area_code_page takes an area_code parameter (e.g. '800', '212') and an optional page integer for pagination, returning an array of reported phone numbers and their detail URLs alongside a pagination object listing all available pages. get_recent_reports requires no parameters and returns the latest community comments from the 800notes homepage, with each report object carrying a text_snippet, author_info, date, and a direct url back to the full report.
Forum and Editorial Content
get_forum_listing retrieves community forum threads. Pass section: 'latest' to get the most recent threads across all sub-forums; each thread object includes title, url, meta, snippet, and date. get_articles returns the editorial articles section — objects include title, url, excerpt, and date — covering topics like ongoing scam campaigns and consumer guidance around unwanted calls.
- Building a reverse phone lookup tool that surfaces call_type and vote_score data from community reports
- Feeding incoming call data into a CRM to flag numbers already reported as scammers on 800notes
- Generating area-code-level risk summaries by paginating through get_area_code_page results
- Monitoring get_recent_reports on a schedule to detect newly reported scam number patterns
- Aggregating forum thread content from get_forum_listing for a consumer safety research corpus
- Enriching a spam-call dataset with article excerpts and dates from get_articles for trend analysis
- Building a browser extension that queries get_phone_number_report and displays comment counts inline
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.