# Bland.is Ad

## Overview

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

## Description

Get full Bland.is classified ad details by URL: title, full description, price in ISK, photo gallery, seller, and attributes as structured JSON.

## 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/ad' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Lookup by Bland.is ad URL

```json
{
  "id": "bland-3812746",
  "url": "https://bland.is/solutorg/skoda/3812746",
  "price": 850000,
  "title": "Nissan Leaf 2017",
  "images": [
    "https://static.bland.is/photos/3812746/1_full.jpg",
    "https://static.bland.is/photos/3812746/2_full.jpg",
    "https://static.bland.is/photos/3812746/3_full.jpg",
    "https://static.bland.is/photos/3812746/4_full.jpg",
    "https://static.bland.is/photos/3812746/5_full.jpg"
  ],
  "seller": {
    "phone": "+354 698 4421",
    "username": "olafur_ragnar",
    "is_company": false,
    "profile_url": "https://bland.is/pers/profile.aspx?u=olafur_ragnar",
    "member_since": "2018-03-14T00:00:00.000Z",
    "phone_visible": true,
    "active_listings": 4
  },
  "status": "active",
  "category": "farartaeki",
  "currency": "ISK",
  "is_offer": false,
  "location": {
    "city": "Reykjavík",
    "region": "Höfuðborgarsvæðið",
    "postal_code": "110"
  },
  "condition": "used",
  "attributes": {
    "fuel": "Rafmagn",
    "make": "Nissan",
    "year": 2017,
    "color": "Hvítur",
    "model": "Leaf",
    "mileage": 76000,
    "registration": "VL241",
    "transmission": "Sjálfskiptur"
  },
  "breadcrumb": [
    "Sölutorg",
    "Farartæki",
    "Bílar"
  ],
  "expires_at": "2026-06-17T10:32:00.000Z",
  "updated_at": "2026-05-18T10:32:00.000Z",
  "view_count": 412,
  "description": "Vel með farinn Nissan Leaf, ný dekk og þjónusta hjá BL. Drægni um 130 km á fullri hleðslu. Reyklaus bíll, ein eigandi frá nýju. Ferskt ástandsskoðunarvottorð fylgir.\n\nSjá myndir. Hægt að skipta á smærri bíl.",
  "subcategory": "Bílar",
  "published_at": "2026-05-18T10:32:00.000Z",
  "favorite_count": 7
}
```

## Documentation

## Overview

Bland.is is Iceland's main classifieds marketplace, owned by Sýn hf. The ad endpoint returns everything a buyer sees on a listing: title, full Icelandic description, ISK price, every photo, seller username and member-since date, view count, favorite count, and category-specific attributes (year, mileage, area, tire size, etc.). The site applies session-based bot detection. Piloterr handles the session and parsing.

## Quickstart

```
GET https://api.piloterr.com/v2/bland-is/ad?query=https://bland.is/solutorg/skoda/3812746
```

## Main use cases

- Enrich a vehicle valuation pipeline with mileage, year, transmission, and fuel for every Bland.is car listing
- Detect when an ad goes from `active` to `sold` to feed a real-time days-on-market metric for the Icelandic market
- Build a seller reputation graph by joining username, member-since, and active listings across thousands of ads
- Pull every photo for a computer vision model that flags damaged or staged items
- Parse the full Icelandic description to extract attributes the seller did not fill in the form

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