Discover/800notes API
live

800notes API800notes.com

Access phone number scam reports, user comments, area code listings, forum threads, and articles from 800notes.com via a structured REST API.

Endpoint health
verified 4d ago
get_articles
search_phone_number
get_forum_listing
get_phone_number_report
get_area_code_page
6/6 passing latest checkself-healing
Endpoints
6
Updated
26d ago

What is the 800notes 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.

Try it
Phone number to lookup. Accepts formats like '1-800-266-2278', '800-266-2278', '8002662278', or '18002662278'.
api.parse.bot/scraper/c712b340-cc00-44af-bcbd-b0f361e2c3e5/<endpoint>
Ready to send
Fill in the parameters and hit sign in to send to see live response data here.
Call it over HTTPgrab a free API key at signup
curl -X GET 'https://api.parse.bot/scraper/c712b340-cc00-44af-bcbd-b0f361e2c3e5/get_phone_number_report?phone_number=8002662278' \
  -H 'X-API-Key: $PARSE_API_KEY'
Python SDK · recommended

Typed, relational, agent-ready

A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.

  • Fully typed · autocompletes
  • Objects link to objects
  • Typed errors & pagination

Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:

uv add parse-sdk
uv run parse init
uv run parse add --marketplace 800notes-com-api

uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.

"""Walkthrough: 800Notes SDK — investigate scam calls, browse reports and articles."""
from parse_apis.eight_hundred_notes_scam_call_api import EightHundredNotes, PhoneNumberInvalid

client = EightHundredNotes()

# Browse recent scam reports from the homepage
for report in client.recentreports.list(limit=3):
    print(report.text_snippet[:80], report.author_info)

# Look up a specific phone number's full report
report = client.phonereports.get(phone_number="8002662278")
print(report.title, f"({report.report_count} reports)")
for comment in report.comments[:2]:
    print(comment.author, comment.text[:60], comment.date)

# Search for phone numbers matching a query
result = client.phonereports.search(query="8002662278", limit=1).first()
if result:
    print(result.phone_number, result.title)

# Browse reported numbers in an area code
area = client.areacodepages.get(area_code="800")
for entry in area.phone_numbers[:3]:
    print(entry.number, entry.url)

# Get community forum threads about scam trends
for thread in client.forumthreads.list(limit=3):
    print(thread.title, thread.meta)

# Handle invalid phone number input gracefully
try:
    client.phonereports.get(phone_number="")
except PhoneNumberInvalid as exc:
    print(f"Invalid input: {exc}")

# Browse educational articles about phone fraud prevention
for article in client.articles.list(limit=3):
    print(article.title, article.excerpt[:60])

print("exercised: recentreports.list / phonereports.get / phonereports.search / areacodepages.get / forumthreads.list / articles.list")
All endpoints · 6 totalmissing one? ·

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). Returns the phone number normalized to 1-AAA-BBB-CCCC format, a title, comment count, and the full list of user comments with author, text, date, call_type, and vote_score.

Input
ParamTypeDescription
phone_numberrequiredstringPhone number to lookup. Accepts formats like '1-800-266-2278', '800-266-2278', '8002662278', or '18002662278'.
Response
{
  "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": "2007-06-08T00:05:42Z",
          "text": "This is only Comcast calling their customers",
          "author": "Jane Doe",
          "call_type": "Call type: Valid",
          "vote_score": "+8"
        }
      ],
      "phone_number": "+1 (555) 012-3456",
      "report_count": 20
    },
    "status": "success"
  }
}

About the 800notes API

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.

Reliability & maintenanceVerified

The 800notes API is a managed, monitored endpoint for 800notes.com — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when 800notes.com changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.

This isn't an official 800notes.com API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.

