Skip to main content
POST
/
v1
/
squids
/
{squid_hash}
Update Settings
curl --request POST \
  --url https://api.lobstr.io/v1/squids/{squid_hash} \
  --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.

Configure your LaCentrale Cars Scraper squid settings. Control pagination, result limits, time filters, and whether to fetch detailed listing information.

​
Headers

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

​
Scraper Parameters

Set these parameters in the params object:
ParameterTypeDefaultDescription
max_pagesinteger347Maximum pages to scrape per task (max: 347)
max_resultsintegerunlimitedMaximum results per task
max_unique_results_per_runintegerunlimitedMaximum unique results across all tasks
fetch_sincestringnullStop scraping when items older than this threshold are reached (based on first_online_date). Use a relative duration (24h, 7d, 2w) or an absolute date (YYYY-MM-DD HH:MM)
fetch_since_timezonestringnullTimezone 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.
get_listing_detailsbooleantrueFetch detailed listing info (equipment, seller details)

​
Squid Settings

Configure general squid settings:
SettingTypeDescription
namestringDisplay name for your squid configuration
concurrencyintegerNumber of parallel scraping threads (default: 1)
export_unique_resultsbooleanExport only unique results (deduplicated)
to_completebooleanRun until all tasks complete
no_line_breaksbooleanRemove line breaks from results

​
Listing Details Option

When get_listing_details is enabled, the scraper visits each listing page to extract:
  • Full equipment list and options
  • Seller details (address, company info)
  • Technical specifications (CO2, power, fuel consumption)
  • Vehicle history links
Pricing: 4 credits per listing when details are enabled.

​
Fetch Since Filter

Use fetch_since to monitor new inventory. For example, setting fetch_since: 24h will stop scraping when it reaches listings older than 24 hours (based on first_online_date). Perfect for daily monitoring of new car listings.
Set get_listing_details: false if you only need basic listing data to reduce costs.
Enabling get_listing_details costs 4 additional credits per listing. Plan accordingly for large scrapes.
Use fetch_since: 12 for twice-daily monitoring to catch new listings without duplicates.
Backward compatibility: The old parameter name annonce_details is still accepted but deprecated. Migrate to get_listing_details.

​
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": "LaCentrale Cars Scraper (1)",
    "concurrency": 5,
    "export_unique_results": true,
    "to_complete": false,
    "no_line_breaks": true,
    "params": {
      "max_pages": 50,
      "fetch_since": "7d",
      "get_listing_details": true
    }
  }'

​
Response

201
{
  "name": "LaCentrale Cars Scraper (1)",
  "concurrency": 5,
  "export_unique_results": true,
  "to_complete": false,
  "no_line_breaks": true,
  "params": {
    "max_pages": 50,
    "fetch_since": "7d",
    "get_listing_details": true
  }
}