{
  "openapi": "3.0.1",
  "info": {
    "title": "Spain BOE Auctions Scraper",
    "description": "[💰 $2.5 / 1K] Extract Spanish public auction data from the official BOE portal (subastas.boe.es) — judicial and notarial subastas. Get auction IDs, dates, values, deposits, bids, claimed amounts, asset descriptions, addresses, authority contacts, lots, and documents.",
    "version": "1.0",
    "x-build-id": "I8bPfdvBgRQhUoOyU"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/solidcode~boe-es-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-solidcode-boe-es-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/solidcode~boe-es-scraper/runs": {
      "post": {
        "operationId": "runs-sync-solidcode-boe-es-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/solidcode~boe-es-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-solidcode-boe-es-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",
        "properties": {
          "startUrls": {
            "title": "Auction or search URLs",
            "type": "array",
            "description": "Paste subastas.boe.es links to scrape directly — either individual auction detail pages or full search-result pages (with your own filters already applied in the browser). Leave empty to build a search using the filters below.",
            "items": {
              "type": "string"
            }
          },
          "province": {
            "title": "Province",
            "enum": [
              "",
              "A Coruña",
              "Álava",
              "Albacete",
              "Alicante",
              "Almería",
              "Asturias",
              "Ávila",
              "Badajoz",
              "Baleares",
              "Barcelona",
              "Burgos",
              "Cáceres",
              "Cádiz",
              "Cantabria",
              "Castellón",
              "Ceuta",
              "Ciudad Real",
              "Córdoba",
              "Cuenca",
              "Girona",
              "Granada",
              "Guadalajara",
              "Gipuzkoa",
              "Huelva",
              "Huesca",
              "Jaén",
              "La Rioja",
              "Las Palmas",
              "León",
              "Lleida",
              "Lugo",
              "Madrid",
              "Málaga",
              "Melilla",
              "Murcia",
              "Navarra",
              "Ourense",
              "Palencia",
              "Pontevedra",
              "Salamanca",
              "Santa Cruz de Tenerife",
              "Segovia",
              "Sevilla",
              "Soria",
              "Tarragona",
              "Teruel",
              "Toledo",
              "Valencia",
              "Valladolid",
              "Vizcaya",
              "Zamora",
              "Zaragoza"
            ],
            "type": "string",
            "description": "Only include auctions with assets located in this Spanish province. Leave as 'All provinces' to search the whole country."
          },
          "propertyType": {
            "title": "Asset / property type",
            "enum": [
              "",
              "Vivienda",
              "Local comercial",
              "Garaje",
              "Trastero",
              "Nave industrial",
              "Solar",
              "Finca rústica",
              "Otros"
            ],
            "type": "string",
            "description": "Only include auctions offering this kind of asset (housing, commercial premises, garage, land, etc.). Leave as 'All types' for every asset category."
          },
          "auctionStatus": {
            "title": "Auction status",
            "enum": [
              "",
              "Celebrándose",
              "Pendiente",
              "Concluida",
              "Suspendida"
            ],
            "type": "string",
            "description": "Only include auctions in this state. Defaults to live/ongoing auctions, since 'Any status' with no other filters matches too many auctions for the portal to list at once."
          },
          "taxAgencyOnly": {
            "title": "Tax Agency auctions only",
            "type": "boolean",
            "description": "When enabled, only auctions run by the Spanish Tax Agency (Agencia Tributaria / Hacienda) are returned.",
            "default": false
          },
          "minValue": {
            "title": "Minimum appraised value (EUR)",
            "minimum": 0,
            "type": "integer",
            "description": "Only keep auctions whose appraised/base value is at or above this amount, in euros. Applied after each auction's full details are read (the portal has no server-side value filter). On very large result sets, a very restrictive value range scans a bounded number of result pages and may stop early once matches thin out. Leave empty for no lower bound."
          },
          "maxValue": {
            "title": "Maximum appraised value (EUR)",
            "minimum": 0,
            "type": "integer",
            "description": "Only keep auctions whose appraised/base value is at or below this amount, in euros. Applied after each auction's full details are read (the portal has no server-side value filter). On very large result sets, a very restrictive value range scans a bounded number of result pages and may stop early once matches thin out. Leave empty for no upper bound."
          },
          "startDateFrom": {
            "title": "Auction start date — from",
            "type": "string",
            "description": "Only include auctions that open on or after this date (YYYY-MM-DD)."
          },
          "startDateTo": {
            "title": "Auction start date — to",
            "type": "string",
            "description": "Only include auctions that open on or before this date (YYYY-MM-DD)."
          },
          "endDateFrom": {
            "title": "Auction end date — from",
            "type": "string",
            "description": "Only include auctions that close on or after this date (YYYY-MM-DD)."
          },
          "endDateTo": {
            "title": "Auction end date — to",
            "type": "string",
            "description": "Only include auctions that close on or before this date (YYYY-MM-DD)."
          },
          "sortBy": {
            "title": "Sort results by",
            "enum": [
              "endDate",
              "identifier"
            ],
            "type": "string",
            "description": "Field used to order the auctions before collection.",
            "default": "endDate"
          },
          "sortOrder": {
            "title": "Sort direction",
            "enum": [
              "asc",
              "desc"
            ],
            "type": "string",
            "description": "Ascending (oldest / lowest first) or descending (newest / highest first).",
            "default": "asc"
          },
          "maxResults": {
            "title": "Maximum auctions",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of auctions to collect. Set to 0 to collect every matching auction.",
            "default": 100
          },
          "downloadDocuments": {
            "title": "Download auction documents (PDFs)",
            "type": "boolean",
            "description": "When enabled, the auction's attached documents (edicts, appraisal reports, etc.) are downloaded and saved to this run's storage, and each document record includes a direct download link. Leave off to only capture document titles and their public URLs.",
            "default": 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
                  }
                }
              },
              "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}