Skip to content
Examples

Update Settings

Configure scraper settings for Leboncoin Listings & Phone Search Export

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/squids/{squid_hash}

Configure your squid settings for the Leboncoin Listings & Phone Search Export scraper. This scraper extends the standard Leboncoin scraper with phone number extraction capabilities.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY

Content-Typestringheaderrequired

Request body format. Value: application/json

Phone Extraction Parameter

Enable phone number extraction:

Parameter Type Default Description
functions.get_phone_numbers boolean true Extract phone numbers from listings (6 credits per listing)

Scraper Parameters

Set these parameters in the params object:

Parameter Type Default Description
fetch_since string null Stop scraping when items older than this threshold are reached (based on last_publication_date). Use a relative duration (24h, 7d, 2w) or an absolute date (YYYY-MM-DD HH:MM:SS)
fetch_since_timezone string null Timezone for interpreting an absolute fetch_since date (e.g. Europe/Paris). Only applies when fetch_since is an absolute date — ignored for relative values like 24h or 7d. See supported timezones.
max_pages integer null Maximum number of result pages to crawl
max_results integer null Total number of listings to collect before stopping
max_unique_results_per_run integer null Maximum unique results across all tasks in a single run
online_shop boolean false Extract seller's shop URL (incurs extra requests/credits)

Squid Settings

Configure general squid settings:

Setting Type Description
name string Display name for your squid configuration
concurrency integer Number of parallel scraping workers (default: 1)
export_unique_results boolean Export only unique results (deduplicated)
to_complete boolean Run until all tasks complete
no_line_breaks boolean Remove line breaks from results

Enabling functions.get_phone_numbers adds extra requests per listing, significantly increasing run time and credit usage.

Only enable phone extraction when phone numbers are actually required for your use case.

Phone numbers are only available when the seller has enabled phone contact on their listing.

Code Examples

curl -X POST "https://api.lobstr.io/v1/squids/YOUR_SQUID_HASH" \
  -H "Authorization: Token YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Leboncoin Listings & Phone Search Export (1)",
    "concurrency": 1,
    "export_unique_results": true,
    "to_complete": false,
    "no_line_breaks": true,
    "params": {
      "functions": {
        "get_phone_numbers": true
      },
      "max_pages": 99,
      "fetch_since": null,
      "max_results": null,
      "online_shop": true
    }
  }'

Response

201
{
  "name": "Leboncoin Listings & Phone Search Export (1)",
  "no_line_breaks": true,
  "params": {
    "functions": {
      "get_phone_numbers": true
    },
    "max_pages": 99,
    "fetch_since": null,
    "max_results": null,
    "online_shop": true
  },
  "to_complete": false,
  "export_unique_results": true
}