Get Results
Retrieve scraped data from Leboncoin Messages Reader
https://api.lobstr.io/v1/resultsRetrieve 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
AuthorizationstringheaderrequiredYour API authentication token. Value: Token YOUR_API_KEY.
Query Parameters
squidstringqueryrequiredHash of the squid to get results from.
pageintegerqueryPage number (default: 1).
Result Fields
message_idstringUnique identifier of the message on Leboncoin.
message_texttextFull text of the message, line breaks preserved.
message_typestringMessage kind as returned by Leboncoin: ApiTextMessage for a regular message, ApiTemplateMessage for a templated one.
template_idstringIdentifier of the Leboncoin message template when the message was sent from a template, empty otherwise.
message_sent_atdatetimeDate and time (UTC) the message was sent.
directionstringreceived when the message was written by the other party, sent when it was written by the connected Leboncoin account.
is_outgoingbooleanTrue when the message was sent by the connected Leboncoin account.
is_readbooleanTrue when the message has been read by the connected Leboncoin account.
is_partner_readbooleanTrue when the other party has read the message (read receipt on messages you sent).
attachments_countintegerNumber of files attached to the message.
attachmentsjsonRaw attachment objects attached to the message, as returned by Leboncoin.
sender_idstringLeboncoin user id of the message sender.
sender_namestringDisplay name of the message sender.
conversation_idstringUnique identifier of the conversation the message belongs to.
conversation_urlstringDirect URL of the conversation in the Leboncoin messaging inbox.
annonce_idstringIdentifier 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_titlestringTitle of the listing the conversation is about.
ad_statusstringCurrent status of the listing: active or deleted.
ad_category_idstringLeboncoin category id of the listing (e.g. 9 = Ventes immobilières).
ad_imagestringThumbnail image of the listing.
ad_owner_idstringLeboncoin user id of the listing owner.
ad_owner_typestringType of the listing owner, private for a private seller. Empty when Leboncoin does not return it.
counterparty_idstringLeboncoin user id of the other party in the conversation.
counterparty_namestringDisplay name of the other party in the conversation.
last_message_sent_atdatetimeDate and time (UTC) of the most recent message of the conversation at collection time.
last_message_previewtextPreview of the most recent message of the conversation at collection time.
last_message_attachments_countintegerNumber of files attached to the most recent message of the conversation.
unseen_counterintegerNumber of unread messages in the conversation at collection time.
is_unreadbooleanTrue 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
{"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"}]}