For AI agents and developers
Bidizi data, programmatically.
Single source of Portuguese real estate listings — auctions, REOs, mediation, post-auction opportunities. JSON-LD structured data on every listing, /llms.txt context for AI agents, REST API for programmatic use.
Quick access
Three ways in.
/llms.txt
Long-form platform context for AI agents. Includes counts, listing types, schema.org pointers.
Schema.org per listing
Every /leiloes/[slug] has JSON-LD Product (with availability, offers, address, images, processoRef).
REST API v1
Programmatic search and detail. Anonymous: 30 req/day. Pro+: 50,000 req/day.
REST API
/api/v1 endpoints.
/api/v1/searchList active auctions. Query params: district, propertyType, minPrice, maxPrice, q, limit, offset.
/api/v1/auction/:slugAuction detail by slug. Includes property, documents, source, listingOriginType, bidiziRole.
/api/v1/sourcesActive sources (auctioneers + portals).
/api/v1/statsAggregate stats. Pro+ tier only.
Anonymous
- • 30 req/day
- • 10 req/min
- • Stats endpoints: —
Free
- • 100 req/day
- • 20 req/min
- • Stats endpoints: —
Pro+ €79/mo
- • 50,000 req/day
- • 200 req/min
- • Stats endpoints: ✓
Best practices
Build responsibly.
- Cache aggressively — Listings update daily; cache responses ≥1h reduces our infra cost and your latency.
- Attribution — Link back to bidizi.pt when citing listings. Format: "Source: Bidizi (bidizi.pt)" or hyperlink to /leiloes/[slug].
- Identify your bot — Use a User-Agent string with your product name + contact URL. Helps us reach out if needed.
- Don't republish PII — Defendant names from judicial listings (extracted under journalistic exemption from Citius) — only processoRef and tribunal are safe outside PT context.
High-volume use? Subscribe Pro+.
Pro+ €79/mo unlocks 50k req/day, dataset bulk, stats endpoints, and prioritised support for integrations.