Anvesh
API ReferenceAutomation

Get task status

Retrieve the current status and details of a specific automation task. **Possible statuses:** - `idle` - Task is queued but not yet started - `running` - Task is currently scraping - `completed` - Task finished successfully - `stopped` - Task was stopped by user - `error` - Task encountered an error

GET
/automation/tasks/{task_id}

Path Parameters

task_id*string

The unique task ID

Header Parameters

X-API-Key*string

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "http://localhost:8000/automation/tasks/string" \  -H "X-API-Key: string"
{
  "data": {
    "id": 1,
    "name": "Example"
  },
  "error": false,
  "message": "Operation completed successfully",
  "success": true
}
{
  "data": {
    "errors": [
      "field -> error message"
    ]
  },
  "error": true,
  "message": "Validation error",
  "success": false
}
{
  "data": {
    "errors": [
      "field -> error message"
    ]
  },
  "error": true,
  "message": "Validation error",
  "success": false
}
{
  "data": {
    "errors": [
      "field -> error message"
    ]
  },
  "error": true,
  "message": "Validation error",
  "success": false
}
{
  "data": {
    "errors": [
      "field -> error message"
    ]
  },
  "error": true,
  "message": "Validation error",
  "success": false
}
{
  "data": {
    "errors": [
      "field -> error message"
    ]
  },
  "error": true,
  "message": "Validation error",
  "success": false
}
{
  "data": {
    "errors": [
      "field -> error message"
    ]
  },
  "error": true,
  "message": "Validation error",
  "success": false
}

List all tasks

Retrieve a list of all automation tasks (running and completed). This returns the full task history for the current session. Note: Tasks are stored in memory and will be cleared on server restart.

Start a new automation task

Start a new lead scraping automation task. The task runs in the background and scrapes Google Maps for businesses matching your criteria. **How it works:** 1. Provide an industry keyword (e.g., "restaurants", "gyms") 2. Specify one or more locations to search 3. Optionally set a limit per location The task will run asynchronously and you can monitor its progress using the `/automation/tasks/{task_id}` endpoint.