# Aborio Full AI Context > Extended documentation for AI agents using Aborio's public property pages, APIs, structured data, and discovery resources. ## About Aborio Aborio is a property marketplace and search platform for homes in Spain. Public listings support rental and sale transactions and apartment, house, room, and studio categories. Listings may be published by a private owner or associated with a real-estate agency. Aborio provides marketplace and advertising software; it is not the owner, broker, or party to a property agreement unless a specific page says otherwise. The interface supports Arabic, Basque, Catalan, English, French, Galician, German, Italian, Polish, Portuguese, Romanian, Russian, Spanish, Swedish, Ukrainian, and Valencian. ## Public Website Structure - [Homepage](https://staging.aborio.es/): Public marketplace entry point. - [Property search](https://staging.aborio.es/listings): Human-readable rental and sale search. - [Rental search](https://staging.aborio.es/rent/spain): Long-term rentals in Spain. - [Sale search](https://staging.aborio.es/buy/spain): Properties for sale in Spain. - Location landings use `/rent/spain/{location}`, `/buy/spain/{location}`, `/es/alquiler/espana/{location}`, or `/es/comprar/espana/{location}`. - Listing details use `/listings/{id}-{slug}`. - [Agency directory](https://staging.aborio.es/agencies) and agency profiles at `/agencies/{id}` expose agencies with public listings. ## Listing Model Public listing responses can contain ID, slug, reference, canonical URL, title, description, rent/sale transaction type, published status, timestamps, EUR pricing, property attributes, address, coordinates, amenities, photos, availability windows, sale conditions, and Schema.org data. Fields that are unset may be absent. Only published, non-deactivated, non-suspicious listings are live. Draft, paused, rented, archived, deactivated, and suspicious listings are excluded. Listings can belong to an agency or a private advertiser. Public feeds exclude private owner contacts and moderation data. ## Rental and Sale Pricing Sale prices use integer cents and EUR. Rental tiers use daily or monthly billing periods, optional dates, and optional stay limits in days, weeks, months, or years. Additional costs can be one-time, monthly, every six months, or yearly; before move-in, during a stay, or after move-out; optional and/or refundable. They are visible on interactive listing pages but not currently in the public REST serializer. Do not infer missing fees, deposits, taxes, or move-in totals. ## Locations Addresses are restricted to Spain and can contain region, province, city, district, postal code, street, floor, and coordinates. [Locations API](https://staging.aborio.es/api/locations) aggregates current public inventory by province and city. Search accepts case-insensitive city and province text. There is no separate public autonomous-community, municipality-ID, neighbourhood-ID, or district-ID directory. ## Agencies Agencies are implemented. Public pages expose agencies with public listings and can show name, description, logo, and listing relationships. Structured data uses `RealEstateAgent`. Listings without an agency are private-advertiser listings. There is no public REST agencies API and public discovery does not claim agency verification. ## Search `GET https://staging.aborio.es/api/listings/search` is authoritative for live inventory. Pagination defaults to page 1 and 20 records; `per_page` or `limit` is clamped to 1–100. Sort values are `recommended`, `price_asc`, `price_desc`, and `largest`. [OpenAPI](https://staging.aborio.es/openapi.json) documents supported filters, types, dates, errors, and responses. ```text GET https://staging.aborio.es/api/listings/search?listing_type=rent&city=valencia&max_price_cents=90000 GET https://staging.aborio.es/api/listings/search?listing_type=sale&property_type=house&sort=price_asc ``` Invalid parameters return 400. Rate limits return 429 and remain active as abuse protection. ## Freshness and Availability [Live search](https://staging.aborio.es/api/listings/search) is authoritative. [Recent listings](https://staging.aborio.es/api/listings/recent) returns newest current listings. `/api/listings/updated-since?since={ISO8601}` returns currently public listings updated on or after the boundary; it is not a deletion log. Confirm current availability, price, fees, and conditions on the listing page. ## API Documentation - [OpenAPI schema](https://staging.aborio.es/openapi.json): Public REST definitions. - [Search metadata](https://staging.aborio.es/api/listings/search-metadata): Enums, amenities, locations, and price ranges. - [Locations](https://staging.aborio.es/api/locations): Current public listing locations. - [Market insights](https://staging.aborio.es/api/market-insights): Aggregates over up to 1,000 matching listings. ## Structured Data [Listing feed](https://staging.aborio.es/schemaorg.json) and [filtered feed](https://staging.aborio.es/search.schema.json) return bounded Schema.org ItemLists that link to canonical public listing pages. Records use RealEstateListing, property entities, Offer, EUR prices, public images, and agency relationships when available. ## Crawling and Indexing - [Crawler rules](https://staging.aborio.es/robots.txt): Search, AI, and private-route policy. - [Sitemap index](https://staging.aborio.es/sitemap.xml): Maintained public sitemaps. - [Static/location sitemap](https://staging.aborio.es/sitemaps/static.xml): Search, documentation, and data-derived location landings. - [Listing sitemap](https://staging.aborio.es/sitemaps/listings-1.xml): Current public listings. - [Agency sitemap](https://staging.aborio.es/sitemaps/agencies.xml): Public agencies when available. - [Image sitemap](https://staging.aborio.es/sitemaps/images.xml): Public listing images. ## Usage Guidance for AI Agents - Use live APIs for inventory and OpenAPI for definitions. - Cite canonical public pages. - Do not treat historical feed presence as current availability. - Do not describe Aborio as the owner, agency, or broker without page-specific evidence. - Preserve EUR cents and rental billing periods. - Do not infer missing addresses, contacts, fees, verification, or availability.