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>'
Add SeLoger search URLs to scrape French real estate listings. The scraper extracts property details including pricing, area, location, agency information, and energy ratings.

​
Headers

​
Authorization
string
required
Your API authentication token. Value: Token YOUR_API_KEY
​
Content-Type
string
required
Request body format. Value: application/json

​
Request Body

FieldTypeRequiredDescription
squidstringYesHash of your squid configured with the SeLoger Search Export crawler
tasksarrayYesArray of task objects, each containing a url field

​
Task Object

FieldTypeRequiredDescription
urlstringYesSeLoger search URL (e.g., https://www.seloger.com/list.htm?projects=2&places=...)
Perform your search on SeLoger.com first, apply all filters (location, property type, price range), then copy the URL to preserve all parameters.
SeLoger is a French real estate platform - URLs contain encoded location and filter parameters.

​
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.seloger.com/list.htm?projects=2&places=%5B%7B%22subDivisions%22:%5B%2210%22%5D%7D%5D&mandatorycommodities=0&enterprise=1&qsVersion=1.0"
      }
    ]
  }'

​
Response

200
{
  "duplicated_count": 0,
  "tasks": [
    {
      "id": "fa0df9f38046ae68a04117ed96652005",
      "created_at": "2025-07-17T08:55:52.537282",
      "is_active": true,
      "params": {
        "url": "https://www.seloger.com/list.htm?projects=2&places=%5B%7B%22subDivisions%22:%5B%2210%22%5D%7D%5D&mandatorycommodities=0&enterprise=1&qsVersion=1.0"
      },
      "module": 13,
      "object": "task"
    }
  ]
}