Piloterr

SeLoger Agency Sale

GET
/v2/seloger/agency/sale

Retrieve paginated for-sale listings published by a SeLoger agency from its agency ID, profile URL or legacy numeric ID.

Credit cost: 3 credits per call

Authorization

ApiKeyAuth
headerx-api-key<token>

Your API key. Include it in the x-api-key header for every request.

Query Parameters

query*string

The SeLoger agency to list, as one of:

  • SeLoger agency ID (fastest), for example 7RznN5meLVFjnybjBiLYAD: the id returned by /v2/seloger/agency
  • Agency profile URL, for example https://www.seloger.com/professionnels-immobilier/7RznN5meLVFjnybjBiLYAD
  • Legacy numeric agency ID, for example 21719

Example:

7RznN5meLVFjnybjBiLYAD
page?number

Page number, 20 listings per page. A page past the last one returns an empty results array.

Default: 1

Default"1"
fields?string

Comma-separated list of response fields to return, with dot notation for nested fields (e.g. name,location.city).

is_async?boolean

Run the request as a background job: the API answers 202 with a job_id to poll on GET /v1/jobs/{id}.

Defaultfalse
soft_fail?boolean

Return HTTP 200 even when the request fails; the error is in the error field of the body.

Defaultfalse

Response Body

Successful response

application/json
  1. response
