# 800notes — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Look up phone numbers to retrieve community-submitted scam and unwanted-call reports from 800notes.com. Browse recent reports, search by area code, explore forum discussions, and read articles about phone scams — all sourced from the 800notes public database.

**Category:** Reviews & Ratings | **Website:** [800notes.com/](https://800notes.com/) | **Docs:** [parse.bot/marketplace/43a8a766-faba-4322-8493-abeef12af962/800notes-com-api](https://parse.bot/marketplace/43a8a766-faba-4322-8493-abeef12af962/800notes-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-800notes-com-api-43a8a766/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### get_area_code_page

Retrieve reported phone numbers for a given area code with pagination. Returns a list of phone numbers that have been reported in the specified area code along with pagination links for navigating through multiple pages of results.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `area_code` | string | Yes | 3-digit area code (e.g. '800', '212'). |
| `page` | integer | No | Page number for pagination. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-800notes-com-api-43a8a766/get_area_code_page \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"area_code":"<string>","page":"<integer>"}'
```

### get_articles

Retrieve informational articles about phone scams from the 800notes articles section. Returns article titles, URLs, excerpts, and publication dates. Content is static educational material about telemarketing fraud, privacy, and how to report phone crime.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-800notes-com-api-43a8a766/get_articles \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### get_forum_listing

Retrieve a list of forum threads from the 800notes community forum. Returns thread titles, URLs, metadata (post count and last poster), text snippets, and dates.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `section` | string | No | Forum section. Use 'latest' for the latest topics across all forums. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-800notes-com-api-43a8a766/get_forum_listing \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"section":"<string>"}'
```

### get_phone_number_report

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.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `phone_number` | string | Yes | Phone number to lookup. Accepts formats like '1-800-266-2278', '800-266-2278', '8002662278', or '18002662278'. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-800notes-com-api-43a8a766/get_phone_number_report \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"phone_number":"<string>"}'
```

### get_recent_reports

Retrieve the most recently reported call snippets from the 800notes homepage. Returns recent user comments about phone numbers including text snippets, author information, and timestamps.

**Estimated cost:** Metered

_No parameters required._

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-800notes-com-api-43a8a766/get_recent_reports \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{}'
```

### search_phone_number

Search for a phone number. If the query is a phone number (10+ digits), returns the full phone number report. If the query is a 3-digit area code, returns area code listings with phone_numbers and pagination. For keyword queries, returns recent report snippets from the homepage with snippet and date fields.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `query` | string | Yes | Phone number (e.g. '8002662278' or '1-800-266-2278'), 3-digit area code (e.g. '800'), or keyword search phrase. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-800notes-com-api-43a8a766/search_phone_number \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query":"<string>"}'
```