Skip to content
Examples

Get Results

Retrieve scraped data from Leboncoin Messages Reader

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.
GEThttps://api.lobstr.io/v1/results

Retrieve scraped data from your Leboncoin Messages Reader runs. One row per message, with the conversation, the listing and the other party on every row.

Headers

Authorizationstringheaderrequired

Your API authentication token. Value: Token YOUR_API_KEY.

Query Parameters

squidstringqueryrequired

Hash of the squid to get results from.

pageintegerquery

Page number (default: 1).

Result Fields

message_idstring

Unique identifier of the message on Leboncoin.

message_texttext

Full text of the message, line breaks preserved.

message_typestring

Message kind as returned by Leboncoin: ApiTextMessage for a regular message, ApiTemplateMessage for a templated one.

template_idstring

Identifier of the Leboncoin message template when the message was sent from a template, empty otherwise.

message_sent_atdatetime

Date and time (UTC) the message was sent.

directionstring

received when the message was written by the other party, sent when it was written by the connected Leboncoin account.

is_outgoingboolean

True when the message was sent by the connected Leboncoin account.

is_readboolean

True when the message has been read by the connected Leboncoin account.

is_partner_readboolean

True when the other party has read the message (read receipt on messages you sent).

attachments_countinteger

Number of files attached to the message.

attachmentsjson

Raw attachment objects attached to the message, as returned by Leboncoin.

sender_idstring

Leboncoin user id of the message sender.

sender_namestring

Display name of the message sender.

conversation_idstring

Unique identifier of the conversation the message belongs to.

conversation_urlstring

Direct URL of the conversation in the Leboncoin messaging inbox.

annonce_idstring

Identifier of the Leboncoin listing the conversation is about. Same identifier as the annonce_id of the Leboncoin Auto Message Sender, so replies can be joined back to the messages sent.

ad_titlestring

Title of the listing the conversation is about.

ad_statusstring

Current status of the listing: active or deleted.

ad_category_idstring

Leboncoin category id of the listing (e.g. 9 = Ventes immobilières).

ad_imagestring

Thumbnail image of the listing.

ad_owner_idstring

Leboncoin user id of the listing owner.

ad_owner_typestring

Type of the listing owner, private for a private seller. Empty when Leboncoin does not return it.

counterparty_idstring

Leboncoin user id of the other party in the conversation.

counterparty_namestring

Display name of the other party in the conversation.

last_message_sent_atdatetime

Date and time (UTC) of the most recent message of the conversation at collection time.

last_message_previewtext

Preview of the most recent message of the conversation at collection time.

last_message_attachments_countinteger

Number of files attached to the most recent message of the conversation.

unseen_counterinteger

Number of unread messages in the conversation at collection time.

is_unreadboolean

True when the conversation had at least one unread message at collection time.

Code Examples

curl -G https://api.lobstr.io/v1/results \
  -H "Authorization: Token YOUR_API_KEY" \
  -d "squid=YOUR_SQUID_HASH" \
  -d "page=1"

Response

200
{"total_results": 1, "data": [{"message_id": "b07ce020-6be6-11f1-8080-808080808080", "message_text": "Hello Sasha, toutes les infos utiles sont dans l'annonce !\nMichel.", "message_type": "ApiTextMessage", "message_sent_at": "2026-06-19T13:56:37.282000+00:00", "direction": "received", "is_outgoing": false, "is_read": true, "conversation_id": "c2d7efff-5f3e-4898-8d49-979f94260003", "conversation_url": "https://www.leboncoin.fr/messages/id/c2d7efff-5f3e-4898-8d49-979f94260003", "annonce_id": "3196445542", "ad_title": "Maison individuelle de plein-pied proche Louhans", "counterparty_name": "deschamps"}]}