{
  "openapi": "3.0.1",
  "info": {
    "title": "Bumeran Jobs Scraper",
    "description": "[💰 $0.95 / 1K] Extract job listings from Bumeran Argentina. Search by keyword and location, filter by area, seniority, contract type, work mode, and date posted, then collect titles, companies, salaries, descriptions, screening questions, and apply links — or paste Bumeran search URLs directly.",
    "version": "1.0",
    "x-build-id": "OX8ElJeWpe2mcN9l0"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/solidcode~bumeran-com-ar-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-solidcode-bumeran-com-ar-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~bumeran-com-ar-scraper/runs": {
      "post": {
        "operationId": "runs-sync-solidcode-bumeran-com-ar-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~bumeran-com-ar-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-solidcode-bumeran-com-ar-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": {
          "keywords": {
            "title": "Search Keywords",
            "maxItems": 50,
            "type": "array",
            "description": "Job titles, roles, or keywords to search for, such as 'desarrollador', 'contador', or 'atención al cliente'. Each keyword runs its own search. Leave empty to collect the broadest result set for the chosen location and filters. Up to 50 keywords per run.",
            "items": {
              "type": "string"
            }
          },
          "location": {
            "title": "Location",
            "type": "string",
            "description": "Province or city to search in, such as 'Buenos Aires', 'Córdoba', or 'Capital Federal'. Matches what you would type into Bumeran's location box. Leave empty to search all of Argentina."
          },
          "startUrls": {
            "title": "Direct Bumeran URLs",
            "maxItems": 50,
            "type": "array",
            "description": "Paste full Bumeran search-result or individual job URLs (e.g. https://www.bumeran.com.ar/empleos-busqueda-desarrollador.html) to scrape them directly. Useful when you already have a search dialed in on the website — any filters baked into the URL are respected. Up to 50 URLs per run.",
            "items": {
              "type": "string"
            }
          },
          "area": {
            "title": "Job Area",
            "enum": [
              "",
              "administracion-contabilidad-y-finanzas",
              "secretarias-y-recepcion",
              "atencion-al-cliente-call-center-y-telemarketing",
              "abastecimiento-y-logistica",
              "comercial-ventas-y-negocios",
              "comunicacion-relaciones-institucionales-y-publicas",
              "diseno",
              "educacion-docencia-e-investigacion",
              "gastronomia-y-turismo",
              "ingenierias",
              "ingenieria-civil-y-construccion",
              "gerencia-y-direccion-general",
              "legales",
              "marketing-y-publicidad",
              "mineria-petroleo-y-gas",
              "oficios-y-otros",
              "produccion-y-manufactura",
              "recursos-humanos-y-capacitacion",
              "salud-medicina-y-farmacia",
              "tecnologia-sistemas-y-telecomunicaciones"
            ],
            "type": "string",
            "description": "Limit results to one job area (área). Leave on 'Any area' to include all areas.",
            "default": ""
          },
          "seniority": {
            "title": "Seniority Level",
            "enum": [
              "",
              "junior",
              "senior-semi-senior",
              "jefe-supervisor-responsable",
              "gerencia-alta-gerencia-direccion"
            ],
            "type": "string",
            "description": "Limit results to one seniority level. Leave on 'Any level' to include all levels.",
            "default": ""
          },
          "contractType": {
            "title": "Contract Type",
            "enum": [
              "",
              "full-time",
              "part-time",
              "por-contrato",
              "temporario",
              "pasantia"
            ],
            "type": "string",
            "description": "Limit results to one contract or work type. Leave on 'Any' to include all types.",
            "default": ""
          },
          "workMode": {
            "title": "Work Mode",
            "enum": [
              "",
              "presencial",
              "remoto",
              "hibrido"
            ],
            "type": "string",
            "description": "Limit results to one work mode (modalidad). Leave on 'Any' to include all modes.",
            "default": ""
          },
          "datePosted": {
            "title": "Date Posted",
            "enum": [
              "",
              "publicacion-hoy",
              "publicacion-menor-a-2-dias",
              "publicacion-menor-a-7-dias",
              "publicacion-menor-a-15-dias",
              "publicacion-menor-a-1-mes"
            ],
            "type": "string",
            "description": "Only return jobs published within this time window. Leave on 'Any time' to include all listings.",
            "default": ""
          },
          "salaryDisclosedOnly": {
            "title": "With Salary Only",
            "type": "boolean",
            "description": "Only keep jobs that disclose a salary. Bumeran has no server-side 'with salary' filter, so this is applied after results are fetched — each listing is kept only when it marks a salary as disclosed.",
            "default": false
          },
          "sortBy": {
            "title": "Sort By",
            "enum": [
              "relevantes",
              "recientes"
            ],
            "type": "string",
            "description": "Order in which jobs are returned.",
            "default": "relevantes"
          },
          "maxResultsPerQuery": {
            "title": "Max Results per Query",
            "minimum": 0,
            "type": "integer",
            "description": "Maximum number of job listings to collect per search keyword (or per start URL). Set to 0 to collect all available results across pagination, up to a safety ceiling of about 10,000 listings per keyword. Results are fetched in pages: the actor stops once your cap is reached but always keeps the whole final page, so a small cap can return up to a full page more than you asked for. Listings repeated across pages are deduplicated, so the final count can also run slightly below your cap.",
            "default": 100
          },
          "onlyUniqueJobs": {
            "title": "Only Unique Jobs",
            "type": "boolean",
            "description": "When on, each job is returned once even if Bumeran lists it across several pages or searches. Deduplicates by the listing's job ID. Turn off to keep every copy.",
            "default": true
          },
          "includeDescription": {
            "title": "Fetch Full Job Descriptions",
            "type": "boolean",
            "description": "Include the full job description text, company details, and screening questions for each listing from the job page. Leave on for the most complete data. Turn off for lighter, faster records when you only need titles, companies, locations, salaries, and apply links from the results list.",
            "default": true
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}