flatin.es — new builds and local data in Spain

New-build developments on sale in a municipality, buyer zone or province of the flatin.es catalogue: at most 25 per call, sorted by name, no pagination — the full list is on the linked flatin.es page. Facts are the developer's own, latest check only, with attribution.

{
  "type": "object",
  "properties": {
    "place": {
      "type": "string",
      "maxLength": 80,
      "description": "Municipality (name, slug, 'province/municipality' or 5-digit INE code), buyer zone (costa-blanca, costa-del-sol) or province; prefix 'provincia:' / 'zona:' to disambiguate."
    },
    "locale": {
      "type": "string",
      "maxLength": 5,
      "enum": [
        "es",
        "en",
        "ru",
        "ua",
        "de",
        "fr",
        "nl",
        "uk"
      ],
      "description": "Language of names and page links; default en."
    }
  },
  "required": [
    "place"
  ],
  "additionalProperties": false
}

Yearly IBI urbana rate (% of cadastral value) of a municipality, with year, provisional flag, source (Ministerio de Hacienda) and the flatin.es page.

{
  "type": "object",
  "properties": {
    "municipio": {
      "type": "string",
      "maxLength": 80,
      "description": "Municipality: name, slug, 'province/municipality' or 5-digit INE code."
    },
    "locale": {
      "type": "string",
      "maxLength": 5,
      "enum": [
        "es",
        "en",
        "ru",
        "ua",
        "de",
        "fr",
        "nl",
        "uk"
      ],
      "description": "Language of names and page links; default en."
    }
  },
  "required": [
    "municipio"
  ],
  "additionalProperties": false
}

Side-by-side latest figures for 2–4 municipalities (provinces of Alicante, Málaga, Valencia, Murcia) or buyer zones: housing prices (MIVAU), rent (SERPAVI), IBI, population, income, tourist lets, foreigners, air quality and more — at most 12 indicators per call. Each figure has its unit, period, level (municipality, or province when the place has none), source credit and date, and station or point of interest with distance. Only places whose flatin.es page is published get figures; every answer links the flatin.es pages.

{
  "type": "object",
  "properties": {
    "places": {
      "type": "array",
      "minItems": 2,
      "maxItems": 4,
      "uniqueItems": true,
      "items": {
        "type": "string",
        "maxLength": 80
      },
      "description": "2 to 4 places: a municipality of the provinces of Alicante, Málaga, Valencia or Murcia (name, slug, 'province/municipality' or 5-digit INE code) or a buyer zone (costa-blanca, costa-del-sol); prefix 'municipio:' / 'zona:' to disambiguate."
    },
    "indicators": {
      "type": "array",
      "minItems": 1,
      "maxItems": 12,
      "uniqueItems": true,
      "items": {
        "type": "string",
        "enum": [
          "ibi",
          "padron29005",
          "padron65032",
          "mivau_valor_tasado_total",
          "vt_viviendas",
          "vt_plazas",
          "vt_pct",
          "rent_m2_median",
          "rent_m2_p25",
          "rent_m2_p75",
          "income_person",
          "income_household",
          "income_uc_median",
          "ftth_pct",
          "mbps100_pct",
          "gbps1_pct",
          "g5_pct",
          "foreign_total",
          "foreign_gb",
          "foreign_fr",
          "foreign_de",
          "foreign_nl",
          "foreign_be",
          "foreign_it",
          "foreign_ro",
          "foreign_ua",
          "foreign_ru",
          "foreign_ma",
          "pop_total_censo",
          "share_65plus",
          "share_0_15",
          "aq_no2_annual",
          "aq_pm10_annual",
          "aq_pm25_annual",
          "aq_o3_days",
          "clima_tmean_jan",
          "clima_tmin_jan",
          "clima_tmax_aug",
          "clima_precip_year",
          "clima_days_ge_30",
          "clima_sun_hours",
          "clima_prov_tmax",
          "clima_prov_tmin",
          "clima_prov_prec",
          "crime_ttm_total",
          "crime_ttm_violent",
          "crime_ttm_home",
          "crime_ttm_cyber",
          "tourist_occ_pct",
          "flood_t100_pct"
        ]
      },
      "description": "Up to 12 indicator keys; default: mivau_valor_tasado_total, rent_m2_median, ibi, padron29005, income_person, vt_viviendas, vt_pct, foreign_total, share_65plus, aq_no2_annual, aq_pm25_annual, tourist_occ_pct. Keys whose source terms do not allow export answer 'not_available' (the value is on the page)."
    },
    "locale": {
      "type": "string",
      "maxLength": 5,
      "enum": [
        "es",
        "en",
        "ru",
        "ua",
        "de",
        "fr",
        "nl",
        "uk"
      ],
      "description": "Language of names and page links; default en."
    }
  },
  "required": [
    "places"
  ],
  "additionalProperties": false
}

