{"uid":"cap_PHy8zrFDq7YF5rUje5I5_","slug":"temporary-phone-number-directory-scraper-ad09a5db","name":"Temporary Phone Number Directory Scraper","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://api.scrapeforagents.tech/v1/temp?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"isNew":null,"number":null,"country":null,"addedAgo":null,"inboxUrl":null,"sourceUrl":null,"countryCode":null,"messageCount":null}],"product":"temp"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.025","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.025/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.025","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_O0kgreVJmOAnu9mrHPutF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.025","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes and returns structured listings of temporary/disposable phone numbers from a public directory, filterable by country and recency","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Find fresh temp numbers for SMS verification","prompt":"Get me up to 25 temporary phone numbers from the directory that were added in the last 24 hours — I need their inbox URLs so I can check for incoming messages."},{"title":"Browse disposable numbers by country","prompt":"List all available temporary phone numbers for Belgium from the public directory, starting from page 1, give me up to 50 results with their country codes and inbox links."},{"title":"Search directory for specific number fragment","prompt":"Search the temp phone number directory for numbers containing '447' and return up to 30 results with their source URLs and how long ago they were added."}],"resultDescription":"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'.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:47:42.539Z","isFirstParty":false,"canonicalSlug":"temporary-phone-number-directory-scraper-ad09a5db"}