POST/v1/tasks

Add Tasks

Add Bien'Ici search URLs to scrape real estate listings

Add Bien'Ici search URLs to scrape French real estate listings. The scraper extracts comprehensive property details including pricing, location, amenities, energy performance ratings, and agency information from bienici.com.

Headers

Key	Value	Required
Authorization	Token YOUR_API_KEY	Yes
Content-Type	application/json	Yes

Request Body

squid

Type:

string

Required:

Yes

Description:

Hash of your squid configured with the Bien'Ici Search Export crawler

tasks

Type:

array

Required:

Yes

Description:

Array of task objects, each containing a `url` field

Task Object

url

Type:

string

Required:

Yes

Description:

Bien'Ici search URL (e.g., `https://www.bienici.com/recherche/achat/bouches-du-rhone-13/maisonvilla`)

Pro Tip

Perform your search on bienici.com first, apply all filters (location, property type, price range), then copy the URL to preserve all search parameters.

Note

Bien'Ici is a French real estate aggregator platform - URLs follow the pattern `https://www.bienici.com/recherche/{transaction}/{location}/{property-type}`.

Pro Tip

The URL supports various transaction types: `achat` (buy), `location` (rent), and property types like `maisonvilla`, `appartement`, etc.