🗺️ New Scrape
Extract business websites from Google Maps
📊 Scraping Results
📋 Scraping Jobs PRO
Loading jobs...
🧹 Email Cleaner
Clean and validate your scraped emails to improve deliverability and reduce bounce rates
📥 Import Emails Step 1
📋 Background Jobs PRO
Loading jobs...
🌐 Website Scraper
Scrape entire websites and export as JSON for API integration
📋 Website Scraping Jobs
Loading jobs...
🔗 API Access
Access your scraped data via API:
GET /api/website-data/{job_id}
Returns JSON with all pages, content, headings, images, and links from the scraped website.
📁 My Scrapes
View and download your previous scrapes and validated emails
🔑 API Access
Manage your API keys and access documentation for external integrations
📊 API Usage Analytics
🕐 Recent API Jobs
Loading...
🌐 Top Scraped Domains
Loading...
🔑 Your API Keys
Loading API keys...
📖 API Documentation
Base URL
https://scrape.iraady.com/api/external
Authentication
Include your API key in the request headers:
X-API-Key: sk_your_api_key_here
/scrape
Submit a website scraping job with optional webhook callback
Request Body:
{
"url": "https://example.com",
"callbackUrl": "https://your-site.com/webhook",
"maxPages": 50,
"maxDepth": 3
}
Response:
{
"success": true,
"jobId": "uuid-here",
"status": "running",
"statusUrl": "/api/external/jobs/uuid-here",
"callbackUrl": "https://your-site.com/webhook"
}
/jobs/:jobId
Check the status of a scraping job
Response:
{
"job": {
"id": "uuid",
"url": "https://example.com",
"domain": "example.com",
"status": "completed",
"pages_scraped": 42,
"webhook_sent": true
}
}
/jobs/:jobId/results
Get the full scraped data for a completed job
Response (Full Website Data):
{
"website": {
"url": "https://example.com",
"domain": "example.com",
"scrapedAt": "2024-01-15T10:30:00Z",
"totalPages": 42
},
"pages": [
{
"url": "https://example.com",
"title": "Example Company",
"description": "Meta description...",
"headings": {
"h1": ["Main Heading"],
"h2": ["About Us", "Services"],
"h3": ["Team", "Contact"]
},
"paragraphs": ["Content text..."],
"images": [
{"src": "https://...", "alt": "Logo"}
],
"links": [
{"href": "https://...", "text": "Learn More"}
],
"mainContent": "Extracted main content...",
"structuredData": {...}
}
]
}
/jobs
List all your scraping jobs (most recent 50)
/jobs/:jobId/cancel
Cancel a running scraping job
📤 Webhook Callback
When a job completes, we'll POST the full
results to your callbackUrl:
{
"jobId": "uuid-here",
"status": "completed",
"url": "https://example.com",
"domain": "example.com",
"pagesScraped": 42,
"data": {
"website": {
"url": "https://example.com",
"domain": "example.com",
"scrapedAt": "2024-01-15T10:30:00Z",
"totalPages": 42
},
"pages": [
{
"url": "https://example.com",
"title": "Example Company",
"description": "Meta description...",
"headings": {...},
"paragraphs": [...],
"images": [...],
"links": [...],
"mainContent": "...",
"structuredData": {...}
}
]
}
}
Headers sent with webhook:
• Content-Type: application/json
•
X-Webhook-Source: scrape.iraady.com
• X-Job-Id: {jobId}
💻 Code Example (JavaScript)
// Submit a scraping job
const response = await fetch('https://scrape.iraady.com/api/external/scrape', {
method: 'POST',
headers: {
'Content-Type': 'application/json',
'X-API-Key': 'sk_your_api_key_here'
},
body: JSON.stringify({
url: 'https://example.com',
callbackUrl: 'https://marketingai.iraady.com/api/brands/import',
maxPages: 50,
maxDepth: 3
})
});
const { jobId } = await response.json();
console.log('Job started:', jobId);
// The results will be POSTed to your callbackUrl when complete!
⚙️ Settings
Manage your account settings
Account Information
📧 Email Scraper
Extract email addresses from websites
📊 Extraction Results
📋 Email Extraction Jobs PRO
Loading jobs...