Skip to main content

​
1. Trigger a career page scrape

curl -X POST https://api.automindz.co/v1/scrape-career-pages \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "company_url": "acme.com",
    "company_name": "Acme Corp"
  }'
Response: 
{
  "run_id": "run_abc123xyz",
  "status": "QUEUED"
}

​
2. Poll for results

curl https://api.automindz.co/v1/runs/<run_id> \
  -H "Authorization: Bearer <your-api-key>"
Poll every 15–30 seconds. Most scrapes complete within 2–5 minutes. Companies with large ATS-hosted job boards may take longer.

​
3. Get the results

When status is COMPLETED, the response includes the full job listings: 
{
  "run_id": "run_abc123xyz",
  "status": "COMPLETED",
  "result": {
    "company": "Acme Corp",
    "url": "https://acme.com",
    "career_page_urls": ["https://jobs.lever.co/acme"],
    "total_found": 12,
    "jobs_analyzed": 12,
    "pages_scraped": 3,
    "jobs": [
      {
        "job_title": "Senior Software Engineer",
        "location": "London, UK",
        "city": "London",
        "country": "United Kingdom",
        "job_type": "full-time",
        "remote_policy": "hybrid",
        "department": "Engineering",
        "salary_min": 90000,
        "salary_max": 120000,
        "salary_currency": "GBP",
        "salary_period": "annual",
        "min_years_of_experience": 5,
        "requirements": ["5+ years TypeScript", "React", "Node.js"],
        "job_url": "https://jobs.lever.co/acme/abc-123",
        "ats_system": "lever",
        "posted_at": "2026-05-01"
      }
    ]
  },
  "started_at": "2026-05-15T10:00:00Z",
  "finished_at": "2026-05-15T10:03:42Z"
}