Taxes and fees of buying a home in Spain: VAT + stamp duty (AJD) for a new build or transfer tax (ITP) for a resale at the general rate of the tax territory, plus notary and land registry by the official scales. Every line cites its law, article and the date it was checked. An estimate, not tax advice.

{
  "type": "object",
  "properties": {
    "price_eur": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100000000,
      "description": "Price in whole euros WITHOUT VAT (new build) or the deed price (resale): taxes are computed on it."
    },
    "place": {
      "type": "string",
      "maxLength": 80,
      "description": "Where the property is in Spain: municipality or province name, 5-digit INE code of the municipality or 2-digit province code; 'province/municipality' or a 'municipio:' / 'provincia:' prefix to disambiguate."
    },
    "new_build": {
      "type": "boolean",
      "description": "true — first sale by the developer (VAT + stamp duty AJD); false — resale (transfer tax ITP)."
    },
    "mortgage_eur": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100000000,
      "description": "Loan amount, optional: in Spain the lender pays the mortgage AJD, notary and registration (Ley 5/2019)."
    },
    "locale": {
      "type": "string",
      "maxLength": 5,
      "enum": [
        "es",
        "en",
        "ru",
        "ua",
        "de",
        "fr",
        "nl",
        "uk"
      ],
      "description": "Language of names and page links; default en."
    }
  },
  "required": [
    "price_eur",
    "place",
    "new_build"
  ],
  "additionalProperties": false
}

Yearly IRNR of a non-resident owner of a Spanish home: imputed income (1.1 % or 2 % of the cadastral value for days not let) and rental income (EU/EEA: 19 % net of expenses; others: 24 % on gross rent). Every line cites its law and check date; rules pending validation (RDL 29/2026) are listed, not applied. An estimate, not tax advice.

{
  "type": "object",
  "properties": {
    "cadastral_value_eur": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50000000,
      "description": "Valor catastral of the property (IBI receipt), whole euros."
    },
    "revised": {
      "type": "boolean",
      "description": "true if the cadastral value was revised in a general valuation in force in the tax year or the ten previous ones (1.1 % instead of 2 %, LIRPF art. 85.1). The RDL 29/2026 extension to revisions since 2012 is not in force yet: older revisions are false."
    },
    "rent_eur_year": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000000,
      "description": "Rent received in the year, whole euros; default 0."
    },
    "expenses_eur_year": {
      "type": "integer",
      "minimum": 0,
      "maximum": 10000000,
      "description": "Deductible expenses linked to the letting (only EU/EEA residents may deduct them); default 0."
    },
    "eu_resident": {
      "type": "boolean",
      "description": "Tax resident of another EU/EEA state with tax information exchange (19 %, expenses deductible) — else 24 % on gross rent."
    },
    "days_let": {
      "type": "integer",
      "minimum": 0,
      "maximum": 366,
      "description": "Days let in the tax year (owned all year; the previous calendar year, 365 or 366 days); required when rent_eur_year > 0."
    },
    "locale": {
      "type": "string",
      "maxLength": 5,
      "enum": [
        "es",
        "en",
        "ru",
        "ua",
        "de",
        "fr",
        "nl",
        "uk"
      ],
      "description": "Language of names and page links; default en."
    }
  },
  "required": [
    "cadastral_value_eur",
    "revised",
    "eu_resident"
  ],
  "additionalProperties": false
}