Skip to content
Examples

Add Tasks

Add Leboncoin search URLs to scrape listings with phone numbers

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

Crawler ID: 7bc4acdb18f2b90fdd5eb42b8e8251e9

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 Listings & Phone Search Export crawler
tasks array Yes Array of task objects, each containing a url field

Task Object

Field Type Required Description
url string Yes Leboncoin 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"
    }
  ]
}