{
  "openapi": "3.0.1",
  "info": {
    "title": "Jobberman Scraper",
    "description": "[💰 $0.9 / 1K] Scrape job listings from Jobberman, Nigeria's largest job board. Get title, company, location, work type, job function, experience level, salary & posted date. Filter by keyword, location, function & more, with optional full descriptions.",
    "version": "1.0",
    "x-build-id": "wAjov674RVZYidXYJ"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/solidcode~jobberman-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-solidcode-jobberman-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~jobberman-scraper/runs": {
      "post": {
        "operationId": "runs-sync-solidcode-jobberman-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~jobberman-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-solidcode-jobberman-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": {
          "query": {
            "title": "Search Keyword",
            "type": "string",
            "description": "Job title, role, or keyword to search for (e.g. 'developer', 'accountant', 'sales manager'). Leave blank to collect all jobs matching the filters below."
          },
          "location": {
            "title": "Location",
            "uniqueItems": true,
            "type": "array",
            "description": "Only include jobs in these states or regions. Leave empty to cover the whole country. Selecting more than one runs a separate search per location and combines the results. Choose from the dropdown — an unrecognized value is skipped and this filter is not applied.",
            "items": {
              "type": "string",
              "enum": [
                "lagos",
                "abuja",
                "port-harcourt-rivers",
                "ibadan-oyo",
                "abeokuta-ogun",
                "enugu",
                "imo",
                "maiduguri-borno",
                "rest-nigeria",
                "remote",
                "nigeria"
              ],
              "enumTitles": [
                "Lagos",
                "Abuja",
                "Port Harcourt & Rivers State",
                "Ibadan & Oyo State",
                "Abeokuta & Ogun State",
                "Enugu",
                "Imo",
                "Maiduguri & Borno State",
                "Rest of Nigeria",
                "Remote (Work From Home)",
                "All Nigeria"
              ]
            }
          },
          "jobFunction": {
            "title": "Job Function",
            "uniqueItems": true,
            "type": "array",
            "description": "Only include jobs in these role categories (e.g. Sales, Software & Data, Marketing). Leave empty to include all functions. Choose from the dropdown — an unrecognized value is skipped and this filter is not applied.",
            "items": {
              "type": "string",
              "enum": [
                "accounting-auditing-finance",
                "admin-office",
                "creative-design",
                "building-architecture",
                "consulting-strategy",
                "customer-service-support",
                "engineering-technology",
                "farming-agriculture",
                "food-services-catering",
                "hospitality-leisure",
                "software-data",
                "legal-services",
                "marketing-communications",
                "medical-pharmaceutical",
                "product-project-management",
                "estate-agent-property-management",
                "quality-control-assurance",
                "human-resources",
                "management-business-development",
                "community-social-services",
                "sales",
                "supply-chain-procurement",
                "research-teaching-training",
                "trades-services",
                "driver-transport-services",
                "health-safety"
              ],
              "enumTitles": [
                "Accounting, Auditing & Finance",
                "Admin & Office",
                "Creative & Design",
                "Building & Architecture",
                "Consulting & Strategy",
                "Customer Service & Support",
                "Engineering & Technology",
                "Farming & Agriculture",
                "Food Services & Catering",
                "Hospitality & Leisure",
                "Software & Data",
                "Legal Services",
                "Marketing & Communications",
                "Medical & Pharmaceutical",
                "Product & Project Management",
                "Estate Agents & Property Management",
                "Quality Control & Assurance",
                "Human Resources",
                "Management & Business Development",
                "Community & Social Services",
                "Sales",
                "Supply Chain & Procurement",
                "Research, Teaching & Training",
                "Trades & Services",
                "Driver & Transport Services",
                "Health & Safety"
              ]
            }
          },
          "workType": {
            "title": "Work Type",
            "uniqueItems": true,
            "type": "array",
            "description": "Only include jobs with these employment types. Leave empty to include any. Choose from the dropdown — an unrecognized value is skipped and this filter is not applied.",
            "items": {
              "type": "string",
              "enum": [
                "full-time",
                "contract",
                "part-time",
                "internship-graduate"
              ],
              "enumTitles": [
                "Full Time",
                "Contract",
                "Part Time",
                "Internship & Graduate"
              ]
            }
          },
          "experienceLevel": {
            "title": "Experience Level",
            "uniqueItems": true,
            "type": "array",
            "description": "Only include jobs requiring these experience levels. Leave empty to include any. Choose from the dropdown — an unrecognized value is skipped and this filter is not applied.",
            "items": {
              "type": "string",
              "enum": [
                "no-experience",
                "graduate-trainee",
                "entry-level",
                "mid-level",
                "senior-level",
                "executive-level"
              ],
              "enumTitles": [
                "No Experience",
                "Internship & Graduate",
                "Entry level",
                "Mid level",
                "Senior level",
                "Executive level"
              ]
            }
          },
          "sort": {
            "title": "Sort Order",
            "enum": [
              "",
              "featured",
              "popular"
            ],
            "type": "string",
            "description": "How to order results. 'Latest' (default) returns the newest postings first — best for scheduled runs that pick up new jobs."
          },
          "startUrls": {
            "title": "Search URLs",
            "type": "array",
            "description": "Advanced: paste jobberman.com search URLs built in the site's own search page (e.g. https://www.jobberman.com/jobs/software-data/lagos). Use this when you've already applied filters in the site UI. When provided, the keyword and filters above are ignored for these URLs.",
            "items": {
              "type": "string"
            }
          },
          "includeDetails": {
            "title": "Fetch Full Job Details",
            "type": "boolean",
            "description": "Off by default for fast results. Each job card already includes the title, company, location, work type, salary (when shown) and job function. Turn this on to also fetch the full job description (formatted HTML and plain text) plus the exact posted date, resolved company name and salary from each job's own page — this is slower, because every job needs an extra page visit, so expect longer runs on large searches.",
            "default": false
          },
          "maxResults": {
            "title": "Maximum Results",
            "minimum": 0,
            "type": "integer",
            "description": "Hard cap on the total number of jobs returned across all searches and URLs. Default 100 — increase for bigger runs, or set to 0 for no cap (the site holds roughly 4,000 active listings, and each result is billed at the per-result rate). The actor stops requesting new pages once this number is hit but keeps the full last page even if it slightly overshoots.",
            "default": 100
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}