results?array<>
agency_id?string
pagination?
Example Request
curl -X GET 'https://api.piloterr.com/v2/seloger/agency/sale?query=string'
Example Response
{  "results": [    {      "id": "263NS6YGF4GJ",      "cps": "263NS6YGF4GJ",      "url": "https://www.seloger.com/annonce/achat/occitanie/haute-garonne-31/vigoulet-auzil-31320/263NS6YGF4GJ",      "tags": {        "is_new": false,        "has3_d_visit": false,        "is_exclusive": false,        "has_brokerage_fee": false      },      "type": "PROFESSIONAL",      "brand": "seloger",      "portal": "seloger",      "status": "Published",      "ab_test": {},      "display": "classified",      "gallery": {        "images": [          {            "alt": "Maison de plain-pied à vendre 625 000 € 6 pièces 5 chambres 211,5 m² 1 890 m² de terrain Vigoulet-Auzil 31320",            "key": "ff44d001-0d13-4eca-92d5-0161b6697ab8",            "url": "https://cdnihddipa.cloudimg.io/f/f/4/4/ff44d001-0d13-4eca-92d5-0161b6697ab8.jpg?ci_seal=d0ce701cae55fec0fc51b6f4645402cc3cdd77b6",            "classification": {              "name": "HOUSE_FACADE"            }          },          {            "key": "93a9cf5a-ae9d-4b0c-bab7-749e81015d8f",            "url": "https://cdnihddipa.cloudimg.io/9/3/a/9/93a9cf5a-ae9d-4b0c-bab7-749e81015d8f.jpg?ci_seal=1aeffee73a3d1adb3b41e699f42386d08564a3e5",            "classification": {              "name": "LIVING_ROOM"            }          }        ]      },      "location": {        "address": {          "city": "Vigoulet-Auzil",          "country": "France",          "zip_code": "31320"        },        "is_address_published": false      },      "metadata": {        "id": "263NS6YGF4GJ",        "status": {          "status": "Ready",          "enrichments": {            "geo": true,            "media": true,            "online_id": true,            "intermediary": true,            "contact_settings": true          }        },        "legacy_id": "265376927",        "update_date": "2026-11-02T12:16:12.292Z",        "creation_date": "2026-04-03T15:01:00Z"      },      "provider": {        "address": "43 avenue de Toulouse, 31320 Castanet Tolosan",        "imprint_url": null,        "profile_url": "https://www.seloger.com/professionnels-immobilier/7RznN5meLVFjnybjBiLYAD",        "agency_strip": {          "font_color": "#FFFFFF",          "agency_color": "#107070"        },        "contact_card": {          "title": null,          "display": false,          "logo_url": null,          "subtitle": "Votre contact"        },        "display_links": true,        "phone_numbers": [          "+33100000000"        ],        "publisher_type": "AGENCY",        "is_private_owner": false,        "intermediary_card": {          "title": "L'ADRESSE CASTANET TOLOSAN",          "display": true,          "logo_url": "https://cdnihddipa.cloudimg.io/d/2/c/6/d2c6d6da-1d0c-4892-9839-a0054cf5dbe8.jpg?ci_seal=a02fce31acfc7f9d1149ced636461a5588c40d14",          "subtitle": "Proposé par une agence immobilière",          "logo_href": "https://www.seloger.com/professionnels-immobilier/7RznN5meLVFjnybjBiLYAD"        },        "agency_legal_informations": [          "BH IMMOBILIER",          "<b>Siège:</b> 43 AVENUE DE TOULOUSE, 31320 CASTANET TOLOSAN"        ]      },      "raw_data": {        "price": 625000,        "nbroom": 6,        "surface": {          "main": 211.46,          "plot": 1890        },        "nbbedroom": 5,        "providercity": "Castanet Tolosan",        "property_type": "HOUSE",        "providerzipcode": "31320",        "geo_id_hierarchy": [          {            "id": "AD08FR12558",            "type_key": "AD08"          },          {            "id": "AD06FR32",            "type_key": "AD06"          }        ],        "distribution_type": "BUY",        "property_sub_type": "BUNGALOW",        "property_type_label": "Maison",        "offerer_marketing_key": "JEB3731",        "contact_location_enabled": false      },      "tracking": {        "id": "263NS6YGF4GJ",        "city": "Vigoulet-Auzil",        "name": "classified",        "price": 625000,        "region": "Occitanie",        "country": "France",        "currency": "EUR",        "province": "Haute-Garonne",        "zip_code": "31320",        "client_id": "RC-079919",        "legacy_id": "265376927",        "list_name": "classified_detail_similars_bottom",        "estate_type": "av_5",        "product_type": "standard",        "distribution_type": "2",        "energy_certificate": "C"      },      "hard_facts": {        "facts": [          {            "type": "numberOfRooms",            "label": "pièces",            "value": "6 pièces",            "split_value": "6"          },          {            "type": "numberOfBedrooms",            "label": "chambres",            "value": "5 chambres",            "split_value": "5"          }        ],        "price": {          "value": "625 000 €",          "formatted": "625 000 €",          "aria_label": "625000 €",          "financial_link": {            "href": "https://e-immobilier.credit-agricole.fr/pret/lp_acquisition.html?ORI=EDESLAT&at_medium=affiliation&at_campaign=EDE_PC_EMP_EIMMO_FR&at_presta=SeLoger&at_format=Lien_PDD",            "label": "Demander un financement",            "partner_name": "CA"          },          "additional_information": "2 956 €/m²"        },        "title": "Maison de plain-pied à vendre",        "keyfacts": [          "6 pièces",          "5 chambres"        ],        "short_title": "Maison de plain-pied"      },      "energy_class": "C",      "card_provider": {        "title": null,        "logo_url": null,        "subtitle": "Votre contact",        "agency_strip": {          "font_color": "#FFFFFF",          "agency_color": "#107070"        }      },      "legacy_tracking": {        "id": "265376927",        "media": 0,        "price": 625000,        "space": 211.46,        "id_duo": 265376927,        "id_solo": 265376927,        "nb_rooms": 6,        "position": 0,        "client_id": "RC-079919",        "list_name": "detail",        "photos_nb": 15,        "client_type": "pro",        "estate_type": 21,        "nb_bedrooms": 5,        "parent_site": "SL",        "product_type": "estate",        "energy_letter": "C",        "product_variant": "classified",        "distribution_type": "2",        "estate_postalcode": "31320",        "product_geolocation": "localisation_city",        "year_of_construction": 1990      },      "main_description": {        "headline": "Maison Vigoulet Auzil 6 pièce(s) 211.46 m2",        "description": "Maison d'architecte à vendre. Vigoulet-Auzil Située dans un environnement calme et verdoyant, cette maison d'architecte unique saura vous séduire par son charme, sa luminosité et ses volumes généreux. Dès l'entrée, vous découvrirez des espaces de vie baignés de lumière naturelle, sublimés par de superbes verrières et une conception pensée pour le confort au quotidien. Le séjour, spacieux et lumine…"      },      "has_a_i_enrichment": true    },    {      "id": "26B216SDWNCU",      "cps": "26B216SDWNCU",      "url": "https://www.seloger.com/annonce/achat/occitanie/haute-garonne-31/toulouse-31000/26B216SDWNCU",      "tags": {        "is_new": false,        "has3_d_visit": false,        "is_exclusive": true,        "has_brokerage_fee": false      },      "type": "PROFESSIONAL",      "brand": "seloger",      "portal": "seloger",      "status": "Published",      "ab_test": {},      "display": "classified",      "gallery": {        "images": [          {            "alt": "Appartement à vendre 209 900 € 3 pièces 2 chambres 59 m² RDC/2 Toulouse 31400",            "key": "d559c49c-d7bd-4357-8cd1-6a7721b13dc0",            "url": "https://cdnihddipa.cloudimg.io/d/5/5/9/d559c49c-d7bd-4357-8cd1-6a7721b13dc0.jpg?ci_seal=80b3d914d3b7242cdce6927692f08d52ffe38f74",            "classification": {              "name": "YARD"            }          },          {            "key": "b776da2e-7350-4168-a6f5-6d2a56b9e56c",            "url": "https://cdnihddipa.cloudimg.io/b/7/7/6/b776da2e-7350-4168-a6f5-6d2a56b9e56c.jpg?ci_seal=f41f21ae35ba675b7d2a69af58dfbc03e9070946",            "classification": {              "name": "LIVING_ROOM"            }          }        ]      },      "location": {        "address": {          "city": "Toulouse",          "country": "France",          "district": "Montaudran - Lespinet",          "zip_code": "31400"        },        "is_address_published": false      },      "metadata": {        "id": "26B216SDWNCU",        "status": {          "status": "Ready",          "enrichments": {            "geo": true,            "media": true,            "online_id": true,            "intermediary": true,            "contact_settings": true          }        },        "legacy_id": "264704127",        "update_date": "2026-09-27T01:15:43.665Z",        "creation_date": "2026-03-27T16:01:00Z"      },      "provider": {        "address": "43 avenue de Toulouse, 31320 Castanet Tolosan",        "imprint_url": null,        "profile_url": "https://www.seloger.com/professionnels-immobilier/7RznN5meLVFjnybjBiLYAD",        "agency_strip": {          "font_color": "#FFFFFF",          "agency_color": "#107070"        },        "contact_card": {          "title": null,          "display": false,          "logo_url": null,          "subtitle": "Votre contact"        },        "display_links": true,        "phone_numbers": [          "+33100000000"        ],        "publisher_type": "AGENCY",        "is_private_owner": false,        "intermediary_card": {          "title": "L'ADRESSE CASTANET TOLOSAN",          "display": true,          "logo_url": "https://cdnihddipa.cloudimg.io/d/2/c/6/d2c6d6da-1d0c-4892-9839-a0054cf5dbe8.jpg?ci_seal=a02fce31acfc7f9d1149ced636461a5588c40d14",          "subtitle": "Proposé par une agence immobilière",          "logo_href": "https://www.seloger.com/professionnels-immobilier/7RznN5meLVFjnybjBiLYAD"        },        "agency_legal_informations": [          "BH IMMOBILIER",          "<b>Siège:</b> 43 AVENUE DE TOULOUSE, 31320 CASTANET TOLOSAN"        ]      },      "raw_data": {        "price": 209900,        "nbroom": 3,        "surface": {          "main": 59,          "plot": null        },        "nbbedroom": 2,        "providercity": "Castanet Tolosan",        "property_type": "APARTMENT",        "providerzipcode": "31320",        "geo_id_hierarchy": [          {            "id": "AD08FR12535",            "type_key": "AD08"          },          {            "id": "AD06FR32",            "type_key": "AD06"          }        ],        "distribution_type": "BUY",        "property_type_label": "Appartement",        "offerer_marketing_key": "RA9004",        "contact_location_enabled": false      },      "tracking": {        "id": "26B216SDWNCU",        "city": "Toulouse",        "name": "classified",        "price": 209900,        "region": "Occitanie",        "country": "France",        "currency": "EUR",        "province": "Haute-Garonne",        "zip_code": "31400",        "client_id": "RC-079919",        "legacy_id": "264704127",        "list_name": "classified_detail_similars_bottom",        "estate_type": "av_2",        "product_type": "standard",        "distribution_type": "2",        "energy_certificate": "A"      },      "hard_facts": {        "facts": [          {            "type": "numberOfRooms",            "label": "pièces",            "value": "3 pièces",            "split_value": "3"          },          {            "type": "numberOfBedrooms",            "label": "chambres",            "value": "2 chambres",            "split_value": "2"          }        ],        "price": {          "value": "209 900 €",          "formatted": "209 900 €",          "aria_label": "209900 €",          "financial_link": {            "href": "https://e-immobilier.credit-agricole.fr/pret/lp_acquisition.html?ORI=EDESLAT&at_medium=affiliation&at_campaign=EDE_PC_EMP_EIMMO_FR&at_presta=SeLoger&at_format=Lien_PDD",            "label": "Demander un financement",            "partner_name": "CA"          },          "additional_information": "3 558 €/m²"        },        "title": "Appartement à vendre",        "keyfacts": [          "3 pièces",          "2 chambres"        ],        "short_title": "Appartement"      },      "energy_class": "A",      "card_provider": {        "title": null,        "logo_url": null,        "subtitle": "Votre contact",        "agency_strip": {          "font_color": "#FFFFFF",          "agency_color": "#107070"        }      },      "legacy_tracking": {        "id": "264704127",        "media": 0,        "price": 209900,        "space": 59,        "id_duo": 264704127,        "id_solo": 264704127,        "nb_rooms": 3,        "position": 0,        "client_id": "RC-079919",        "list_name": "detail",        "photos_nb": 12,        "client_type": "pro",        "estate_type": 1,        "nb_bedrooms": 2,        "parent_site": "SL",        "product_type": "estate",        "energy_letter": "A",        "product_variant": "classified",        "distribution_type": "2",        "estate_postalcode": "31400",        "product_geolocation": "localisation_city",        "year_of_construction": 2021      },      "main_description": {        "headline": "Appartement Toulouse Proche Labège 3 pièce(s) 59 m² au calme",        "description": "Coup de coeur assuré pour ce 3 pièces situé en rez-de-jardin d'une résidence récente de 2021 € Ce T3 entièrement rénové d'environ 60m² saura vous séduire par son environnement champêtre tout en étant à proximité des commodités. Il se compose d'une entrée avec placard, d'un séjour avec une cuisine américaine aménagée et équipée donnant sur une terrasse couverte avec un jardin privatif , de deux cha…"      },      "has_a_i_enrichment": true    }  ],  "agency_id": "7RznN5meLVFjnybjBiLYAD",  "pagination": {    "next": 2,    "current": 1,    "per_page": 20,    "total_pages": 2,    "has_next_page": true,    "total_results": 25  }}