Idealista Scraper

ENDPOINTS
GET/agencies/search

Search Agencies

Find the featured real estate agencies of a Spanish or Italian province or city, with listing counts and prices.

QUERY PARAMS

Province or city: a name, a directory slug, or an idealista agencies-directory URL.

Examples:

  • Name: Marbella
  • Slug: balears-illes/mallorca

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

{
  "location": "marbella-malaga",
  "country": "es",
  "title": "Real estate agents in Marbella, Malaga",
  "count": 15,
  "results": [
    {
      "id": "130004699",
      "slug": "andaluciarealty",
      "name": "Andalucia realty",
      "link": "https://www.idealista.com/pro/andaluciarealty/",
      "listings_link": "https://www.idealista.com/pro/andaluciarealty/venta-viviendas/marbella-malaga/",
      "logo": "https://st3.idealista.com/80/db/fe/P29003709.gif",
      "years_on_site": 16,
      "operation": "sale",
      "listings_count": 19,
      "listings_text": "19 housing for sale in Marbella (450,000€ - 7,400,000€)",
      "price_range": {
        "min": 450000,
        "max": 7400000,
        "currency": "EUR"
      },
      "publication_quality_percent": 69,
      "verified_reports": 1,
      "reports_last_3_months": null,
      "first_page_listings": null,
      "speaks_your_language": true,
      "location_id": "0-EU-ES-29-03-003-069",
      "sample_pictures": [
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/c1/e7/0f/1461415227.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/19/07/74/1337090313.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/bd/ce/32/1327244076.jpg"
      ]
    },
    {
      "id": "260372590",
      "slug": "solvilla",
      "name": "Solvilla",
      "link": "https://www.idealista.com/pro/solvilla/",
      "listings_link": "https://www.idealista.com/pro/solvilla/venta-viviendas/marbella-malaga/",
      "logo": "https://st3.idealista.com/90/da/ce/solvilla.gif",
      "years_on_site": 8,
      "operation": "sale",
      "listings_count": 53,
      "listings_text": "53 housing for sale in Marbella (1,590,000€ - 13,500,000€)",
      "price_range": {
        "min": 1590000,
        "max": 13500000,
        "currency": "EUR"
      },
      "publication_quality_percent": 78,
      "verified_reports": 9,
      "reports_last_3_months": null,
      "first_page_listings": null,
      "speaks_your_language": true,
      "location_id": "0-EU-ES-29-03-003-069",
      "sample_pictures": [
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/71/4f/ca/1478213560.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/86/d9/bc/1360083937.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/07/ff/f4/1158054044.jpg"
      ]
    },
    {
      "id": "130153610",
      "slug": "kwmarbella",
      "name": "Keller Williams Marbella",
      "link": "https://www.idealista.com/pro/kwmarbella/",
      "listings_link": "https://www.idealista.com/pro/kwmarbella/venta-viviendas/marbella-malaga/",
      "logo": "https://st3.idealista.com/9d/c6/4b/kwmarbella.gif",
      "years_on_site": 15,
      "operation": "sale",
      "listings_count": 43,
      "listings_text": "43 housing for sale in Marbella (298,000€ - 9,000,000€)",
      "price_range": {
        "min": 298000,
        "max": 9000000,
        "currency": "EUR"
      },
      "publication_quality_percent": 79,
      "verified_reports": 6,
      "reports_last_3_months": 19,
      "first_page_listings": null,
      "speaks_your_language": true,
      "location_id": "0-EU-ES-29-03-003-069",
      "sample_pictures": [
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/a5/ee/c1/1484854610.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/90/ec/1a/1487959064.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/55/4f/12/1487248136.jpg"
      ]
    },
    {
      "id": "130023822",
      "slug": "gilmarmarbella",
      "name": "Gilmar Marbella - Golden Mile",
      "link": "https://www.idealista.com/pro/gilmarmarbella/",
      "listings_link": "https://www.idealista.com/pro/gilmarmarbella/venta-viviendas/marbella-malaga/",
      "logo": "https://st3.idealista.com/3c/fa/ed/gilmarmarbella.gif",
      "years_on_site": 26,
      "operation": "sale",
      "listings_count": 50,
      "listings_text": "50 housing for sale in Marbella (330,000€ - 3,950,000€)",
      "price_range": {
        "min": 330000,
        "max": 3950000,
        "currency": "EUR"
      },
      "publication_quality_percent": 88,
      "verified_reports": 29,
      "reports_last_3_months": 43,
      "first_page_listings": 2,
      "speaks_your_language": true,
      "location_id": "0-EU-ES-29-03-003-069",
      "sample_pictures": [
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/40/78/2c/999646082.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/9c/27/f3/1450597609.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/b2/27/da/1152236719.jpg"
      ]
    },
    {
      "id": "260369403",
      "slug": "panoramamarbella",
      "name": "Panorama Marbella's longest established real estate agency",
      "link": "https://www.idealista.com/pro/panoramamarbella/",
      "listings_link": "https://www.idealista.com/pro/panoramamarbella/venta-viviendas/marbella-malaga/",
      "logo": "https://st3.idealista.com/66/21/c9/panoramamarbella.gif",
      "years_on_site": 8,
      "operation": "sale",
      "listings_count": 135,
      "listings_text": "135 housing for sale in Marbella (480,000€ - 16,900,000€)",
      "price_range": {
        "min": 480000,
        "max": 16900000,
        "currency": "EUR"
      },
      "publication_quality_percent": 65,
      "verified_reports": 13,
      "reports_last_3_months": 45,
      "first_page_listings": 6,
      "speaks_your_language": true,
      "location_id": "0-EU-ES-29-03-003-069",
      "sample_pictures": [
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/0c/82/52/1152568753.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/60/68/b0/1358704562.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/2c/48/62/1422701287.jpg"
      ]
    },
    {
      "id": "260426031",
      "slug": "velian-group",
      "name": "Velian Group",
      "link": "https://www.idealista.com/pro/velian-group/",
      "listings_link": "https://www.idealista.com/pro/velian-group/venta-viviendas/marbella-malaga/",
      "logo": "https://st3.idealista.com/c6/0d/57/velian-group.gif",
      "years_on_site": 9,
      "operation": "sale",
      "listings_count": 57,
      "listings_text": "57 housing for sale in Marbella (656,000€ - 19,500,000€)",
      "price_range": {
        "min": 656000,
        "max": 19500000,
        "currency": "EUR"
      },
      "publication_quality_percent": 83,
      "verified_reports": 10,
      "reports_last_3_months": null,
      "first_page_listings": 6,
      "speaks_your_language": true,
      "location_id": "0-EU-ES-29-03-003-069",
      "sample_pictures": [
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/70/ee/8d/1450402908.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/2e/68/70/1450389427.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/df/79/a3/1450388326.jpg"
      ]
    },
    {
      "id": "130049059",
      "slug": "gilmarmarbellapuertobanus",
      "name": "Gilmar Puerto Banús",
      "link": "https://www.idealista.com/pro/gilmarmarbellapuertobanus/",
      "listings_link": "https://www.idealista.com/pro/gilmarmarbellapuertobanus/venta-viviendas/marbella-malaga/",
      "logo": "https://st3.idealista.com/23/35/64/gilmarmarbellapuertobanus.gif",
      "years_on_site": 26,
      "operation": "sale",
      "listings_count": 33,
      "listings_text": "33 housing for sale in Marbella (260,000€ - 8,900,000€)",
      "price_range": {
        "min": 260000,
        "max": 8900000,
        "currency": "EUR"
      },
      "publication_quality_percent": 92,
      "verified_reports": 13,
      "reports_last_3_months": null,
      "first_page_listings": 2,
      "speaks_your_language": true,
      "location_id": "0-EU-ES-29-03-003-069",
      "sample_pictures": [
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/77/8a/e7/1370718672.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/89/ef/9c/1472322671.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/67/c1/97/1458293506.jpg"
      ]
    },
    {
      "id": "260371635",
      "slug": "engel-volkers-marbella",
      "name": "Engel & Völkers Marbella",
      "link": "https://www.idealista.com/pro/engel-volkers-marbella/",
      "listings_link": "https://www.idealista.com/pro/engel-volkers-marbella/venta-viviendas/marbella-malaga/",
      "logo": "https://st3.idealista.com/ab/3b/d1/engel-volkers-marbella.gif",
      "years_on_site": 8,
      "operation": "sale",
      "listings_count": 90,
      "listings_text": "90 housing for sale in Marbella (520,000€ - 22,000,000€)",
      "price_range": {
        "min": 520000,
        "max": 22000000,
        "currency": "EUR"
      },
      "publication_quality_percent": 85,
      "verified_reports": 9,
      "reports_last_3_months": 20,
      "first_page_listings": 2,
      "speaks_your_language": true,
      "location_id": "0-EU-ES-29-03-003-069",
      "sample_pictures": [
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/1e/8a/37/1486768729.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/3e/3d/fc/1424774861.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/5b/b7/28/958693375.jpg"
      ]
    },
    {
      "id": "260416698",
      "slug": "marbella-east-engel-volkers",
      "name": "Marbella East Engel & Völkers",
      "link": "https://www.idealista.com/pro/marbella-east-engel-volkers/",
      "listings_link": "https://www.idealista.com/pro/marbella-east-engel-volkers/venta-viviendas/marbella-malaga/",
      "logo": "https://st3.idealista.com/3b/18/90/marbella-east-engel-volkers.gif",
      "years_on_site": 4,
      "operation": "sale",
      "listings_count": 109,
      "listings_text": "109 housing for sale in Marbella (278,000€ - 7,600,000€)",
      "price_range": {
        "min": 278000,
        "max": 7600000,
        "currency": "EUR"
      },
      "publication_quality_percent": 73,
      "verified_reports": 7,
      "reports_last_3_months": 14,
      "first_page_listings": 1,
      "speaks_your_language": true,
      "location_id": "0-EU-ES-29-03-003-069",
      "sample_pictures": [
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/0a/2a/f3/1468488927.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/f0/1b/43/1454048780.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/2e/0b/40/1486203060.jpg"
      ]
    },
    {
      "id": "130019481",
      "slug": "prorealestateguadalmina",
      "name": "PRO Real Estate Guadalmina",
      "link": "https://www.idealista.com/pro/prorealestateguadalmina/",
      "listings_link": "https://www.idealista.com/pro/prorealestateguadalmina/venta-viviendas/marbella-malaga/",
      "logo": "https://st3.idealista.com/5f/f2/1c/prorealestateguadalmina.gif",
      "years_on_site": 17,
      "operation": "sale",
      "listings_count": 12,
      "listings_text": "12 housing for sale in Marbella (498,000€ - 2,995,000€)",
      "price_range": {
        "min": 498000,
        "max": 2995000,
        "currency": "EUR"
      },
      "publication_quality_percent": 70,
      "verified_reports": 6,
      "reports_last_3_months": 7,
      "first_page_listings": 1,
      "speaks_your_language": true,
      "location_id": "0-EU-ES-29-03-003-069",
      "sample_pictures": [
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/b3/92/6d/1429186445.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/41/0a/08/1395075694.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/e1/6d/15/1462935706.jpg"
      ]
    },
    {
      "id": "260410090",
      "slug": "le",
      "name": "LuxEstate",
      "link": "https://www.idealista.com/pro/le/",
      "listings_link": "https://www.idealista.com/pro/le/venta-viviendas/marbella-malaga/",
      "logo": "https://st3.idealista.com/3a/f3/80/le.gif",
      "years_on_site": 4,
      "operation": "sale",
      "listings_count": 99,
      "listings_text": "99 housing for sale in Marbella (525,000€ - 19,500,000€)",
      "price_range": {
        "min": 525000,
        "max": 19500000,
        "currency": "EUR"
      },
      "publication_quality_percent": 81,
      "verified_reports": 10,
      "reports_last_3_months": null,
      "first_page_listings": null,
      "speaks_your_language": true,
      "location_id": "0-EU-ES-29-03-003-069",
      "sample_pictures": [
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/18/63/20/1458651566.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/02/bc/08/1230616241.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/2a/1b/1f/1416049934.jpg"
      ]
    },
    {
      "id": "260422391",
      "slug": "la-sala-homes",
      "name": "La Sala Homes",
      "link": "https://www.idealista.com/pro/la-sala-homes/",
      "listings_link": "https://www.idealista.com/pro/la-sala-homes/venta-viviendas/marbella-malaga/",
      "logo": "https://st3.idealista.com/33/42/23/la-sala-homes.gif",
      "years_on_site": 3,
      "operation": "sale",
      "listings_count": 20,
      "listings_text": "20 housing for sale in Marbella (349,000€ - 3,000,000€)",
      "price_range": {
        "min": 349000,
        "max": 3000000,
        "currency": "EUR"
      },
      "publication_quality_percent": 89,
      "verified_reports": 1,
      "reports_last_3_months": 7,
      "first_page_listings": null,
      "speaks_your_language": true,
      "location_id": "0-EU-ES-29-03-003-069",
      "sample_pictures": [
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/94/9a/93/1444944178.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/c8/10/54/1457707607.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/67/89/6c/1427013152.jpg"
      ]
    },
    {
      "id": "260416670",
      "slug": "engel-volkers-puerto-banus",
      "name": "Engel & Völkers Puerto Banus",
      "link": "https://www.idealista.com/pro/engel-volkers-puerto-banus/",
      "listings_link": "https://www.idealista.com/pro/engel-volkers-puerto-banus/venta-viviendas/marbella-malaga/",
      "logo": "https://st3.idealista.com/f2/30/4e/engel-volkers-puerto-banus.gif",
      "years_on_site": 4,
      "operation": "sale",
      "listings_count": 41,
      "listings_text": "41 housing for sale in Marbella (490,000€ - 9,950,000€)",
      "price_range": {
        "min": 490000,
        "max": 9950000,
        "currency": "EUR"
      },
      "publication_quality_percent": 88,
      "verified_reports": 3,
      "reports_last_3_months": 5,
      "first_page_listings": null,
      "speaks_your_language": false,
      "location_id": "0-EU-ES-29-03-003-069",
      "sample_pictures": [
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/9d/5f/17/1381873934.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/90/7f/48/1485294611.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/cf/7a/80/1426083890.jpg"
      ]
    },
    {
      "id": "260397469",
      "slug": "249275349608988978-260397469",
      "name": "Costa del Sol Property",
      "link": "https://www.idealista.com/pro/249275349608988978-260397469/",
      "listings_link": "https://www.idealista.com/pro/249275349608988978-260397469/venta-viviendas/marbella-malaga/",
      "logo": "https://st3.idealista.com/56/db/6e/249275349608988978-260397469.gif",
      "years_on_site": 6,
      "operation": "sale",
      "listings_count": 17,
      "listings_text": "17 housing for sale in Marbella (595,000€ - 4,495,000€)",
      "price_range": {
        "min": 595000,
        "max": 4495000,
        "currency": "EUR"
      },
      "publication_quality_percent": 75,
      "verified_reports": 1,
      "reports_last_3_months": 3,
      "first_page_listings": null,
      "speaks_your_language": true,
      "location_id": "0-EU-ES-29-03-003-069",
      "sample_pictures": [
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/16/4e/0a/1294832185.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/bf/83/fc/1440522394.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/11/91/aa/1422135602.jpg"
      ]
    },
    {
      "id": "260361725",
      "slug": "airus-homes",
      "name": "Airus Homes",
      "link": "https://www.idealista.com/pro/airus-homes/",
      "listings_link": "https://www.idealista.com/pro/airus-homes/venta-viviendas/marbella-malaga/",
      "logo": "https://st3.idealista.com/2a/ab/41/airus-homes.gif",
      "years_on_site": 9,
      "operation": "sale",
      "listings_count": 109,
      "listings_text": "109 housing for sale in Marbella (295,000€ - 11,400,000€)",
      "price_range": {
        "min": 295000,
        "max": 11400000,
        "currency": "EUR"
      },
      "publication_quality_percent": 67,
      "verified_reports": 2,
      "reports_last_3_months": 8,
      "first_page_listings": null,
      "speaks_your_language": true,
      "location_id": "0-EU-ES-29-03-003-069",
      "sample_pictures": [
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/b2/c9/59/1365576810.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/20/72/97/1366735818.jpg",
        "https://img3.idealista.com/blur/140_105_mq/0/id.pro.es.image.master/99/b5/59/1462374975.jpg"
      ]
    }
  ]
}