{
  "openapi": "3.0.1",
  "info": {
    "title": "Blocket Scraper: Sweden Marketplace Listings",
    "description": "Scrape Blocket.se, Sweden's biggest marketplace, by search term. Title, price in SEK, location with coordinates, posting time, private or retailer seller, shipping and buy-now flags, photos, plus brand and memory size where listed. Unofficial.",
    "version": "0.1",
    "x-build-id": "m0ih7Hiel5YIV3cp1"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/reventadata~blocket-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-reventadata-blocket-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/reventadata~blocket-scraper/runs": {
      "post": {
        "operationId": "runs-sync-reventadata-blocket-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/reventadata~blocket-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-reventadata-blocket-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "searchQueries"
        ],
        "properties": {
          "searchQueries": {
            "title": "Search terms",
            "type": "array",
            "description": "One search per term across blocket.se (Sweden), the site's 'Torget' second-hand marketplace. Several words in one term must all appear in the ad title or brand when 'Require the query in the title' is on.",
            "items": {
              "type": "string"
            }
          },
          "category": {
            "title": "Category",
            "enum": [
              "any",
              "business",
              "building-garden",
              "animals",
              "electronics",
              "vehicle-accessories",
              "parents-children",
              "clothes-cosmetics",
              "art-antiques",
              "furniture-interior",
              "sports-outdoors",
              "entertainment-hobby"
            ],
            "type": "string",
            "description": "Optional top-level category. Narrows every search term to that category. Any category searches all of Torget.",
            "default": "any"
          },
          "location": {
            "title": "County",
            "enum": [
              "any",
              "blekinge",
              "dalarna",
              "gotland",
              "gavleborg",
              "halland",
              "jamtland",
              "jonkoping",
              "kalmar",
              "kronoberg",
              "norrbotten",
              "skane",
              "stockholm",
              "sodermanland",
              "uppsala",
              "varmland",
              "vasterbotten",
              "vasternorrland",
              "vastmanland",
              "vastra-gotaland",
              "orebro",
              "ostergotland"
            ],
            "type": "string",
            "description": "Optional Swedish county (län). Any county searches the whole country.",
            "default": "any"
          },
          "sellers": {
            "title": "Seller kind",
            "enum": [
              "any",
              "private",
              "company"
            ],
            "type": "string",
            "description": "Private sellers only, companies only, or both. The site decides who is a company (its own 'Företag' label).",
            "default": "any"
          },
          "tradeType": {
            "title": "Ad type",
            "enum": [
              "sell",
              "giveaway",
              "wanted",
              "any"
            ],
            "type": "string",
            "description": "Blocket mixes ads for sale with give-away ads and wanted ads ('Köpes'). For sale is almost always what you want.",
            "default": "sell"
          },
          "minPrice": {
            "title": "Minimum price (SEK)",
            "minimum": 0,
            "type": "integer",
            "description": "Optional, inclusive. Applied by the site itself. Must not be above the maximum price."
          },
          "maxPrice": {
            "title": "Maximum price (SEK)",
            "minimum": 0,
            "type": "integer",
            "description": "Optional, inclusive. Applied by the site itself."
          },
          "shippingOnly": {
            "title": "Only ads offering shipping",
            "type": "boolean",
            "description": "Keeps only ads marked 'Kan skickas' (can be shipped). Applied after fetching, so a run with this on fetches more pages per row kept.",
            "default": false
          },
          "excludeForParts": {
            "title": "Exclude spare-part and locked ads",
            "type": "boolean",
            "description": "Drops ads whose title says 'Reservdel...' (spare parts) or 'iCloud-låst' (iCloud-locked). Only those two phrases are recognised, because they are the only damage wording confirmed on the site so far. Off by default.",
            "default": false
          },
          "requireKeywordMatch": {
            "title": "Require the query in the title",
            "type": "boolean",
            "description": "Drops ads where a word of the search term is missing from both the title and the brand. The site also matches the ad description, which the result list does not show, so a search for a phone returns accessories and unrelated ads too.",
            "default": true
          },
          "maxItems": {
            "title": "Maximum rows",
            "minimum": 1,
            "type": "integer",
            "description": "Hard cap on rows saved across all search terms.",
            "default": 100
          },
          "maxPages": {
            "title": "Maximum pages per search term",
            "minimum": 1,
            "maximum": 50,
            "type": "integer",
            "description": "53 ads a page. The site serves at most 50 pages (2,650 ads) per search, so this is clamped to 50. Narrow the search with category, county, seller or price to go beyond that.",
            "default": 50
          },
          "proxyConfiguration": {
            "title": "Proxy",
            "type": "object",
            "description": "Optional. Left off by default; only turn it on if you see request failures.",
            "default": {
              "useApifyProxy": false
            }
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_UNBLOCKER_UNITS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}