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>'

Documentation Index

Fetch the complete documentation index at: https://docs.lobstr.io/llms.txt

Use this file to discover all available pages before exploring further.

Add Leboncoin search result pages to scrape by providing search URLs. This scraper extracts all classified listings including phone numbers when available. This scraper is identical to Leboncoin Listings Search Export but adds phone number extraction capabilities.

​
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 Leboncoin Listings & Phone Search Export crawler
tasksarrayYesArray of task objects, each containing a url field

​
Task Object

FieldTypeRequiredDescription
urlstringYesLeboncoin search URL (e.g., https://www.leboncoin.fr/annonces/offres/provence_alpes_cote_d_azur/)
Apply filters on Leboncoin first, then copy the URL. All filter parameters will be preserved.
Phone extraction requires enabling functions.get_phone_numbers in the settings and incurs extra credits.

​
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/annonces/offres/provence_alpes_cote_d_azur/bouches_du_rhone/p-2"
      }
    ],
    "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/annonces/offres/provence_alpes_cote_d_azur/bouches_du_rhone/p-2"
      },
      "module": 103,
      "object": "task"
    }
  ]
}