W
Website Email and Contact Scraper
Published bysoban hanif
10/29/2026
# API Endpoints
1. Start Scrap
2. Get Scraping Results
-----------
## Start Scrap
This endpoint submits a website URL for contact information extraction.
It scans the given website and attempts to collect publicly available contact details such as **email addresses, phone numbers, physical addresses, and social media links**.
The request is queued for background processing and a **job ID** is returned.
Use the **/result/{job_id}** endpoint to retrieve the final extracted data.
### Parameter Description
url (query parameter, required)
Full website URL to scan.
Example:
url : https://example.com
### Response Behavior
```
{
"job_status": "queued",
"job_id": job_id
}
```
-----------
## Get Scraping Results
This endpoint retrieves the result of a previously submitted website scraping job.
After submitting a URL to the **/scrape** endpoint, a **job ID** is returned. This endpoint allows you **to check the job’s processing status and fetch extracted contact details** once the job is complete.
Clients should **wait 2–3 minutes** before calling this endpoint to allow processing to complete.
In most cases, the first poll after a short delay will already return the final results — avoiding repeated polling and extra API usage.
***Job results remain available for 24 hours.***
After 24 hours, the job ID expires and results are no longer accessible. Clients are advised to store retrieved results on their side if long-term access is needed.
The endpoint supports real-time job tracking and ensures reliable asynchronous scraping without client-side timeouts.
### Response Behavior
**If job is not started yet:**
`{ "job_status": "pending" }`
**If job is still processing:**
`{ "job_status": "processing" }`
**If job completed successfully:**
```
{
"job_status": "done",
"data": {
"emails": [...],
"phone_numbers": [...],
"addresses": [...],
"social_media_links": [...]
}
}
```
**If job failed:**
Returns empty data arrays with status failed.
**If job expired:**
`{ "job_status": "expired" }`
**If job ID does not exist:**
Returns HTTP 404 – Job not found.
-----------
Last updated 2026-10-29