# Blocket Sweden Scraper - Cars, Classifieds, Prices & Sellers (`abotapi/blocket-se-scraper`) Actor

Scrape Blocket, Sweden's largest marketplace: used cars, motorcycles, boats and goods with prices, specs, equipment, location, photos and seller type. Search by keyword and filters or paste links, and monitor price changes with recurring updates.

- **URL**: https://apify.com/abotapi/blocket-se-scraper.md
- **Developed by:** [Abot API](https://apify.com/abotapi) (community)
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.70 / 1,000 ad results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Blocket Scraper: Swedish Cars, Motorcycles, Boats and Marketplace Ads

Collect ads from Blocket (blocket.se), Sweden's largest marketplace: used cars, motorcycles, boats and marketplace goods with price, model year, mileage, power, equipment, location, coordinates, every photo and the seller type. Search by keyword, make, region and filters, or paste result lists, single ads and sitemaps, and monitor price changes on a schedule.

### Why This Scraper?

- **Four parts of the site.** Used cars, motorcycles, boats and the goods marketplace, each with the filters that make sense for it.
- **Complete vehicle records.** Price, model year, mileage in mil and km, fuel, gearbox, power, engine volume, CO2, fuel consumption, drive, weight, seats, doors, boot volume, colour, registration number, chassis number, inspection dates, owners, equipment and the seller's disclosure answers.
- **Location that maps.** Town, postal code, postal town, latitude, longitude and coordinate accuracy, plus the street address on dealer ads.
- **Photos, text and dealers.** The full photo set, the seller's own description and, on dealer ads, the dealer's profile: organisation number, rating, review count, dealer phone and email, website, address and opening hours.
- **Price monitoring.** Recurring updates label each ad NEW, UPDATED, UNCHANGED, REAPPEARED or EXPIRED, and a price-only mode returns just the ads whose price moved.
- **Resume and export.** Continue an interrupted run, and pipe results into Notion, Linear or Airtable.
- **Transparent billing.** One charge per ad, plus one detail charge for each ad whose own page was read.

### Use Cases

- **Dealers and traders:** benchmark your stock against live asking prices by make, model, year and mileage.
- **Market analysts:** track prices, mileage and equipment trends for a model or a region.
- **Resellers and buyers:** build shortlists of cars, motorcycles, boats or second-hand goods with photos and locations.
- **Price alerts:** run a schedule with price-only recurring updates and receive just the ads that got cheaper.
- **Data teams:** feed a clean, flat ad dataset into a warehouse or a model.

### Data You Get

> Sample shape: values are illustrative placeholders, not from a live record.

| Field | Example |
| --- | --- |
| `id`, `ad_id`, `url` | `00000000`, `0`, `https://www.blocket.se/mobility/item/00000000` |
| `segment`, `vertical`, `category` | `car`, `CAR`, `Bil` |
| `title`, `description` | `Example Make Example Model`, the seller's text |
| `price`, `currency` | `150000`, `SEK` |
| `priceExVat`, `rightToExchange` | dealer ads only, when the ad page shows them: the price excluding VAT (`120000`) and `true` when the dealer lists an exchange policy |
| `year`, `mileage`, `mileageUnit`, `mileageKm` | `2019`, `7500`, `SCANDINAVIAN_MILE`, `75000` |
| `make`, `series`, `model`, `modelSpecification` | `Example Make`, `Example-Serie`, `Example Model`, `2.0 Example Edition` |
| `bodyType`, `fuel`, `transmission`, `wheelDrive` | `SUV`, `Diesel`, `Automatisk`, `Fyrhjulsdrift` |
| `enginePowerHp`, `engineVolume`, `co2`, `fuelConsumption` | `150`, `1998`, `120`, `5.2` |
| `doors`, `seats`, `color`, `weight`, `maxTrailerWeight`, `bootLitres` | `5`, `5`, `Svart`, `1700`, `2000`, `500` |
| `regno`, `chassisNumber`, `registrationClass`, `registrationDate` | `ABC123`, `EXAMPLE00000000000`, `Personbil`, `2019-01-01` |
| `inspectionLast`, `inspectionNext`, `previousOwners` | `2025-01-01`, `2027-01-01`, `2` |
| `salesForm`, `dealerSegment`, `sellerType`, `sellerName`, `orgId`, `adType` | `Begagnad bil till salu`, `Företag`, `dealer`, `Example Cars AB`, `0000000`, `20` |
| `dealer` | dealer ads only: `name`, `orgNumber`, `rating`, `reviewCount`, `phone`, `email`, `website`, `street`, `city`, `country`, `openingHours`, `tenure`, `profileUrl` |
| `labels`, `flags`, `serviceDocuments`, `extras` | lists of badges, flags, service papers and extra attributes |
| `equipment`, `sellerDisclosures`, `specifications` | list of equipment, question and answer pairs, the full spec table |
| `location`, `address`, `postalCode`, `postalName` | `Example Town`, `Example street 1, 00000 Example Town`, `00000`, `Example Town` |
| `latitude`, `longitude`, `coordinateAccuracy` | `59.3`, `18.0`, `5` |
| `imageUrl`, `imageUrls` | main photo, the ad page's whole photo gallery (the result list alone carries the first photos) |
| `publishedAt`, `editedAt` | `2026-01-01T00:00:00Z`, `2026-01-02T00:00:00Z` |
| `condition`, `brand`, `tradeType` | `Used`, `Example Brand`, `Säljes` |
| `available`, `shippingAvailable` | goods only, `true`, `true` |
| `boatClass`, `lengthFeet`, `widthCm`, `motorType`, `motorSizeHp` | boats only |
| `searchUrl`, `page`, `scrapedAt`, `detailError` | result list link, `1`, timestamp, set only when an ad's own page could not be read |

Recurring-update rows add `changeType`, `changedFields`, `firstSeenAt` and `lastSeenAt`.

### How to Use

1. Pick a mode: **Search by filters** or **Paste links**.
2. Pick the part of the site and set the filters (keyword, make, model, category, region, price, model year, mileage, fuel, body type, gearbox, seller type, sort) or paste your links.
3. Set **Max items** (default 20) and leave **Read each ad's own page** on for the full record.
4. Run the actor and download the dataset as JSON, CSV or Excel.

**Search diesel SUVs from a make in one region:**

```json
{
  "mode": "search",
  "segment": "car",
  "make": "Volvo",
  "region": "Skåne",
  "fuel": "diesel",
  "bodyType": "suv",
  "maxItems": 50
}
```

**Search goods by keyword:**

```json
{
  "mode": "search",
  "segment": "goods",
  "keywords": "cykel",
  "condition": "good",
  "maxPrice": 3000,
  "sortBy": "newest",
  "maxItems": 100
}
```

**Paste links:**

```json
{
  "mode": "url",
  "urls": [
    "https://www.blocket.se/mobility/search/car?fuel=4&year_from=2020",
    "https://www.blocket.se/mobility/item/00000000",
    "https://www.blocket.se/recommerce/forsale/search?q=cykel"
  ],
  "maxItems": 100
}
```

#### Supported links

Car, motorcycle and boat result lists (the browse hub, links with filters, sort and page numbers, and the site's own list addresses), goods result lists (including the older annonser address), single ads (the full address or the short number address) and sitemaps, which are read in order until the limit is reached. The mobile address works too, and tracking parameters are ignored. Rental housing pages and other parts of the site are skipped with a notice, and a run with nothing readable fails with a message. Pagination starts at the page named in the link and walks forward.

#### Run it from your code

**Python:**

```python
from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run = client.actor("<ACTOR_ID>").call(run_input={
    "mode": "search",
    "segment": "car",
    "make": "Volvo",
    "maxItems": 20,
})
for ad in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(ad["title"], ad["price"], ad["mileageKm"])
```

**JavaScript:**

```javascript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: '<YOUR_APIFY_TOKEN>' });
const run = await client.actor('<ACTOR_ID>').call({ mode: 'search', segment: 'car', make: 'Volvo', maxItems: 20 });
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items.length);
```

#### Tips

- **Depth per search:** the site serves at most 2 500 ads per search (50 pages of 50). To go deeper, split the search with filters such as price bands, years or regions; a run that hit that limit never reports ads as gone.
- **Names, not codes:** make, model, category and region are looked up by the names the site lists, for example Volvo, XC60, Cyklar or Skåne. A name the site does not list stops the run with a message.
- **Mileage:** the site counts mileage in Swedish mil (1 mil = 10 km). `mileage` keeps the site's value and `mileageKm` converts it.
- **Max items versus max pages:** Max items is the single limit that stops a run. Max pages is an optional guard per search or link and never caps the run on its own.
- **Pasted ads:** a pasted ad link is read from the ad page, so those rows carry the full record and the detail charge. Result-list coordinates are only present on rows that come from a list or from a goods ad.

#### Resume and recurring updates

Continue a previous run finishes ONE interrupted run: give its run id and every ad it already collected is skipped. Recurring updates is for running the same search on a schedule: each run returns what changed since the last one. Both together are refused once a baseline exists. A run that stopped early, that hit the 2 500-ad limit of a search, or that started from a pasted page beyond the first, never reports ads as gone.

#### Dataset views

Results (headline fields), Ad details (spec table, equipment, description, address, photos), and Changes (recurring-update rows).

### Send results into your apps (MCP connectors)

Optionally pipe the scraped ads into the apps you already use, via Model Context Protocol (MCP) connectors. This is an extra delivery step **after** the scrape: the Apify dataset is never changed.

**What gets written to the connector:** a condensed, human-readable **summary** of each ad, not the full JSON. Each car becomes one entry with a **title** and its key fields flattened to plain text. The **complete record always stays in the Apify dataset**.

1. Authorize a connector once under **Apify > Settings > Integrations** (Notion, Linear, Airtable, or Apify).
2. Select it in the **"Pipe results into your apps"** input field. (If the picker is empty, you haven't authorized a connector yet.)
3. For **Notion**, also set `notionParentPageUrl` to the page where ads should be created.

The connection is mediated by Apify's MCP proxy, so this actor never sees your third-party credentials. Leave the field empty to skip.

### Input Parameters

| Parameter | Type | Default | Description |
| --- | --- | --- | --- |
| `mode` | string | `search` | `search` filters or `url` pasted links. |
| `segment` | string | `car` | Used cars, motorcycles, boats or goods. |
| `keywords` | string | none | Free-text search. |
| `make` | string | none | Brand as the site lists it (cars, motorcycles, boats). |
| `model` | string | none | Model or series name under the make (cars). |
| `category` | string | none | Category name as the site lists it (goods). |
| `region` | string | none | County or town name as the site lists it. |
| `minPrice` | integer | none | Lowest price in SEK. |
| `maxPrice` | integer | none | Highest price in SEK. |
| `minYear` | integer | none | Earliest model year (vehicles and boats). |
| `maxYear` | integer | none | Latest model year (vehicles and boats). |
| `maxMileage` | integer | none | Highest mileage in Swedish mil (cars and motorcycles). |
| `fuel` | string | `any` | Fuel type (cars). |
| `bodyType` | string | `any` | Body type (cars). |
| `transmission` | string | `any` | Manual or automatic (cars). |
| `sellerType` | string | `any` | Dealers and companies, or private sellers. |
| `condition` | string | `any` | Item condition (goods). |
| `tradeType` | string | `any` | For sale, given away or wanted (goods). |
| `newToday` | boolean | `false` | Only ads published today. |
| `sortBy` | string | `default` | Site default, newest, price ascending or descending, lowest mileage, newest model year. |
| `urls` | array | sample links | Result lists, single ads and sitemaps. |
| `fetchDetails` | boolean | `true` | Read each ad's own page for the full record. |
| `maxPages` | integer | none | Optional guard per search or link; empty means no page limit. |
| `maxItems` | integer | `20` | The single limit that stops a run; 0 means no limit. |
| `proxy` | object | standard Apify proxy | Proxy settings. |
| `resumeFromRunId` | string | none | Run id of an interrupted run to continue. |
| `incrementalMode` | boolean | `false` | Label ads against the previous run of the same setup. |
| `stateKey` | string | none | Name the baseline of a recurring schedule. |
| `emitUnchanged` | boolean | `false` | Also return unchanged ads. |
| `emitExpired` | boolean | `false` | Also return ads that are gone. |
| `changeScope` | string | `all` | Any listing field, or price only. |
| `compactUpdates` | boolean | `false` | Short rows for updated and gone ads. |
| `expireAfterMissedScans` | integer | `1` | Complete scans an ad must be missing before it is marked gone. |
| `ignoreFieldsForChanges` | array | none | Fields that never make an ad UPDATED. |
| `mcpConnectors` | array | none | Connectors to pipe results into after the run. |
| `notionParentPageUrl` | string | none | Notion parent page for the Notion connector. |
| `maxNotifyListings` | integer | `50` | Rows each connector receives per run. |

### Output Example

> Sample shape: values are illustrative placeholders, not from a live record.

```json
{
  "id": "00000000",
  "ad_id": 0,
  "url": "https://www.blocket.se/mobility/item/00000000",
  "segment": "car",
  "title": "Example Make Example Model",
  "price": 150000,
  "currency": "SEK",
  "year": 2019,
  "mileage": 7500,
  "mileageUnit": "SCANDINAVIAN_MILE",
  "mileageKm": 75000,
  "make": "Example Make",
  "model": "Example Model",
  "bodyType": "SUV",
  "fuel": "Diesel",
  "transmission": "Automatisk",
  "enginePowerHp": 150,
  "engineVolume": 1998,
  "doors": 5,
  "seats": 5,
  "color": "Svart",
  "regno": "ABC123",
  "sellerType": "dealer",
  "dealer": {"name": "Example Cars AB", "rating": 4.2, "reviewCount": 100, "city": "Example Town"},
  "equipment": ["ABS", "Bluetooth"],
  "location": "Example Town",
  "postalCode": "00000",
  "latitude": 59.3,
  "longitude": 18.0,
  "imageUrl": "https://example.com/photo.jpg",
  "publishedAt": "2026-01-01T00:00:00Z",
  "page": 1,
  "scrapedAt": "2026-01-01T00:00:00Z"
}
```

### Plan Requirement

The default proxy setting is the standard Apify proxy pool. In our checks the site served its search results and ad pages through that pool on every route, so a standard run needs no action. The standard pool works on every plan; Residential is recommended for the most reliable results on large or frequent runs. If you select Residential, the run still tries the cheaper standard pool first and moves to Residential only if the site refuses it.

What the run does, in order:

1. It starts on the standard Apify proxy pool.
2. If that pool is refused for your account, or keeps failing, it tries Apify Residential, which only paid Apify plans include. Residential traffic from this automatic step is billed to your own Apify plan, and the run limits how much it uses. Apify free plans do not include residential proxies, and then the log prints "The selected connection is unavailable to this run" with a pointer to https://apify.com/pricing.
3. It then continues on a backup connection, and the log says "Served over the backup connection" once that connection serves a page. On a free plan some pages may still be unavailable.
4. If every connection is refused, the run stops as failed with "The proxy connection was refused for this account, so no page could be read" (a paid Apify plan is required) instead of returning an empty dataset. If only the backup connection was left and it could not load the pages, the message reads "No results: residential proxies are unavailable on this run".
5. A read that is refused by the site, or cannot be completed within the per-page time limit (about 25 seconds), skips that source with a notice in the log, and the run keeps the other sources. If no result list loaded at all, the run ends with "Could not load any results page ... This is a connection problem, not an empty search".

If you hit these messages, switch to a paid Apify plan, or supply your own proxy URLs in the proxy field (a single custom proxy is used as is, with no backup connection). For very large runs Residential is the most reliable choice.

Billing for each event is in the FAQ below, and the **Pricing** tab shows the current rates.

### FAQ

#### How much does it cost?

The run is billed on three events, and the **Pricing** tab shows the current rate of each:

- **Ad result:** once for every record written to the dataset, including a short `UPDATED` row.
- **Detail enrichment:** once for every ad whose own page was read and merged into a record you receive, whether you left ad page reading on or pasted an ad link. The dealer profile of a dealer ad rides this event: it is read once per dealer and shared by all of that dealer's ads in the run, so it adds no further charge. An ad that is not written (an unchanged one in recurring updates) is not charged this event, and neither is a short `UPDATED` row (`compactUpdates`), which carries no detail fields.
- **Actor Start:** once per GB of memory when the run starts, at least one.

Use **Max items** to cap the cost of any run.

#### Is it legal to scrape Blocket?

This actor collects only publicly available listing data. You are responsible for how you use it: follow the site's terms and the laws that apply to you, and get legal advice if you plan commercial redistribution. Listing photos and seller text may carry their own rights separate from the underlying facts, and personal data in an ad falls under data protection law.

#### Can I get only new or changed ads on a schedule?

Yes. Schedule the actor from the **Schedules** tab and turn on **recurring updates**. Each run then returns only new and updated ads, unchanged ones are not billed, and gone ads can be reported too once a run has scanned its scope end to end. Choose **Price only** to be told just about price moves.

#### Why were no gone ads reported this run?

Gone ads are only reported after a run that read every one of its sources to the end. If a limit stopped the run, a source hit **Max pages** or ran out of **Max items** partway through, a search held more than the 2 500 ads the site serves, a source failed, a pasted page started beyond the first, or the run continued a previous one, detection is skipped for the whole run (the run log says why) and the ads stay tracked. The next complete run reports them.

#### Why are the description, equipment or postal code empty?

Those fields come from an ad's own page. Leave **Read each ad's own page** on, or paste ad links directly; they are always read in full. The result list alone carries price, year, mileage, make, model, town, coordinates and the first photos. Some dealer ads carry only a dash as their description. The `dealer` object is filled on dealer ads only, and is left out when the dealer's page cannot be read; the ad itself is still returned. It never counts as a change in recurring updates.

#### Why did my run fail instead of returning an empty dataset?

If every page the run tried was refused, the run stops with a clear message so "no ads for this search" is never confused with "nothing could be read". Run it again in a few minutes. If only some links failed, you still get what was found, with a notice.

#### Can I use it with AI agents or MCP?

Yes. Call it from any Apify integration or MCP client, and use the connector field to push results into Notion, Linear or Airtable.

### 🔗 Want more car data?

Pair this actor with these related scrapers from the same team:

<table>
<tr><td>🚗 <a href="https://apify.com/abotapi/mobile-de-scraper"><b>mobile.de Scraper</b></a><br>Scrape mobile.de vehicle listings with 30+ fields including price, mileage, registration...</td><td>🚗 <a href="https://apify.com/abotapi/auto-ru-scraper"><b>Auto.ru Scraper</b></a><br>Scrape Auto.ru car listings: search by make, model, year, price, mileage, body, engine...</td></tr>
<tr><td>🏷️ <a href="https://apify.com/abotapi/mudah-my-scraper"><b>Mudah.my Cars, Property, Jobs &amp; Marketplace Scraper</b></a><br>Scrape Mudah.my listings across every category: cars, motorcycles, property, mobiles...</td><td>🚗 <a href="https://apify.com/abotapi/cars-com-scraper"><b>Cars.com Scraper</b></a><br>Scrape cars.com listings by make, ZIP and radius. 90+ fields per car: price, MSRP...</td></tr>
<tr><td>🚗 <a href="https://apify.com/abotapi/autoscout24-scraper"><b>AutoScout24 Scraper</b></a><br>A lean, production-grade scraper for autoscout24.com. Point it at a search, get back...</td><td>🚗 <a href="https://apify.com/abotapi/autotrader"><b>AutoTrader UK Scraper</b></a><br>Pull structured vehicle listings from autotrader.co.uk at scale. Search by filters or use...</td></tr>
</table>

👉 [Browse all abotapi scrapers](https://apify.com/abotapi)

### 💬 Support

- 🐞 **Found a bug or a missing field?** Open a ticket on the [Issues tab](https://apify.com/abotapi/blocket-se-scraper/issues/open). We usually reply within hours.
- 🛠️ **Need another site, extra fields or a private build?** Email <contact@abotapi.com>.
- ⭐ **Enjoying it?** A quick review on the actor page helps other users find it.

# Actor input Schema

## `mode` (type: `string`):

Search by filters walks the result list for the segment and filters below. Paste links walks the links you paste, forward from the page each link names.

## `segment` (type: `string`):

Used cars, motorcycles, boats or goods from the marketplace. The filters below apply where they make sense (fuel and body type are for cars, category and condition are for goods).

## `keywords` (type: `string`):

Free-text search, for example volvo xc60 or cykel. Works with every filter below.

## `make` (type: `string`):

Cars, motorcycles and boats: the brand as the site lists it, for example Volvo, Yamaha or Bayliner. Leave empty for every brand.

## `model` (type: `string`):

Cars only: a model or series name as the site lists it under the make, for example XC60 or V70-Serie. Works best together with Make.

## `category` (type: `string`):

Goods only: a category name as the site lists it, for example Cyklar, Barncyklar or Mobiltelefoner. Leave empty for every category.

## `region` (type: `string`):

A county or town name as the site lists it, for example Skåne, Stockholm or Karlskrona. Leave empty for the whole country.

## `minPrice` (type: `integer`):

Lowest price in Swedish kronor, for example 50000.

## `maxPrice` (type: `integer`):

Highest price in Swedish kronor, for example 200000.

## `minYear` (type: `integer`):

Cars, motorcycles and boats: only this model year or later, for example 2018.

## `maxYear` (type: `integer`):

Cars, motorcycles and boats: only this model year or earlier, for example 2022.

## `maxMileage` (type: `integer`):

Cars and motorcycles: at most this many mil on the clock (1 mil = 10 km), for example 15000 for 150 000 km.

## `fuel` (type: `string`):

Cars only: only this fuel type, applied by the site itself.

## `bodyType` (type: `string`):

Cars only: only this body type, applied by the site itself.

## `transmission` (type: `string`):

Cars only: only manual or only automatic gearbox.

## `sellerType` (type: `string`):

Only ads from dealers and companies, or only from private sellers.

## `condition` (type: `string`):

Goods only: only items in this condition, applied by the site itself.

## `tradeType` (type: `string`):

Goods only: for sale, given away or wanted ads.

## `newToday` (type: `boolean`):

Turn on to keep only the ads the site marks as new from today.

## `sortBy` (type: `string`):

Order of the results, applied by the site itself. The site serves at most 2 500 ads per search, so combine a sort order with filters to reach deeper.

## `urls` (type: `array`):

Result lists (cars, motorcycles, boats, goods), single ads, short ad links and sitemaps. The filters in the link are applied and pages are walked forward from the page the link names. The filter fields above are ignored in this mode.

## `fetchDetails` (type: `boolean`):

The result list carries price, year, mileage, make, model, location, coordinates and the first photos. An ad's own page adds the description, the spec table (power, engine volume, weight, seats, inspection dates, owners and more), the equipment list, the postal address and every photo. A per-ad detail-enrichment charge applies when this is on.

## `maxPages` (type: `integer`):

Optional guard per search or link: stop after this many result pages. Empty or 0 (the default) means no page limit. It does not cap the run and defers to Max items, which is the single cap (default 20).

## `maxItems` (type: `integer`):

The single limit that stops a run. Default 20 ads; 0 means no limit (at most 1,000,000).

## `proxy` (type: `object`):

The site serves its data to the standard Apify proxy pool, so that is the default. Residential also works and is recommended for the most reliable results on large or frequent runs.

## `resumeFromRunId` (type: `string`):

Give the run id of an interrupted run and every ad it already collected is skipped. Mutually exclusive with recurring updates once a baseline exists.

## `incrementalMode` (type: `boolean`):

Label every ad NEW, UPDATED, UNCHANGED or REAPPEARED against the previous run of the same setup, and record the ones that vanished as EXPIRED. UPDATED means a compared field moved: price, mileage, description, equipment, photos, seller details, inspection dates and the other listing facts. Never compared: the run time, the result page number, the search link, and the published and last-edited times (the site re-stamps them when a seller refreshes an ad). Unchanged ads are not returned unless you also turn on the return-unchanged switch. Returns (and bills) extra rows only for what changed.

## `stateKey` (type: `string`):

Name the baseline of a recurring schedule yourself. Without it the baseline is keyed on the whole search setup, so two differently-configured schedules never share one baseline.

## `emitUnchanged` (type: `boolean`):

Returns (and bills) every tracked ad again, labelled UNCHANGED, instead of only the changed ones.

## `emitExpired` (type: `boolean`):

Ads tracked by the previous run but absent from a COMPLETE scan are returned (and billed) one last time, labelled EXPIRED. A run that stopped early never reports ads as gone.

## `changeScope` (type: `string`):

Any listing field: every compared field can make an ad UPDATED. Price only: just the price and currency decide UPDATED, so description, photo and equipment edits never produce a returned row. Changing this changes which baseline an automatic state key uses.

## `compactUpdates` (type: `boolean`):

UPDATED and EXPIRED rows come back short: ids, link, title, current price and priceChanges with the old and new value of each moved field. New ads stay full. The per-ad detail charge is not applied to a short row because it carries no detail fields.

## `expireAfterMissedScans` (type: `integer`):

With the gone-ads switch on, an ad is returned as EXPIRED only after it was missing from this many complete scans in a row. An ad that left the results and a sold one look the same without opening each ad page.

## `ignoreFieldsForChanges` (type: `array`):

Field names that never make an ad UPDATED and are left out of changedFields (they stay in the output). Use a dotted path to ignore one key inside a nested list, for example extras.label. Leave empty to compare every listing field. Changing this changes which baseline an automatic state key uses.

## `mcpConnectors` (type: `array`):

Optional delivery step AFTER the scrape: pipes dataset results into apps you connected in the Apify MCP Connector setup.

## `notionParentPageUrl` (type: `string`):

Notion connector only: the parent page new Notion pages attach under.

## `maxNotifyListings` (type: `integer`):

How many dataset rows at most each connector receives per run.

## Actor input object example

```json
{
  "mode": "search",
  "segment": "car",
  "fuel": "any",
  "bodyType": "any",
  "transmission": "any",
  "sellerType": "any",
  "condition": "any",
  "tradeType": "any",
  "newToday": false,
  "sortBy": "default",
  "urls": [
    "https://www.blocket.se/mobility/item/28291881",
    "https://www.blocket.se/28291881",
    "https://www.blocket.se/recommerce/forsale/item/28283080",
    "https://www.blocket.se/mobility/search/car?page=2",
    "https://www.blocket.se/mobility/search/api/search/SEARCH_ID_CAR_USED?page=2&sort=PRICE_ASC",
    "https://www.blocket.se/mobility/search/api/search/SEARCH_ID_CAR_USED?sort=PUBLISHED_DESC&year_from=2020&price_to=100000&location=0.300010",
    "https://www.blocket.se/mobility/search/api/search/SEARCH_ID_MC_USED",
    "https://www.blocket.se/mobility/search/api/search/SEARCH_ID_BOAT_USED",
    "https://www.blocket.se/mobility/search/mc",
    "https://www.blocket.se/mobility/browse/car",
    "https://www.blocket.se/mobility/search/car?make=0.785",
    "https://www.blocket.se/recommerce/forsale/search?q=cykel&page=2",
    "https://www.blocket.se/recommerce/forsale/search/api/search/SEARCH_ID_BAP_COMMON?q=cykel&page=2",
    "https://www.blocket.se/recommerce/forsale/search?category=0.71&location=0.300010",
    "https://www.blocket.se/annonser/hela_sverige?q=cykel",
    "https://www.blocket.se/mobility/search/car?utm_source=x&gclid=1",
    "https://www.blocket.se/sitemap.xml",
    "https://m.blocket.se/mobility/search/car",
    "https://www.blocket.se/bostad"
  ],
  "fetchDetails": true,
  "maxItems": 20,
  "proxy": {
    "useApifyProxy": true
  },
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "changeScope": "all",
  "compactUpdates": false,
  "expireAfterMissedScans": 1,
  "maxNotifyListings": 50
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

## `detail` (type: `string`):

No description

## `changes` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "mode": "search",
    "segment": "car",
    "newToday": false,
    "urls": [
        "https://www.blocket.se/mobility/item/28291881",
        "https://www.blocket.se/28291881",
        "https://www.blocket.se/recommerce/forsale/item/28283080",
        "https://www.blocket.se/mobility/search/car?page=2",
        "https://www.blocket.se/mobility/search/api/search/SEARCH_ID_CAR_USED?page=2&sort=PRICE_ASC",
        "https://www.blocket.se/mobility/search/api/search/SEARCH_ID_CAR_USED?sort=PUBLISHED_DESC&year_from=2020&price_to=100000&location=0.300010",
        "https://www.blocket.se/mobility/search/api/search/SEARCH_ID_MC_USED",
        "https://www.blocket.se/mobility/search/api/search/SEARCH_ID_BOAT_USED",
        "https://www.blocket.se/mobility/search/mc",
        "https://www.blocket.se/mobility/browse/car",
        "https://www.blocket.se/mobility/search/car?make=0.785",
        "https://www.blocket.se/recommerce/forsale/search?q=cykel&page=2",
        "https://www.blocket.se/recommerce/forsale/search/api/search/SEARCH_ID_BAP_COMMON?q=cykel&page=2",
        "https://www.blocket.se/recommerce/forsale/search?category=0.71&location=0.300010",
        "https://www.blocket.se/annonser/hela_sverige?q=cykel",
        "https://www.blocket.se/mobility/search/car?utm_source=x&gclid=1",
        "https://www.blocket.se/sitemap.xml",
        "https://m.blocket.se/mobility/search/car",
        "https://www.blocket.se/bostad"
    ],
    "fetchDetails": true,
    "maxItems": 20,
    "proxy": {
        "useApifyProxy": true
    },
    "incrementalMode": false,
    "emitUnchanged": false,
    "emitExpired": false,
    "changeScope": "all",
    "compactUpdates": false,
    "expireAfterMissedScans": 1,
    "maxNotifyListings": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("abotapi/blocket-se-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "mode": "search",
    "segment": "car",
    "newToday": False,
    "urls": [
        "https://www.blocket.se/mobility/item/28291881",
        "https://www.blocket.se/28291881",
        "https://www.blocket.se/recommerce/forsale/item/28283080",
        "https://www.blocket.se/mobility/search/car?page=2",
        "https://www.blocket.se/mobility/search/api/search/SEARCH_ID_CAR_USED?page=2&sort=PRICE_ASC",
        "https://www.blocket.se/mobility/search/api/search/SEARCH_ID_CAR_USED?sort=PUBLISHED_DESC&year_from=2020&price_to=100000&location=0.300010",
        "https://www.blocket.se/mobility/search/api/search/SEARCH_ID_MC_USED",
        "https://www.blocket.se/mobility/search/api/search/SEARCH_ID_BOAT_USED",
        "https://www.blocket.se/mobility/search/mc",
        "https://www.blocket.se/mobility/browse/car",
        "https://www.blocket.se/mobility/search/car?make=0.785",
        "https://www.blocket.se/recommerce/forsale/search?q=cykel&page=2",
        "https://www.blocket.se/recommerce/forsale/search/api/search/SEARCH_ID_BAP_COMMON?q=cykel&page=2",
        "https://www.blocket.se/recommerce/forsale/search?category=0.71&location=0.300010",
        "https://www.blocket.se/annonser/hela_sverige?q=cykel",
        "https://www.blocket.se/mobility/search/car?utm_source=x&gclid=1",
        "https://www.blocket.se/sitemap.xml",
        "https://m.blocket.se/mobility/search/car",
        "https://www.blocket.se/bostad",
    ],
    "fetchDetails": True,
    "maxItems": 20,
    "proxy": { "useApifyProxy": True },
    "incrementalMode": False,
    "emitUnchanged": False,
    "emitExpired": False,
    "changeScope": "all",
    "compactUpdates": False,
    "expireAfterMissedScans": 1,
    "maxNotifyListings": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("abotapi/blocket-se-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "mode": "search",
  "segment": "car",
  "newToday": false,
  "urls": [
    "https://www.blocket.se/mobility/item/28291881",
    "https://www.blocket.se/28291881",
    "https://www.blocket.se/recommerce/forsale/item/28283080",
    "https://www.blocket.se/mobility/search/car?page=2",
    "https://www.blocket.se/mobility/search/api/search/SEARCH_ID_CAR_USED?page=2&sort=PRICE_ASC",
    "https://www.blocket.se/mobility/search/api/search/SEARCH_ID_CAR_USED?sort=PUBLISHED_DESC&year_from=2020&price_to=100000&location=0.300010",
    "https://www.blocket.se/mobility/search/api/search/SEARCH_ID_MC_USED",
    "https://www.blocket.se/mobility/search/api/search/SEARCH_ID_BOAT_USED",
    "https://www.blocket.se/mobility/search/mc",
    "https://www.blocket.se/mobility/browse/car",
    "https://www.blocket.se/mobility/search/car?make=0.785",
    "https://www.blocket.se/recommerce/forsale/search?q=cykel&page=2",
    "https://www.blocket.se/recommerce/forsale/search/api/search/SEARCH_ID_BAP_COMMON?q=cykel&page=2",
    "https://www.blocket.se/recommerce/forsale/search?category=0.71&location=0.300010",
    "https://www.blocket.se/annonser/hela_sverige?q=cykel",
    "https://www.blocket.se/mobility/search/car?utm_source=x&gclid=1",
    "https://www.blocket.se/sitemap.xml",
    "https://m.blocket.se/mobility/search/car",
    "https://www.blocket.se/bostad"
  ],
  "fetchDetails": true,
  "maxItems": 20,
  "proxy": {
    "useApifyProxy": true
  },
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "changeScope": "all",
  "compactUpdates": false,
  "expireAfterMissedScans": 1,
  "maxNotifyListings": 50
}' |
apify call abotapi/blocket-se-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,abotapi/blocket-se-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/dN4c3g8q0wykXWpsf/builds/QU9reyxj2VhCLRSdm/openapi.json
