# Bland.is Search

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/bland-is/search` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/bland-is-search |

## Description

Search Bland.is Iceland classifieds by keyword and category and return ad title, price in ISK, location, and seller as structured JSON in real time.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/bland-is/search' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Search by keyword 'iphone'

```json
{
  "page": 1,
  "results": [
    {
      "id": "bland-3812746",
      "url": "https://bland.is/solutorg/skoda/3812746",
      "price": 850000,
      "title": "Nissan Leaf 2017",
      "category": "farartaeki",
      "currency": "ISK",
      "is_offer": false,
      "location": {
        "city": "Reykjavík",
        "postal_code": "110"
      },
      "condition": "used",
      "thumbnail": "https://static.bland.is/photos/3812746/main_320x240.jpg",
      "attributes": {
        "fuel": "Rafmagn",
        "year": 2017,
        "mileage": 76000,
        "transmission": "Sjálfskiptur"
      },
      "subcategory": "Bílar",
      "published_at": "2026-05-18T10:32:00.000Z"
    },
    {
      "id": "bland-3812701",
      "url": "https://bland.is/solutorg/skoda/3812701",
      "price": 250000,
      "title": "20'' Ford 6x135 felgur og dekk",
      "category": "farartaeki-aukahlutir",
      "currency": "ISK",
      "is_offer": false,
      "location": {
        "city": "Reykjavík",
        "postal_code": "110"
      },
      "condition": "new",
      "thumbnail": "https://static.bland.is/photos/3812701/main_320x240.jpg",
      "attributes": {
        "tire_type": "Jeppadekk",
        "size_inches": 20
      },
      "subcategory": "Dekk / Felgur",
      "published_at": "2026-05-18T10:22:00.000Z"
    },
    {
      "id": "bland-3812688",
      "url": "https://bland.is/solutorg/skoda/3812688",
      "price": 45000,
      "title": "Apple Watch Ultra",
      "category": "raftaeki",
      "currency": "ISK",
      "is_offer": false,
      "location": {
        "city": "Reykjavík",
        "postal_code": "104"
      },
      "condition": "new",
      "thumbnail": "https://static.bland.is/photos/3812688/main_320x240.jpg",
      "attributes": {},
      "subcategory": "Símar og fylgihlutir",
      "published_at": "2026-05-18T09:51:00.000Z"
    }
  ],
  "total_results": 1284,
  "results_per_page": 36
}
```

## Documentation

## Overview

Bland.is is Iceland's main classifieds marketplace, owned by Sýn hf. Listings cover used cars, electronics, real estate, kids' gear, jobs, pets, and free items, priced in Icelandic króna. The site applies session-based bot detection. Piloterr handles the session and parsing, returning each listing card as structured JSON: title, price, condition, category, location, and card attributes (year, mileage, tire size, etc.).

## Quickstart

```
GET https://api.piloterr.com/v2/bland-is/search?query=nissan+leaf&category=farartaeki&city=Reykjavík&sort=newest
```

## Main use cases

- Track second-hand car prices in Reykjavík to feed an Icelandic vehicle valuation model
- Monitor new electronics listings hourly to spot resale arbitrage before items sell
- Aggregate rental and sale ads from the `fasteignir` category to build an Iceland real estate price index
- Detect price drops on saved keywords for a consumer alerts product aimed at the Icelandic market
- Benchmark job ad volume in the `atvinna` category by region to track Iceland's labor market

See https://www.piloterr.com/pricing for plans and free trial credits.