Skip to main content
POST
/
v2
/
squid
/
{squid_id}
/
task
Add Tasks
curl --request POST \
  --url https://api.lobstr.io/v2/squid/{squid_id}/task \
  --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 LaCentrale search or listing URLs as tasks to your squid. The scraper will extract all vehicle listings matching your search criteria from the French automotive marketplace.

​
Headers

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

​
URL Format

Use LaCentrale listing URLs with your desired search filters: https://www.lacentrale.fr/listing?yearMin=2025 https://www.lacentrale.fr/listing?makesModelsCommercialNames=PEUGEOT Build your search on lacentrale.fr with filters (make, model, year, price, etc.) and copy the URL.

​
Request Body

FieldTypeRequiredDescription
urlstringYesLaCentrale search or category URL
Apply filters on lacentrale.fr (make, model, year, price range, location) to target specific vehicle segments.
LaCentrale limits search results to 347 pages maximum per URL. Use multiple filtered searches for comprehensive coverage.
Use the fetch_since setting to only scrape recently added listings for monitoring new inventory.

​
Code Examples

curl -X POST "https://api.lobstr.io/api/v2/squid/YOUR_SQUID_ID/task" \
  -H "Authorization: Token YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.lacentrale.fr/listing?yearMin=2024&makesModelsCommercialNames=PEUGEOT"
  }'

​
Response

200
{
  "id": "task_abc123def456",
  "status": "pending",
  "created_at": "2025-01-15T10:30:00Z",
  "url": "https://www.lacentrale.fr/listing?yearMin=2024&makesModelsCommercialNames=PEUGEOT"
}