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