MyIgloo APImyigloo.is ↗
Access rental listings and landlord details from myigloo.is. Retrieve price, address, amenities, images, and contact info via 2 structured endpoints.
What is the MyIgloo API?
The MyIgloo.is API provides access to rental property listings from Iceland's myigloo.is platform across 2 endpoints. The scrape_listings endpoint returns all active listings with full metadata — address, price, rooms, amenities, images, and landlord contact — while get_listing fetches the same detail set for a single listing by its numeric ID. Response objects include up to 15 structured fields per listing.
curl -X GET 'https://api.parse.bot/scraper/9f756afc-cd5c-4312-a811-9e9d272c14a9/scrape_listings?limit=3' \ -H 'X-API-Key: $PARSE_API_KEY'
Typed, relational, agent-ready
A generated client with real types, enums, and the links between objects — the structure a flat JSON response can't carry. Autocompletes in your editor and reads cleanly to coding agents.
- Fully typed · autocompletes
- Objects link to objects
- Typed errors & pagination
Typed Python client. Set up the SDK in your uv project, then pull this API’s typed client:
uv add parse-sdk uv run parse init uv run parse add --marketplace myigloo-is-api
uv run parse add --marketplace pulls a pinned snapshot of this canonical API — it won’t change underneath you. To customize it, subscribe and swap to your own copy.
"""Walkthrough: MyIgloo rental listings SDK — browse and inspect Icelandic rentals."""
from parse_apis.myigloo_rental_scraper_api import MyIgloo, Listing, ListingNotFound
client = MyIgloo()
# List active rental listings (limit caps total items fetched).
for listing in client.listings.list(limit=3):
print(listing.address.street_name, listing.address.city, listing.price_formatted)
# Drill into one listing for full detail.
listing = client.listings.list(limit=1).first()
if listing:
print(listing.id, listing.size, listing.bedrooms, listing.amenities)
# Fetch a specific listing by ID; handle not-found gracefully.
try:
detail = client.listings.get(listing_id="23913")
print(detail.landlord_name, detail.contact_info.name, detail.contact_info.profile_url)
except ListingNotFound as exc:
print(f"Listing gone: {exc}")
print("exercised: listings.list / listings.get / ListingNotFound error handling")
Retrieve rental listings from myigloo.is with full metadata and landlord information. Fetches paginated listing IDs then retrieves full details for each. Each listing includes address, price, landlord contact, amenities, images, and rules. Returns all active listings unless a limit is specified. Makes one API call per listing for detail hydration, so large limits are slow.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of listings to return. If omitted, all active listings are returned. |
{
"type": "object",
"fields": {
"total": "integer count of all listings available on the platform",
"listings": "array of listing objects with full details including address, price, landlord, amenities, images, and rules"
}
}About the MyIgloo API
Endpoints and Coverage
The API exposes two endpoints covering the full active inventory on myigloo.is. scrape_listings accepts an optional limit integer parameter; omitting it returns all active listings available on the platform. The response includes a total count alongside a listings array where each object carries address details, pricing, room counts, bedroom counts, size in square meters, images, and rules.
Listing Detail Fields
get_listing takes a required listing_id string (e.g. '23340') and returns a single listing object. Key fields include id, url (the canonical listing URL on myigloo.is), price, size, rooms, bedrooms, title, and an images array of URLs. The address object is structured with discrete sub-fields: street_name, street_number, city, postal_code, country, and a location field for geographic coordinates. The rules object, when present, includes smoking and max_people values. If a requested listing ID does not exist, the endpoint returns a stale_input error with kind input_not_found.
Data Shape and Nullability
Several fields — including price, rooms, bedrooms, title, and rules — can be null when the listing does not include that information. Consumers should handle null values on these fields. The images field is always an array, though it may be empty. size is returned as a string rather than a numeric type.
The MyIgloo API is a managed, monitored endpoint for myigloo.is — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when myigloo.is changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official myigloo.is API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Aggregate all active Icelandic rental listings into a property search index using
scrape_listings - Monitor price changes for specific properties by polling
get_listingwith known listing IDs - Build a map of available rentals using the structured
address.locationcoordinates returned per listing - Filter listings by room or bedroom count using the
roomsandbedroomsfields fromscrape_listings - Collect landlord contact information at scale for market research or outreach tooling
- Analyze rental rule patterns (smoking policies, occupancy limits) across the Icelandic market using the
rulesobject
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does myigloo.is have an official developer API?+
What does `scrape_listings` return when no `limit` is set?+
total integer reflecting the full count available. Each listing object in the listings array includes address, price, size, rooms, bedrooms, images, rules, and a listing URL.Does the API expose rental history or past listings that are no longer active?+
scrape_listings returns current inventory and get_listing returns a stale_input error for IDs that no longer exist. You can fork this API on Parse and revise it to add an endpoint targeting archived or expired listing data if that data is accessible on the platform.Are search or filter parameters supported in `scrape_listings`?+
limit, which caps the number of listings returned. Filtering by city, price range, or room count is not available as a server-side parameter. You can fork this API on Parse and revise it to add filter parameters if the underlying platform exposes filtered views.How should I handle null fields in the listing response?+
price, rooms, bedrooms, title, and rules are nullable — they return null when the listing omits that information. The images field is always an array but may be empty. The size field is a string, not a number, so numeric comparisons require parsing on the client side.