Looking for the overview — what this API returns, what it costs, and a call you can run without a key? See the Huuto.net Finland auctions and fixed-price listings API page →

Classifieds & Second-hand

Huuto.net Finland auctions and fixed-price listings API & Scraper

Huuto.net Finland auctions and fixed-price listings API returns live Huuto.net Finland auctions and fixed-price listings data as clean JSON for huuto.net finland auctions and fixed-price listings The primary endpoint, search, returns Source listing IDs, canonical URLs, titles, EUR current display/price basis, bidder count, buy-now amount, seller handle, location, image….

2 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 creditsMCP-ready

Get a free key Open in playground

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

Developers reach for it when they need to read second-hand listings, asking prices, seller inventory and country-specific listing ids without maintaining one-off scraping code or separate API contracts. If you were about to build or fix a Huuto.net Finland auctions and fixed-price listings scraper, this API is the maintained alternative — it returns the same data as clean JSON, with the proxies, rotation and anti-bot handling already solved. This page covers the live example, request shape, response shape and available actions: search, listing. Every request uses the same ReefAPI envelope, one API key and one shared credit pool, so it fits alongside the rest of your data stack.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on Oct 2, 2026, 11:03 PM UTC.

Captured request

{
  "method": "POST",
  "url": "https://api.reefapi.com/huuto/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "words": "iphone",
    "page": 1
  }
}

Captured response

{
  "ok": true,
  "meta": {
    "api": "huuto",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 1854.9,
    "record_count": 50,
    "bytes": 45265,
    "cache_hit": false,
    "upstream_requests": 1,
    "charged_credits": 2,
    "version": "1.0.0",
    "request_id": "9159287d7bb14a9f",
    "queue_ms": 1
  },
  "data": {
    "listings": [
      {
        "listing_id": "653381234",
        "url": "https://www.huuto.net/kohteet/iphone-x/653381234",
        "title": "Iphone x",
        "country": "FI",
        "sale_method": "buy-now",
        "price": {
          "amount": 50,
          "currency": "EUR",
          "basis": "fixed_asking",
          "status": "available"
        },
        "source_current_price": 50,
        "starting_bid": null,
        "current_bid": null,
        "buy_now_price": 50,
        "bidder_count": 0,
        "offer_count": 0,
        "has_reserve_price": false,
        "reserve_exceeded": false,
        "location": "VANTAA",
        "postal_code": "01300",
        "category": "Matkapuhelimet, Apple",
        "list_time": "2026-09-27T14:24:19+0300",
        "closing_time": "2026-10-06T06:29:34+0300",
        "seller": {
          "name": "icamyy",
          "id": 2399591,
          "type": "unknown"
        },
        "images": [
          "https://images.huuto.net/v1/d7ac/87ba311ab1e4e6f1f13a983bd2a/551175941-m.jpg"
        ],
        "status": null,
        "gtin": null
      },
      {
        "listing_id": "653567348",
        "url": "https://www.huuto.net/kohteet/iphone-xs/653567348",
        "title": "iPhone xs",
        "country": "FI",
        "sale_method": "buy-now",
        "price": {
          "amount": 70,
          "currency": "EUR",
          "basis": "fixed_asking",
          "status": "available"
        },
        "source_current_price": 70,
        "starting_bid": null,
        "current_bid": null,
        "buy_now_price": 70,
        "bidder_count": 0,
        "offer_count": 0,
        "has_reserve_price": false,
        "reserve_exceeded": false,
        "location": "RUOVESI",
        "postal_code": "34600",
        "category": "Matkapuhelimet, Apple",
        "list_time": "2026-10-01T18:15:17+0300",
        "closing_time": "2026-11-30T18:08:00+0200",
        "seller": {
          "name": "Target",
          "id": 2833664,
          "type": "unknown"
        },
        "images": [
          "https://images.huuto.net/v1/af98/feaf45df1282ccee9aeaecf8466/577733145-m.jpg"
        ],
        "status": null,
        "gtin": null
      },
      {
        "listing_id": "652164949",
        "url": "https://www.huuto.net/kohteet/iphone-6s-viallinen/652164949",
        "title": "iPhone 6S, viallinen",
        "country": "FI",
        "sale_method": "buy-now",
        "price": {
          "amount": 6,
          "currency": "EUR",
          "basis": "fixed_asking",
          "status": "available"
        },
        "source_current_price": 6,
        "starting_bid": null,
        "current_bid": null,
        "buy_now_price": 6,
        "bidder_count": 0,
        "offer_count": 0,
        "has_reserve_price": false,
        "reserve_exceeded": false,
        "location": "TURKU",
        "postal_code": "20100",
        "category": "Matkapuhelimet, Apple",
        "list_time": "2026-09-08T18:42:44+0300",
        "closing_time": "2026-12-16T17:25:00+0200",
        "seller": {
          "name": "Kundun",
          "id": 715877,
          "type": "unknown"
        },
        "images": [
          "https://images.huuto.net/v1/6cdc/cc38ed79b88338cb5726e4f38e3/576819370-m.jpg"
        ],
        "status": null,
        "gtin": null
      }
    ],
    "total": 984,
    "page": 1,
    "last_page": 20,
    "has_more": true,
    "empty": false,
    "country": "FI",
    "updated": "2026-10-03T02:03:48+0300"
  }
}

