# Finn.no Mobility Listings Scraper (x402)

> Finn.no Mobility Listings Scraper (x402) is a paid API for AI agents from x402.186-241-26-229.sslip.io, paid per call via x402, $0.04/call, status unknown (last checked 2026-10-02).

Scrapes structured vehicle, boat, and mobility listings from Finn.no with pay-per-call billing via x402 protocol.

## Facts

- Endpoint: POST https://x402.186-241-26-229.sslip.io/v1/finn?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/finn-no-mobility-listings-scraper-x402-a7caeeec
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_X6lCLZcXDzvW7xcYFMe2D

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability finn-no-mobility-listings-scraper-x402-a7caeeec -d '<json body>'
```

Example prompt: Can you pull me the current listings on Finn.no for electric cars made by Tesla in Oslo, priced between 200,000 and 600,000 NOK, from 2019 onwards — give me up to 50 results with just the core comparison fields?

## When to prefer this

Use this endpoint when you need structured, filterable data from Finn.no's Norwegian vehicle and mobility classifieds — especially when you want to search by make, fuel type, price, year, mileage, location, or seller type without building your own scraper. Ideal for price research, inventory monitoring, or market analysis across cars, motorcycles, boats, caravans, motorhomes, and b2b equipment in Norway. The pay-only-on-success model makes it low-risk for exploratory queries.

## Known failure modes

- Empty result set (not charged) — filters too restrictive or no matching listings on Finn
- Invalid category enum value — request rejected
- Unsupported start URL route — non-mobility Finn URLs will fail
- Network/scraping failure — Finn.no may block or throttle requests
- Invalid yearFrom/yearTo or priceFrom/priceTo ranges — may return empty or error
- Payment failure via x402 — call not executed if USDC payment cannot be processed

## How this service works

Pay-per-call structured web data. Failed or empty runs are not charged.

## Output

Returns a JSON object with a count of matched listings and an array of structured listing items. Each item includes fields such as listing ID, ad ID, make, model, title, series, category, and model spec. Fields with null/empty values are omitted by default (configurable). Only charged when results are returned.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "fuel": {
   "type": "string",
   "default": "",
   "description": "Fuel label from the live filter, such as El or Diesel."
  },
  "make": {
   "type": "string",
   "default": "",
   "description": "Vehicle or boat make shown in the live search filter. Labels and raw filter values are accepted."
  },
  "query": {
   "type": "string",
   "default": "",
   "description": "Words to match in listing search. Leave blank to browse all listings."
  },
  "yearTo": {
   "type": "integer",
   "minimum": 1900,
   "description": "Maximum model year, inclusive."
  },
  "compact": {
   "type": "boolean",
   "default": false,
   "description": "Keep only the core comparison fields."
  },
  "priceTo": {
   "type": "integer",
   "minimum": 0,
   "description": "Maximum asking price in Norwegian kroner."
  },
  "category": {
   "enum": [
    "car",
    "mc",
    "boat",
    "caravan",
    "mobilehome",
    "b2b"
   ],
   "type": "string",
   "default": "car",
   "description": "Choose a mobility category. Business equipment starts with construction listings; paste a supported business search URL for trucks or tractors."
  },
  "location": {
   "type": "string",
   "default": "",
   "description": "Region or municipality name from the live location filter, such as Oslo."
  },
  "yearFrom": {
   "type": "integer",
   "minimum": 1900,
   "description": "Minimum model year, inclusive."
  },
  "mileageTo": {
   "type": "integer",
   "minimum": 0,
   "description": "Maximum vehicle mileage in kilometres."
  },
  "omitNulls": {
   "type": "boolean",
   "default": true,
   "description": "Remove fields with missing or empty values from each output row."
  },
  "priceFrom": {
   "type": "integer",
   "minimum": 0,
   "description": "Minimum asking price in Norwegian kroner."
  },
  "startUrls": {
   "type": "array",
   "default": [],
   "description": "One or more Finn mobility search-result URLs. Their filters take precedence over the form inputs. Car, motorcycle, boat, caravan, motorhome, construction, truck, and agricultural tractor routes are supported."
  },
  "maxResults": {
   "type": "integer",
   "default": 100,
   "minimum": 0,
   "description": "Stop after this many unique listings. Zero removes the limit."
  },
  "sellerType": {
   "type": "string",
   "default": "",
   "description": "Seller segment label, such as Privat or Merkeforhandler."
  },
  "mileageFrom": {
   "type": "integer",
   "minimum": 0,
   "description": "Minimum 
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "items": [
   {
    "adId": null,
    "make": null,
    "model": null,
    "title": null,
    "series": null,
    "category": null,
    "listingId": null,
    "modelSpec": null
   }
  ],
  "product": "finn"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/finn-no-mobility-listings-scraper-x402-a7caeeec/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.186-241-26-229.sslip.io](https://www.zero.xyz/host/x402.186-241-26-229.sslip.io/llms.txt)