scrapeunblocker-leboncoin-search

n8n community node for the Leboncoin Search Scraper Apify Actor by ScrapeUnblocker: French classified ads with price, location, category, date, attributes and URL as JSON

Package Information

Released: this month
Downloads: 0 weekly / 0 monthly
Latest Version: 0.1.2
Author: ScrapeUnblocker

Documentation

n8n-nodes-scrapeunblocker-leboncoin-search

This is an n8n community node. It lets you search Leboncoin classified ads in France in your n8n workflows and get them as JSON: title, price, city, postcode, department, region, category, date, attributes, image and a direct ad URL.

The node runs the Leboncoin Search Scraper Actor by ScrapeUnblocker on the Apify platform with your own Apify account, waits for the run to finish and returns every scraped record as an n8n item.

n8n is a fair-code licensed workflow automation platform.

Installation
Credentials
Operations
Output
Example workflow
Pricing
Compatibility
Resources
Version history

Installation

Follow the installation guide in the n8n community nodes documentation. The npm package name is n8n-nodes-scrapeunblocker-leboncoin-search.

Credentials

The node authenticates with an Apify API token. Every run starts on the Apify account that owns the token and is billed to that account (see Pricing).

1. Create an Apify account (skip if you already have one)

  1. Go to console.apify.com/sign-up and sign up with email, Google or GitHub.
  2. Confirm your email address if Apify asks you to.

The free Apify plan needs no credit card and includes a monthly usage credit, which is enough to try the node. Current plan limits are listed on apify.com/pricing.

2. Get your API token

  1. Open Apify Console and go to Settings → API & Integrations, or open console.apify.com/settings/integrations directly.
  2. Find the Personal API tokens section.
  3. Either use the existing token (the one marked Default API token created on sign up): click the eye icon to reveal it or the copy icon to copy it.
  4. Or create a dedicated token for n8n (recommended, so you can revoke it without affecting anything else):
    1. Click + Add new token (the button may read Create new token).
    2. In the Create a new personal API token dialog, enter a Description such as n8n.
    3. Optionally switch on Set expiration date and pick a date.
    4. Leave Limit token permissions switched off. A token with limited permissions may not be allowed to run this Actor or read its results.
    5. Click Create and copy the new token.

The token starts with apify_api_. Treat it like a password: anyone who has it can run Actors on your account. You can revoke or rotate it on the same page at any time.

Working in an Apify organization? Switch to the organization in Apify Console first and copy a token from its API & Integrations page, so runs are billed to the organization.

3. Add the credential in n8n

  1. Add the Leboncoin Search Scraper node to a workflow and open it.
  2. In Credential to connect with, choose Create new credential. (You can also create an Apify API credential from the n8n credentials list.)
  3. Paste the token into API Key and click Save. n8n checks the token right away; an invalid token shows Authorization failed - please check your credentials.

Already have an Apify API credential in n8n (for example from the official Apify node)? This node uses the same credential type, so you can simply select it.

Operations

Pick a Resource and an Operation. Each n8n input item starts one Apify run. List fields accept several values separated by commas or new lines, or an array returned by an expression.

Resource Operation Fields Returns
Listing Search Search Query (required) - What to search for, e.g. 'velo electrique' or 'iphone 13'
Max Results - How many listings to collect across pages (35 per page, up to 500)
One item per listing

Options

Option Description
Category Only listings in this Leboncoin category
Include Sponsored Whether to also return Leboncoin's paid 'à la une' placements (marked sponsored). Off by default: Leboncoin shows the same few on every page regardless of the query, category and sort.
Location Where to search: a city ('Bordeaux'), a city with postcode ('Toulouse 31000'), a department code ('75') or a region ('Ile-de-France')
Max Price (EUR) Highest price to include, in EUR
Min Price (EUR) Lowest price to include, in EUR
Sort By Result ordering
Start Page Results page to start from (1 is the first page)
Timeout (Seconds) Maximum run time of the Apify run. 0 keeps the Actor default. A run that times out fails the node.

How a run works

  1. The node starts the Actor on your Apify account with the fields you set.
  2. It waits for the run to finish.
  3. It returns every record from the run's dataset as a separate n8n item.

The run is also visible in Apify Console under Runs. If a run fails or times out, the node error links to the run log and tells you whether any results were saved before it stopped.

Stopping the n8n execution only stops the node from waiting: the Apify run keeps going and its results are still charged. To stop it, abort the run in Apify Console under Runs, and use Timeout (Seconds) to cap long runs up front.

Use as an AI Agent tool

The node can be attached to an n8n AI Agent as a tool, so the agent can call it on its own.

Output

  • One item per listing, with ID, title, price, city, postcode, department and region, category, publication date, seller type (and name for professional sellers), attributes such as condition or surface, image and listing URL.
  • Promoted listings that Leboncoin mixes into the results are returned too, flagged with sponsored: true; they do not always match the search query or filters.
  • Paid 'à la une' placements are left out unless you turn on Include Sponsored.

Fields of a returned item: id, title, price, currency, location, city, zipcode, department, region, category, categoryId, date, image, url, sellerType, sponsored, attributes.

Example item (shortened):

{
  "id": "3272825793",
  "title": "Velo electrique",
  "price": 80,
  "currency": "EUR",
  "location": "Vieux-Boucau-les-Bains 40480",
  "city": "Vieux-Boucau-les-Bains",
  "zipcode": "40480",
  "department": "Landes",
  "region": "Aquitaine",
  "category": "Vélos",
  "categoryId": "55",
  "date": "2026-09-19 18:58:53",
  "image": "https://img.leboncoin.fr/api/v1/lbcpb1/images/16/23/4a/16234a8c4c700dadf04676...",
  "url": "https://www.leboncoin.fr/ad/velos/3272825793",
  "...": "..."
}

Example workflow

To try the node in a minute, copy the workflow below, paste it into the n8n editor (Ctrl+V / Cmd+V), open the Leboncoin Search Scraper node, select your Apify API credential and click Execute workflow.

{
  "nodes": [
    {
      "parameters": {},
      "name": "When clicking 'Execute workflow'",
      "type": "n8n-nodes-base.manualTrigger",
      "typeVersion": 1,
      "position": [
        0,
        0
      ]
    },
    {
      "parameters": {
        "resource": "listing",
        "operation": "search",
        "query": "velo electrique",
        "maxResults": 5,
        "options": {}
      },
      "name": "Leboncoin Search Scraper",
      "type": "n8n-nodes-scrapeunblocker-leboncoin-search.leboncoinSearchScraper",
      "typeVersion": 1,
      "position": [
        220,
        0
      ]
    }
  ],
  "connections": {
    "When clicking 'Execute workflow'": {
      "main": [
        [
          {
            "node": "Leboncoin Search Scraper",
            "type": "main",
            "index": 0
          }
        ]
      ]
    }
  }
}

Pricing

The node itself is free. The Actor is paid per result on Apify: $0.70 per 1,000 listings plus a tiny start fee per run ($0.00005), charged to the Apify account of your token. Every item the node returns counts as one result. The current price is always shown on the Actor page, and your spending is visible in Apify Console.

Compatibility

Tested with n8n 2.40 (self-hosted).

Resources

Version history

  • 0.1.0: Initial release
  • 0.1.1: First release published from GitHub Actions with an npm provenance statement
  • 0.1.2: Include Sponsored option - paid ad placements are left out by default

Discussion