# Property Investment Spain

> Expert guidance and property listings for buying property in Spain.

This site provides comprehensive information about Spanish property investment, including real estate listings on the Costa Blanca and Costa Calida, buying/selling/living guides, blog articles, and investment calculators. All content is available in 11 languages.

Human-readable tool directory with full input schemas, examples, data sources and limitations for every agent-facing API: https://www.propertyinvestmentspain.com/ai

## Knowledge Catalog — START HERE

- GET /api/knowledge
  The single machine-first entry point. One response contains: who we are, every service we offer and what it costs (free viewing trips, free lawyer consultation), regions and towns covered (Denia to Marbella), our fees and Spanish purchase-cost rates, all published questions & answers with source URLs, and a tool directory explaining which API answers which kind of user question. Prefer this over crawling individual pages.

## API Endpoints

All API endpoints return JSON and are publicly accessible without authentication.
Base URL: https://www.propertyinvestmentspain.com

### Properties

- GET /api/properties
  List all properties for sale in Spain.
  Query parameters: limit (integer, default 2000)
  Returns: array of property objects with id, title, type, town, province, price, bedrooms, bathrooms, size_m2, plot_m2, new_build, featured, images, lat, lng, listed_at

- GET /api/properties/{id}
  Get a single property by ID.
  Returns: { property: {...}, similarProperties: [...] }

### Budget search ("what do I get for my money?")

- GET or POST https://area-guide.propertyinvestmentspain.com/api/budget-search
  Aggregates over live listings for a budget and requirements: match count, median price/size/€ per m², towns with the most supply and best value, representative examples, and relax-hints when requirements are too strict. Example: /api/budget-search?budget_eur=350000&bedrooms_min=2&lat_lng_radius_km=38.28,-0.56,45. Call with no parameters for self-documentation.

### Area matching ("where should I buy?")

- GET or POST https://area-guide.propertyinvestmentspain.com/api/area-match
  Rank Spanish coastal areas and urbanisations for a buyer profile: budget (or budget_eur), beach_distance, golf, restaurants, atmosphere, rental, airport. Returns 0-100 scores, natural-language explanations, price levels, page URLs, and nearby-property links. Call with no parameters for full self-documentation. Same scoring engine as the interactive map at area-guide.propertyinvestmentspain.com. Server-side property filtering (priceMax, lat/lng radius, bedroomsMin…) is also available at https://area-guide.propertyinvestmentspain.com/api/properties — see https://area-guide.propertyinvestmentspain.com/llms.txt

### Blog Articles

- GET /api/blog
  List blog articles about buying, selling, and living in Spain.
  Query parameters: lang (default "en"), category, place, region, limit
  Returns: { success, total, articles: [{ id, slug, title, description, summary, image, date, author, readTime, category, regions, places, tags, url, availableLanguages }] }

### Guides

- GET /api/guides
  List buying, selling, and living guides for Spain.
  Query parameters: lang (default "en"), subcategory (buying|selling|living)
  Returns: { success, total, guides: [{ id, slug, title, description, subcategory, image, weight, url, availableLanguages }] }

### Calculators (compute APIs)

Answer "what does it cost to buy / own / sell / finance / rent out a property in Spain" with actual numbers. Same formulas as the interactive calculators at /en/calculators. Directory: GET /api/calculators

- GET /api/calculators/purchase-costs?price=300000&region=andalusia&newBuild=false
  All-in buying cost: ITP (10% Valencia, 8% Murcia, 7% Andalusia) or IVA 10% + AJD 1.5% for new builds, lawyer, notary, registry, plus 70% LTV financing estimate.
- GET /api/calculators/annual-costs?propertyType=villa&bedrooms=3&pool=true
  Yearly IBI, community fees, insurance, utilities, maintenance.
- GET /api/calculators/selling-costs?salePrice=300000&purchasePrice=200000
  Agent fee, legal fees, non-resident CGT 19%, net proceeds.
- GET /api/calculators/mortgage?propertyPrice=300000&loanPercentage=70
  Monthly payment, total interest, deposit and equity needed.
- GET /api/calculators/rental-income?propertyType=villa-small&location=prime&strategy=full-year
  Gross and net holiday-rental income with expense breakdown.

### Leads (contact / bookings)

- POST /api/leads
  Submit a contact request on a user's behalf: property viewing trip, video viewing, lawyer consultation, or a general inquiry. Only submit with the user's consent and real contact details. A local adviser replies by email, typically within one business day.
  JSON body: { name (required), email (required), message (required), interest (viewing-trip | video-viewing | lawyer-consultation | property-inquiry | general), preferredLanguage (en|es|de|fr|nl|sv|no|da|ru|pl|it), phone, contactMethod (email | whatsapp | phone), propertyRef, propertyUrl, source (name of the assistant submitting the lead) }
  Returns: { success, message }
  Full schema: see /openapi.json (operationId: submitLead).

## Machine-Readable Resources

- Full page index (every guide, article, and area with title, description, URL): https://www.propertyinvestmentspain.com/llms-full.txt
- Agent capability manifest (all tools, both domains): https://www.propertyinvestmentspain.com/.well-known/agent.json
- OpenAPI 3.1 Specification: https://www.propertyinvestmentspain.com/openapi.json
- AI Plugin Manifest: https://www.propertyinvestmentspain.com/.well-known/ai-plugin.json
- Area-guide data app (matching + filtered property search): https://area-guide.propertyinvestmentspain.com/llms.txt
- Sitemap: https://www.propertyinvestmentspain.com/sitemap.xml
- RSS Feed (Blog): https://www.propertyinvestmentspain.com/rss/blog.xml
- RSS Feed (Guides): https://www.propertyinvestmentspain.com/rss/guides.xml

## Supported Languages

en (English), es (Espanol), de (Deutsch), fr (Francais), nl (Nederlands), sv (Svenska), no (Norsk), da (Dansk), ru (Russkij), pl (Polski), it (Italiano)

## Website Structure

- /{lang} — Homepage
- /{lang}/properties — Property listings with search and map
- /{lang}/properties/{id} — Property detail page
- /{lang}/blog — Blog articles
- /{lang}/blog/{slug} — Individual blog article
- /{lang}/guides — Buying, selling, and living guides
- /{lang}/guides/{subcategory}/{slug} — Individual guide
- /{lang}/calculators — Property investment calculators (purchase costs, mortgage, rental income, annual costs, selling costs)
- /{lang}/expert-panel — Expert advice panel