Skip to main content
POST
/
v1
/
tasks
Add Tasks
curl --request POST \
  --url https://api.lobstr.io/v1/tasks \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "squid": "<string>",
  "tasks": [
    {}
  ],
  "tasks[].url": "<string>"
}
'
Add URLs or inputs to your Realtor Listings Scraper squid. Each task object must include the required fields below.

​
Headers

​
Authorization
string
required
Your API authentication token. Value: Token YOUR_API_KEY
​
Content-Type
string
required
Must be application/json. Value: application/json

​
Body

​
squid
string
required
Hash ID of your squid.
​
tasks
array
required
Array of task objects. Each task supports the fields below.

​
Task Fields

​
tasks[].url
string
required
A realtor.com search URL. Example: https://www.realtor.com/realestateandhomes-search/California/pg-5

​
Code Examples

curl -X POST "https://api.lobstr.io/v1/tasks" \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "squid": "YOUR_SQUID_HASH",
    "tasks": [
      { "url": "https://www.realtor.com/realestateandhomes-search/California" },
      { "url": "https://www.realtor.com/realestateandhomes-search/New-York" }
    ]
  }'

​
Response

200
{
  "duplicated_count": 0,
  "tasks": [
    {
      "id": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
      "created_at": "2025-06-24T11:11:30.222467",
      "is_active": true,
      "params": {
        "url": "https://www.realtor.com/realestateandhomes-search/California"
      },
      "object": "task"
    }
  ]
}