Skip to content
Examples

Add Tasks

Add Leboncoin listing URLs to send automated messages

The v1 API, for batchesSquids, tasks and runs: many calls on a schedule, delivered where you work. For one call that answers in seconds, use the API v2.
POSThttps://api.lobstr.io/v1/tasks

Add Leboncoin listing URLs to send automated messages to sellers. Each task represents a listing that will receive your templated message.

Unlike search export scrapers, this tool takes direct listing URLs rather than search result pages. You can obtain listing URLs from the Leboncoin Listings Search Export scraper results.

This scraper requires a synced Leboncoin account. Link one to your squid before running.
Crawler ID: fa9c988768a3d61f358916400f3c4b65

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Content-Typestringheaderrequired

Request body format. Value: application/json

Request Body

Field Type Required Description
squid string Yes Hash of your squid configured with the Leboncoin Auto Message Sender crawler
tasks array Yes Array of task objects, each containing a url field

Task Object

Field Type Required Description
url string Yes Direct Leboncoin listing URL (e.g., https://www.leboncoin.fr/ad/locations/2943434204)

Use the Leboncoin Listings Search Export scraper to collect listing URLs, then pass them to this tool for messaging.

Ensure you have configured your message template in the squid settings before adding tasks.

Messages are only sent to listings where the seller has messaging enabled.

Code Examples

curl -X POST "https://api.lobstr.io/v1/tasks" \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "tasks": [
      {
        "url": "https://www.leboncoin.fr/ad/locations/2943434204"
      }
    ],
    "squid": "YOUR_SQUID_HASH"
  }'

Response

200
{
  "duplicated_count": 0,
  "tasks": [
    {
      "id": "bbeff62182c6239a8df533ec9d281c2e",
      "created_at": "2025-07-04T04:57:45.202264",
      "is_active": true,
      "params": {
        "url": "https://www.leboncoin.fr/ad/locations/2943434204"
      },
      "module": 103,
      "object": "task"
    }
  ]
}