Actions

What the Huuto.net Finland auctions and fixed-price listings API does

Action	Description	Concrete use case	Key params
search	Search public Finnish marketplace inventory and retain source auction/fixed asking bases.	Price-intelligence teams call search to search public Finnish marketplace inventory and retain source auction/fixed asking bases..	words, page
listing	Full public listing detail by search listing_id, including source description, media and explicit listing status.	Classifieds aggregators call listing to get full public listing detail by search listing_id, including source description, media and expl….	listing_id

Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/huuto/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"words":"iphone","page":1}'

import requests

r = requests.post(
    "https://api.reefapi.com/huuto/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "words": "iphone",
  "page": 1
},
)
print(r.json()["data"])

const res = await fetch("https://api.reefapi.com/huuto/v1/search", {
  method: "POST",
  headers: {
    "x-api-key": process.env.REEF_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
  "words": "iphone",
  "page": 1
}),
});
const { ok, data, meta, error } = await res.json();

MCP one-liner

Ask your MCP-connected assistant: call reefapi.huuto.search with {"words":"iphone","page":1}.

Use cases

Who uses this API and why

Price-intelligence teams use Huuto.net Finland auctions and fixed-price listings to search public Finnish marketplace inventory and retain source auction/fixed asking bases..
Classifieds aggregators use Huuto.net Finland auctions and fixed-price listings to get full public listing detail by search listing_id, including source description, media and expl….
Resale and arbitrage tools use Huuto.net Finland auctions and fixed-price listings to read second-hand listings, asking prices, seller inventory and country-specific listing ids, all from one ReefAPI key and credit pool.

FAQ

Questions developers ask before integrating

What is the Huuto.net Finland auctions and fixed-price listings API?

Huuto.net Finland auctions and fixed-price listings API is a ReefAPI endpoint group for huuto.net finland auctions and fixed-price listings It returns live JSON through POST requests under /huuto/v1.

Is the Huuto.net Finland auctions and fixed-price listings API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Huuto.net Finland auctions and fixed-price listings calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Huuto.net Finland auctions and fixed-price listings login or account?

No login to Huuto.net Finland auctions and fixed-price listings is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Huuto.net Finland auctions and fixed-price listings data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Huuto.net Finland auctions and fixed-price listings API use?

Huuto.net Finland auctions and fixed-price listings actions currently cost 1-2 credits per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.

Can I call Huuto.net Finland auctions and fixed-price listings from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call huuto actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the Huuto.net Finland auctions and fixed-price listings API a Huuto.net Finland auctions and fixed-price listings scraper?

It is the managed alternative to a DIY Huuto.net Finland auctions and fixed-price listings scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same huuto.net finland auctions and fixed-price listings back as clean JSON.

Why does my Huuto.net Finland auctions and fixed-price listings scraper keep getting blocked?

Most Huuto.net Finland auctions and fixed-price listings scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked calls are free.

docs / huuto

Huuto.net Finland auctions and fixed-price listings

base /huuto/v12 endpoints

post/huuto/v1/search2 credits

Search public Finnish marketplace inventory and retain source auction/fixed asking bases.

Parameter		Allowed / range	Description
words	optional	—	Source search words, up to 200 characters. Omit for source unfiltered inventory.
page = 1	optional	1–1000	One source page; this engine caps requests at 1000, not an upstream ceiling claim.

Try in playground →

post/huuto/v1/listing1 credit

Full public listing detail by search listing_id, including source description, media and explicit listing status.

Parameter		Allowed / range	Description
listing_id	required	—	Numeric source item ID returned by search.

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/huuto/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"words":"iphone","page":1}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}

Built for volume

5M+ requests a day

Measured at 60 requests a second across the fleet, with no central bottleneck. Volume pricing is on request, and per-key limits are raised for high-volume accounts.

Missing a source?

We build it

Tell us a site we do not cover yet and it becomes an engine. A customer asked for bestprice.gr on a Sunday and it was in the catalog the next day.

Support

2 minute median reply

Median time from a question in the live chat to the first answer, measured across every answered conversation. Setup help included, no support tier to buy.

One key, one balance

Every API included

No per-site plans and no separate subscriptions. One key and one credit pool across the whole catalog, so adding a source costs nothing up front.

Planning something large? Tell us the volume and the sources and we will come back with what it costs and what we would have to build.