Piloterr

SeLoger Agency

GET
/v2/seloger/agency

Retrieve detailed profile information for a SeLoger real estate agency including contact details, ratings, reviews, and address.

Credit cost: 2 credits per call

Autorização

ApiKeyAuth
headerx-api-key<token>

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

Parâmetros de consulta

query*string

A valid SeLoger agency profile URL.

Supported URL formats:

/professionnels/agences-immobilieres/{city}/{slug}/
/professionnels/agents-commerciaux/{city}/{slug}/

Example:

https://www.seloger.com/professionnels/agences-immobilieres/castanet-tolosan-31320/agence-21719

Note: The URL must point to a SeLoger agency profile page. The agency slug and numeric ID are both embedded in the URL.

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

Corpo da resposta

Successful response

application/json
  1. response
id?string
logo?
name?string
email?string
siret?string
banner?
id_rcu?string
rating?
address?
fee_url?string
reviews?
website?string
id_tiers?string
is_seller?unknown
languages?string
legal_form?unknown
sold_count?unknown
agency_type?integer
description?unknown
phone_number?string
intermediary_id?integer
social_networks?array<unknown>
sold_properties?unknown
intermediary_type?integer
environment_source?string
head_office_address?unknown
Example Request
curl -X GET 'https://api.piloterr.com/v2/seloger/agency?query=string'
Example Response
{  "id": "73866",  "logo": {    "alt": "Logo du pro L'ADRESSE CASTANET TOLOSAN",    "src": "04yui7bokni23pkvnpeje9fsrpfqf364vk6xbc1qo"  },  "name": "L'ADRESSE CASTANET TOLOSAN",  "email": "name@example.com",  "siret": "51965411500020",  "banner": {    "alt": "Banniere du pro L'ADRESSE CASTANET TOLOSAN",    "src": null  },  "id_rcu": "RC-079919",  "rating": {    "value": 4.8,    "reviews_count": 129  },  "address": {    "city": "Castanet Tolosan",    "street": "43 avenue de Toulouse ",    "zip_code": "31320"  },  "fee_url": "https://media.immo-facile.com/segments/immo/catalog/images/manufacturers_bareme/72614.pdf",  "reviews": {    "count": 129,    "result": []  },  "website": "http://www.ladresse-castanet.com",  "id_tiers": "102577",  "is_seller": null,  "languages": "en,es,fr",  "legal_form": null,  "sold_count": null,  "agency_type": 0,  "description": null,  "phone_number": "+33 1 99 00 00 00",  "intermediary_id": 21719,  "social_networks": [],  "sold_properties": null,  "intermediary_type": 1,  "environment_source": "SELOGER",  "head_office_address": null}