Piloterr

SeLoger Agency Rent

GET
/v2/seloger/agency/rent

Retrieve paginated rental 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/rent?query=string'
Example Response
{  "results": [    {      "id": "26UA1MYZK44A",      "cps": "26UA1MYZK44A",      "url": "https://www.seloger.com/annonce/location/occitanie/haute-garonne-31/toulouse-31000/26UA1MYZK44A",      "tags": {        "is_new": true,        "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": "Appartement à louer • Première occupation 890 €/mois 2 pièces 1 chambre 41 m² Étage 1/2 Toulouse 31000",            "key": "49888648-c594-41cd-8366-14ad4d0149aa",            "url": "https://cdnihddipa.cloudimg.io/4/9/8/8/49888648-c594-41cd-8366-14ad4d0149aa.jpg?ci_seal=3f287d80cc8ede5555c7dc263aad228440bd0d86",            "classification": {              "name": "LIVING_ROOM"            }          },          {            "key": "95172bde-6bdd-4796-81f5-9eb86bb0f763",            "url": "https://cdnihddipa.cloudimg.io/9/5/1/7/95172bde-6bdd-4796-81f5-9eb86bb0f763.jpg?ci_seal=988b243f133cc568ee7df71a182e3b41b71d58be",            "classification": {              "name": "LIVING_ROOM"            }          }        ]      },      "location": {        "address": {          "city": "Toulouse",          "country": "France",          "district": "Saint-Aubin - Dupuy",          "zip_code": "31000"        },        "is_address_published": false      },      "metadata": {        "id": "26UA1MYZK44A",        "status": {          "status": "Ready",          "enrichments": {            "geo": true,            "media": true,            "online_id": true,            "intermediary": true,            "contact_settings": true          }        },        "legacy_id": "286230363",        "update_date": "2026-11-17T02:36:13.569Z",        "creation_date": "2026-11-15T16:30: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": 890,        "nbroom": 2,        "surface": {          "main": 41,          "plot": null        },        "nbbedroom": 1,        "providercity": "Castanet Tolosan",        "property_type": "APARTMENT",        "providerzipcode": "31320",        "geo_id_hierarchy": [          {            "id": "AD08FR12535",            "type_key": "AD08"          },          {            "id": "AD06FR32",            "type_key": "AD06"          }        ],        "distribution_type": "RENT",        "property_type_label": "Appartement",        "offerer_marketing_key": "2278",        "contact_location_enabled": false      },      "tracking": {        "id": "26UA1MYZK44A",        "city": "Toulouse",        "name": "classified",        "price": 890,        "region": "Occitanie",        "country": "France",        "currency": "EUR",        "province": "Haute-Garonne",        "zip_code": "31000",        "client_id": "RC-079919",        "legacy_id": "286230363",        "list_name": "classified_detail_similars_bottom",        "estate_type": "av_2",        "product_type": "standard",        "building_state": "FIRST_TIME_USE",        "distribution_type": "1",        "energy_certificate": "C"      },      "hard_facts": {        "facts": [          {            "type": "numberOfRooms",            "label": "pièces",            "value": "2 pièces",            "split_value": "2"          },          {            "type": "numberOfBedrooms",            "label": "chambre",            "value": "1 chambre",            "split_value": "1"          }        ],        "price": {          "value": "890 €",          "formatted": "890 €/mois",          "modifiers": "/mois",          "aria_label": "890 €",          "unit_postfix": {            "unit_time": "/mois"          },          "charges_label": "cc",          "financial_link": {            "href": "https://www.selogerneuf.com/projet-invest/projet/type-bien/?utm_source=seloger&utm_campaign=medicis&utm_content=lien_prix_pdd",            "label": "Demander un financement",            "partner_name": "MEDICIS"          },          "additional_information": "charges comprises"        },        "title": "Appartement à louer • Première occupation",        "keyfacts": [          "2 pièces",          "1 chambre"        ],        "short_title": "Appartement"      },      "energy_class": "C",      "card_provider": {        "title": null,        "logo_url": null,        "subtitle": "Votre contact",        "agency_strip": {          "font_color": "#FFFFFF",          "agency_color": "#107070"        }      },      "legacy_tracking": {        "id": "286230363",        "media": 0,        "price": 890,        "space": 41,        "id_duo": 286230363,        "id_solo": 286230363,        "nb_rooms": 2,        "position": 0,        "client_id": "RC-079919",        "list_name": "detail",        "photos_nb": 6,        "client_type": "pro",        "estate_type": 1,        "nb_bedrooms": 1,        "parent_site": "SL",        "product_type": "estate",        "energy_letter": "C",        "product_variant": "classified",        "distribution_type": "1",        "estate_postalcode": "31000",        "product_geolocation": "localisation_city"      },      "main_description": {        "headline": "Appartement Toulouse 2 pièce(s) 41 m2",        "description": "TOULOUSE, en plein coeur du quartier JEAN JAURES, magnifique T2 de 41 m² entièrement rénové au 1er étage d'un petit immeuble de 6 lots: Entrée, pièce de vie avec cuisine ouverte équipée et aménagée, chambre avec placard, salle de bains et WC. A proximité immédiate des commerces et du métro. A visiter rapidement Loué meublé Copropriété de 6 lots - dont 5 lots habitation. (Pas de procédure en cours)…"      },      "has_a_i_enrichment": true    },    {      "id": "26B649HGJRCI",      "cps": "26B649HGJRCI",      "url": "https://www.seloger.com/annonce/location/occitanie/haute-garonne-31/castanet-tolosan-31320/26B649HGJRCI",      "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": "Appartement à louer 791,94 €/mois 3 pièces 2 chambres 58 m² Étage 1/2 Castanet-Tolosan 31320",            "key": "64dec4f8-b67c-4657-8844-fdcac19541a0",            "url": "https://cdnihddipa.cloudimg.io/6/4/d/e/64dec4f8-b67c-4657-8844-fdcac19541a0.jpg?ci_seal=1ce1def9f457d968f369128126a4c1e261070954",            "classification": {              "name": "KITCHEN"            }          },          {            "key": "7cb563e6-abed-496a-b7a8-b5c2260dc072",            "url": "https://cdnihddipa.cloudimg.io/7/c/b/5/7cb563e6-abed-496a-b7a8-b5c2260dc072.jpg?ci_seal=0a0e1eebdd87cbfe3c7607fc45f0bbb0e4751dc1",            "classification": {              "name": "KITCHEN"            }          }        ]      },      "location": {        "address": {          "city": "Castanet-Tolosan",          "country": "France",          "district": "Fontanelles",          "zip_code": "31320"        },        "is_address_published": false      },      "metadata": {        "id": "26B649HGJRCI",        "status": {          "status": "Ready",          "enrichments": {            "geo": true,            "media": true,            "online_id": true,            "intermediary": true,            "contact_settings": true          }        },        "legacy_id": "284665823",        "update_date": "2026-11-05T01:36:17.842Z",        "creation_date": "2026-11-03T13:30: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": 791.94,        "nbroom": 3,        "surface": {          "main": 58,          "plot": null        },        "nbbedroom": 2,        "providercity": "Castanet Tolosan",        "property_type": "APARTMENT",        "providerzipcode": "31320",        "geo_id_hierarchy": [          {            "id": "AD08FR12095",            "type_key": "AD08"          },          {            "id": "AD06FR32",            "type_key": "AD06"          }        ],        "distribution_type": "RENT",        "property_type_label": "Appartement",        "offerer_marketing_key": "NH009",        "contact_location_enabled": false      },      "tracking": {        "id": "26B649HGJRCI",        "city": "Castanet-Tolosan",        "name": "classified",        "price": 791.94,        "region": "Occitanie",        "country": "France",        "currency": "EUR",        "province": "Haute-Garonne",        "zip_code": "31320",        "client_id": "RC-079919",        "legacy_id": "284665823",        "list_name": "classified_detail_similars_bottom",        "estate_type": "av_2",        "product_type": "standard",        "distribution_type": "1",        "energy_certificate": "B"      },      "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": "792 €",          "formatted": "792 €/mois",          "modifiers": "/mois",          "aria_label": "791.94 €",          "unit_postfix": {            "unit_time": "/mois"          },          "charges_label": "cc",          "financial_link": {            "href": "https://www.selogerneuf.com/projet-invest/projet/type-bien/?utm_source=seloger&utm_campaign=medicis&utm_content=lien_prix_pdd",            "label": "Demander un financement",            "partner_name": "MEDICIS"          },          "additional_information": "charges comprises"        },        "title": "Appartement à louer",        "keyfacts": [          "3 pièces",          "2 chambres"        ],        "short_title": "Appartement"      },      "energy_class": "B",      "card_provider": {        "title": null,        "logo_url": null,        "subtitle": "Votre contact",        "agency_strip": {          "font_color": "#FFFFFF",          "agency_color": "#107070"        }      },      "legacy_tracking": {        "id": "284665823",        "media": 0,        "price": 791.94,        "space": 58,        "id_duo": 284665823,        "id_solo": 284665823,        "nb_rooms": 3,        "position": 0,        "client_id": "RC-079919",        "list_name": "detail",        "photos_nb": 6,        "client_type": "pro",        "estate_type": 1,        "nb_bedrooms": 2,        "parent_site": "SL",        "product_type": "estate",        "energy_letter": "B",        "product_variant": "classified",        "distribution_type": "1",        "estate_postalcode": "31320",        "product_geolocation": "localisation_city",        "year_of_construction": 2012      },      "main_description": {        "headline": "Appartement Castanet Tolosan   3 pièce(s)   58 m2",        "description": "CASTANET TOLOSAN - Venez visiter cet appartement T3 d'une superficie de 58 m² situé au premier étage d'une résidence avec ascenseur. Il se compose d'un séjour cuisine donnant sur un balcon, de deux chambres avec placard, d'une salle de bains et wc séparé. Vous disposez également de deux places de parkings, dont une en sous-sol. Disponible à partir du 16 novembre."      },      "has_a_i_enrichment": true    }  ],  "agency_id": "7RznN5meLVFjnybjBiLYAD",  "pagination": {    "next": null,    "current": 1,    "per_page": 20,    "total_pages": 1,    "has_next_page": false,    "total_results": 12  }}