Idealista Scraper

ENDPOINTS
GET/agencies/details

Agency Details

Fetch an agency's profile: address, languages, listing count, years on idealista, quality score and video.

QUERY PARAMS

Agency slug or any idealista agency URL (/pro/<slug>/).

Examples:

  • Slug: engel-volkers-marbella
  • URL: https://www.idealista.com/pro/engel-volkers-marbella/

Market to search: es is idealista.com (Spain), it is idealista.it (Italy). An idealista URL passed in another parameter sets the market by itself.

Default: es

Allowed values: es, it

Language of titles, features and descriptions (idealista translates the descriptions).

Default: en

Allowed values: en, fr, de, it, pt, nl, ru

{
  "slug": "engel-volkers-marbella",
  "name": "Engel & Völkers Marbella",
  "link": "https://www.idealista.com/pro/engel-volkers-marbella/",
  "properties_count": 130,
  "since_year": 2019,
  "publication_quality_percent": 85,
  "description": "La agencia inmobiliaria líder en Marbella desde hace más de 20 años, Engel & Völkers ofrece una exclusiva cartera de viviendas de lujo en venta y alquiler con 6 locales en Marbella.",
  "address": "boulevard príncipe alfonso de hohenlohe Centro Comercial La Póveda local 5, Marbella, 29602",
  "languages": [
    "Español",
    "English",
    "Français",
    "Deutsch",
    "Italiano",
    "Svenska",
    "Nederlands",
    "Русский",
    "Česky",
    "Română",
    "Dansk"
  ],
  "logo": null,
  "image": "https://st3.idealista.com/fb/6d/51/main-engel-volkers-marbella.jpg",
  "video": "https://st3v.idealista.com/ed/e6/c3/hd_ov95669277.mp4",
  "registrations": [],
  "locations": [
    {
      "name": "Benahavís",
      "id": "0-EU-ES-29-03-001-023",
      "link": "https://www.idealista.com/pro/engel-volkers-marbella/venta-viviendas/benahavis-malaga/"
    },
    {
      "name": "Istan",
      "id": "0-EU-ES-29-03-004-061",
      "link": "https://www.idealista.com/pro/engel-volkers-marbella/venta-viviendas/istan-malaga/"
    },
    {
      "name": "Marbella",
      "id": "0-EU-ES-29-03-003-069",
      "link": "https://www.idealista.com/pro/engel-volkers-marbella/venta-viviendas/marbella-malaga/"
    },
    {
      "name": "Ojén",
      "id": "0-EU-ES-29-03-002-076",
      "link": "https://www.idealista.com/pro/engel-volkers-marbella/venta-viviendas/ojen-malaga/"
    }
  ],
  "default_listing_link": "https://www.idealista.com/pro/engel-volkers-marbella/venta-viviendas/",
  "total_listing_pages": 4,
  "commercial_data_id": "260371635",
  "country": "es"
}