{"openapi":"3.2.0","info":{"title":"Website Email and Contact Scraper API","description":"Extract emails, phone numbers, social media links and contact information from any website URL. Fast queue-based scraping with result caching and polling support.","version":"1.0.0"},"servers":[{"url":"https://lbbff.jojapi.net"}],"security":[{"ApiKeyAuth":[]}],"x-agent-commerce":{"catalog_url":"https://lbbff.jojapi.net/_jojapi/agent/plans","discovery_url":"https://lbbff.jojapi.net/.well-known/x402","directory_url":"https://agents.jojapi.net/apis/website-email-and-contact-scraper-api","docs":"https://docs.jojapi.com/consumers/agents"},"paths":{"/scrape":{"get":{"operationId":"get_scrape","summary":"Start Scrape","description":"This endpoint submits a website URL for contact information extraction.\nIt scans the given website and attempts to collect publicly available contact details such as **email addresses, phone numbers, physical addresses, and social media links**.\n\nThe request is queued for background processing and a **job ID** is returned.\nUse the **/result/{job_id}** endpoint to retrieve the final extracted data. \n## Parameter Description\nurl (query parameter, required)\nFull website URL to scan.\nExample:\nhttps://example.com\n## Response Behavior\n\n```\n{\n         \"job_status\": \"queued\",\n        \"job_id\": job_id\n}\n```","responses":{"200":{"description":"Response 200","content":{"application/json":{"example":{"job_status":"queued","job_id":""}}}},"402":{"description":"Payment required — pay per request with x402/mpp (offer in the PAYMENT-REQUIRED / WWW-Authenticate headers and the JSON body), or send a JoJ API key."}},"x-payment-info":{"protocols":["x402","mpp"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"intent":"charge"},"parameters":[{"name":"url","in":"query","required":true,"schema":{"type":"string"}}]}},"/result/{job_id}":{"get":{"operationId":"get_result_job_id","summary":"Get Scraping Result","description":"This endpoint retrieves the result of a previously submitted website scraping job.\nAfter 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.\n\nClients should **wait 1–2 minutes** before calling this endpoint to allow processing to complete.\nIn most cases, the first poll after a short delay will already return the final results — avoiding repeated polling and extra API usage.\n\n***Job results remain available for 24 hours.***\nAfter 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.\n\nThe endpoint supports real-time job tracking and ensures reliable asynchronous scraping without client-side timeouts.\n## Response Behavior\n**If job is not started yet:**\n`{ \"job_status\": \"pending\" }`\n**If  job is still processing:**\n`{ \"job_status\": \"processing\" }`\n**If job completed successfully:**\n\n```\n{\n  \"job_status\": \"done\",\n  \"data\": {\n    \"emails\": [...],\n    \"phone_numbers\": [...],\n    \"addresses\": [...],\n    \"social_media_links\": [...]\n  }\n}\n```\n**If job failed:**\nReturns empty data arrays with status failed.\n**If job expired:**\n`{ \"job_status\": \"expired\" }`\n**If job ID does not exist:**\nReturns HTTP 404 – Job not found.","responses":{"200":{"description":"Response 200","content":{"application/json":{"example":{"job_status":"done","data":{"emails":[],"phone_numbers":[],"addresses":[],"social_media_links":[]}}}}},"402":{"description":"Payment required — pay per request with x402/mpp (offer in the PAYMENT-REQUIRED / WWW-Authenticate headers and the JSON body), or send a JoJ API key."}},"x-payment-info":{"protocols":["x402","mpp"],"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"intent":"charge"},"parameters":[{"name":"job_id","in":"path","required":true,"schema":{"type":"string"}}]}}},"components":{"securitySchemes":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-JoJAPI-Key","description":"Your JoJ API key."}}}}