Last verified
4d ago
Latest check
6/6 endpoints passing
Maintenance
Monitored & self-healing
Will this API break when the source site changes?+
It's built not to. Every endpoint is health-checked on a schedule with automated test probes. When the source site changes and a check fails, the API is automatically queued for repair and re-verified — that's the self-healing layer. Each API page shows when its endpoints were last verified. And because marketplace APIs are shared, any fix reaches everyone using it.
Is this an official API from the source site?+
No — Parse APIs are independent, managed REST wrappers over publicly available data. That is the point: where a site has no official API (or only a limited one), Parse gives you a maintained, monitored endpoint for that data and keeps it working as the site changes — so you get a stable contract over a source that never promised one.
Can I fix or extend this API myself if I need a new endpoint or field?+
Yes — and you don't have to wait on us. This API was generated by the Parse agent, which stays attached. Describe the change in plain English ("add an endpoint that returns reviews", "fix the price field") in the revise box on the API page or via the revise_api MCP tool, and the agent rebuilds it against the live site in minutes. Contributing the change back to the public API is free.
What happens if I call an endpoint that has an issue?+
Errors are machine-readable: a bad call returns a clean status with the list of available endpoints and a repair hint, so an agent (or you) can recover or trigger a fix instead of failing silently. Confirmed failures feed the automatic repair queue.
Common use cases
  • 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
Pricing & limitsSee full pricing →
TierPriceCredits/monthRate limit
Free$0/mo1005 req/min
Hobby$30/mo1,00020 req/min
Developer$100/mo5,000100 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.

Frequently asked questions
Does 800notes.com have an official developer API?+
No. 800notes.com does not publish an official developer API or documented data access program. This Parse API is the structured way to retrieve its data programmatically.
What does the comments array in get_phone_number_report include?+
Each object in the comments array contains author, text, date, call_type (a user-selected label such as 'telemarketer' or 'scammer'), and vote_score reflecting community up/down votes on that comment. The top-level report_count field reflects the total number of such comments on the page.
Does get_area_code_page return the full report for each listed number?+
No — it returns an array of objects with number and url only, not the full comment history. Full comment data is available by passing each number to get_phone_number_report. You can fork this API on Parse and revise it to chain those calls and return enriched area-code reports in a single response.
Can I filter phone number reports by call_type or date range?+
The current endpoints do not expose server-side filtering by call_type or date. get_phone_number_report returns all comments for a number, and filtering must be done client-side on the returned comments array. You can fork this API on Parse and revise it to add a filtering layer over the response.
How current are the reports returned by get_recent_reports?+
get_recent_reports reflects whatever comments are currently shown on the 800notes homepage at the time of the request — it has no configurable time window and does not support pagination. If you need historical data beyond the homepage feed, use get_phone_number_report for specific numbers or get_area_code_page to browse by area code.
Page content last updated . Spec covers 6 endpoints from 800notes.com.
Related APIs in Reviews RatingsSee all →
shouldianswer.com API
Search phone numbers to get ratings, reviews, and community comments to identify spam calls and unwanted contacts. Access curated blog posts with tips and insights about phone number safety and caller identification.
annualreports.com API
Search for and access thousands of international company annual reports in PDF and HTML formats, while filtering by ticker, exchange, industry, sector, company size, and location. Browse company profiles and financial documents across different markets and industries to find the information you need.
12321.cn API
Access real-time anti-fraud information, complaint notices, and safety warnings from China's 12321 telecom complaint platform to check SMS and phone complaints, view fraud alerts, and monitor complaint status. Stay informed with official news, reports, and statistics about telecommunications fraud and consumer complaints.
krak.dk API
Search for businesses and people in Denmark, retrieve detailed information like contact details and company profiles, and look up phone numbers to identify callers or report spam statistics. Find what you're looking for in the Danish business and person directory with instant access to company details, personal information, and caller identification data.
yellowpages.com API
Search and retrieve business listings, contact info, hours, categories, and customer reviews from YellowPages.com. Browse by category or location across the US.
infobel.com API
Search and retrieve business and person contact information from Infobel directories across the globe to find phone numbers, addresses, and other details. Quickly locate companies or individuals by name to build targeted contact lists or verify business information worldwide.
pmgnotes.com API
Access detailed grading population data for banknotes across different countries, series, and denominations, plus stay updated with the latest news from PMGnotes.com. Search and retrieve comprehensive census information to track banknote rarity, grades, and collecting trends.
telecontact.ma API
Find businesses, phone numbers, and reviews across Morocco using Telecontact.ma's comprehensive directory—search by business name, location, phone number, brand, or ICE registration, and access detailed contact information, ratings, and top-rated companies in any category. Discover local services, browse by activity type, and identify leading brands all in one place.