{
  "openapi": "3.0.1",
  "info": {
    "title": "OCC Mundial Jobs Scraper",
    "description": "Every job on OCC Mundial, Mexico's biggest job board, in one run: salary ranges in MXN, category, contract, work model, education, benefits, skills and full descriptions. Recruiters, HR teams and analysts get 1,000 jobs in under a minute.",
    "version": "1.0",
    "x-build-id": "edGegiGgvzxU7sxEQ"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/normdata~occ-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-normdata-occ-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/normdata~occ-scraper/runs": {
      "post": {
        "operationId": "runs-sync-normdata-occ-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/normdata~occ-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-normdata-occ-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": {
          "maxItems": {
            "title": "Maximum jobs",
            "minimum": 1,
            "type": "integer",
            "description": "Stop after this many jobs. Leave empty for no limit (the run stops once the matching jobs run out). The Apify Free plan is always capped at 10."
          },
          "keywords": {
            "title": "Job titles or keywords",
            "type": "array",
            "description": "One or more searches, in Spanish as people search on OCC, e.g. \"vendedor\", \"contador\", \"desarrollador java\". Each one runs its own search and is tagged on every row it produces.",
            "items": {
              "type": "string"
            }
          },
          "locations": {
            "title": "Locations",
            "type": "array",
            "description": "Mexican states or cities, e.g. \"Jalisco\", \"Monterrey\", \"Ciudad de México\". Each location runs its own search. Leave empty for all of Mexico.",
            "items": {
              "type": "string"
            }
          },
          "pageUrl": {
            "title": "…or paste an OCC search link",
            "type": "string",
            "description": "Already filtered a search on occ.com.mx? Paste that page's URL and it's reused exactly; every other search field and filter is then ignored."
          },
          "categories": {
            "title": "Categories",
            "type": "array",
            "description": "Only jobs in these OCC categories. Each one runs its own search.",
            "items": {
              "type": "string",
              "enum": [
                "administrativo",
                "arte-y-diseno",
                "atencion-a-clientes-call-center",
                "ciencias-sociales-humanidades",
                "comunicacion-y-creatividad",
                "construccion-inmobiliaria-arquitectura",
                "contabilidad-finanzas",
                "deportes-salud-belleza",
                "derecho-y-leyes",
                "educacion",
                "ingenieria",
                "logistica-transporte-distribucion-almacen",
                "manufactura-produccion-operacion",
                "mercadotecnia-publicidad-relaciones-publicas",
                "mineria-energia-recursos-naturales",
                "recursos-humanos",
                "sector-salud",
                "seguros-y-reaseguros",
                "servicios-generales-oficios-seguridad",
                "tecnologias-de-la-informacion-sistemas",
                "turismo-hospitalidad-gastronomia",
                "ventas",
                "veterinaria-agricultura"
              ],
              "enumTitles": [
                "Administrativo",
                "Arte y diseño",
                "Atención a clientes - Call Center",
                "Ciencias sociales - Humanidades",
                "Comunicación y creatividad",
                "Construcción - Inmobiliaria - Arquitectura",
                "Contabilidad - Finanzas",
                "Deportes - Salud - Belleza",
                "Derecho y leyes",
                "Educación",
                "Ingeniería",
                "Logística - Transporte - Distribución - Almacén",
                "Manufactura - Producción - Operación",
                "Mercadotecnia - Publicidad - Relaciones Públicas",
                "Minería - Energía - Recursos Naturales",
                "Recursos humanos",
                "Sector salud",
                "Seguros y reaseguros",
                "Servicios generales - Oficios - Seguridad",
                "Tecnologías de la Información - Sistemas",
                "Turismo - Hospitalidad - Gastronomía",
                "Ventas",
                "Veterinaria - Agricultura"
              ]
            }
          },
          "workModels": {
            "title": "Work model",
            "type": "array",
            "description": "On-site, hybrid or remote.",
            "items": {
              "type": "string",
              "enum": [
                "onsite",
                "hybrid",
                "remote"
              ],
              "enumTitles": [
                "On-site (presencial)",
                "Hybrid (híbrido)",
                "Remote (desde casa)"
              ]
            }
          },
          "contractTypes": {
            "title": "Contract type",
            "type": "array",
            "description": "Only these types of contract.",
            "items": {
              "type": "string",
              "enum": [
                "tiempo-completo",
                "medio-tiempo",
                "permanente",
                "temporal",
                "honorarios",
                "becario-practicas"
              ],
              "enumTitles": [
                "Full time",
                "Part time",
                "Permanent (indeterminado)",
                "Temporary",
                "Fees / freelance (honorarios)",
                "Internship (becario / prácticas)"
              ]
            }
          },
          "education": {
            "title": "Minimum education",
            "type": "array",
            "description": "Only jobs asking for this education level.",
            "items": {
              "type": "string",
              "enum": [
                "secundaria",
                "bachillerato",
                "tecnico",
                "universitario-sin-titulo",
                "universitario-titulado",
                "posgrado"
              ],
              "enumTitles": [
                "Middle school (secundaria)",
                "High school (bachillerato)",
                "Technical (técnico)",
                "University, no degree yet",
                "University degree",
                "Postgraduate"
              ]
            }
          },
          "minSalary": {
            "title": "Minimum monthly salary (MXN)",
            "minimum": 1,
            "type": "integer",
            "description": "Only jobs paying at least this much per month, e.g. 15000. Jobs that hide their salary are left out when you set this."
          },
          "maxSalary": {
            "title": "Maximum monthly salary (MXN)",
            "minimum": 1,
            "type": "integer",
            "description": "Only jobs paying up to this much per month."
          },
          "postedWithin": {
            "title": "Posted within",
            "enum": [
              "any",
              "0",
              "1",
              "3",
              "7",
              "14",
              "30"
            ],
            "type": "string",
            "description": "Only jobs published in this window.",
            "default": "any"
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "newest",
              "relevance"
            ],
            "type": "string",
            "description": "Newest first (default) or OCC's own relevance order.",
            "default": "newest"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}