# Temporary Phone Number Directory Scraper

> Temporary Phone Number Directory Scraper is a paid API for AI agents from api.scrapeforagents.tech, paid per call via x402, $0.025/call, status unknown (last checked 2026-10-02).

Scrapes and returns structured listings of temporary/disposable phone numbers from a public directory, filterable by country and recency

## Facts

- Endpoint: POST https://api.scrapeforagents.tech/v1/temp?utm_source=zero.xyz
- Price: $0.025/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/temporary-phone-number-directory-scraper-ad09a5db
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PHy8zrFDq7YF5rUje5I5_

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability temporary-phone-number-directory-scraper-ad09a5db -d '<json body>'
```

Example prompt: Pull me up to 50 temporary phone numbers from the public directory for the United Kingdom, only ones added in the last 24 hours, starting from page 1.

## When to prefer this

Use this endpoint when you need structured, paginated data from a public temporary phone number directory and want to filter by country or recency without building your own scraper. It is pay-per-successful-call, so failed or empty runs cost nothing. Prefer it over building a custom scraper when you need quick access to disposable number listings with inbox URLs.

## Known failure modes

- Empty result set if no numbers match the country or search filter — run is not charged
- Invalid country name returns zero results
- startPage beyond available pages returns empty items array
- Network or scraping failure returns an error — not charged
- maxItems set to 0 may trigger very long pagination runs

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count of results and an array of phone number entries, each containing the number itself, country, country code, inbox URL, source URL, how long ago it was added, whether it is new, and message count. The product field is labeled 'temp'.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "new24": {
   "type": "boolean",
   "default": false,
   "description": "Only include numbers marked as added within the past 24 hours by the directory."
  },
  "search": {
   "type": "string",
   "default": "",
   "description": "Optional directory search for a country name or phone number fragment."
  },
  "country": {
   "type": "string",
   "default": "",
   "description": "Exact country name shown in the public directory, such as Belgium or United Kingdom. Leave empty for all countries."
  },
  "maxItems": {
   "type": "integer",
   "default": 50,
   "minimum": 0,
   "description": "Stop after this many unique numbers. Use 0 to continue through all available pages."
  },
  "startPage": {
   "type": "integer",
   "default": 1,
   "minimum": 1,
   "description": "Directory page to start from. Each page contains up to 50 numbers."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "isNew": null,
    "number": null,
    "country": null,
    "addedAgo": null,
    "inboxUrl": null,
    "sourceUrl": null,
    "countryCode": null,
    "messageCount": null
   }
  ],
  "product": "temp"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/temporary-phone-number-directory-scraper-ad09a5db/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.scrapeforagents.tech](https://www.zero.xyz/host/api.scrapeforagents.tech/llms.txt)