{
  "openapi": "3.0.1",
  "info": {
    "title": "LinkedIn Jobs Scraper — Search, Salaries & Recruiter Info",
    "description": "Scrape public LinkedIn job postings with full descriptions, salary insights, recruiter contacts, and company data. Search by URLs or AI filters (keyword, location, date, remote). Fast guest HTTP scraper with no login or cookies needed. Pay only per successful job retrieved.",
    "version": "0.0",
    "x-build-id": "gjStQEXXOdgleOdib"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapepilot~linkedin-jobs-scraper-search-salaries-recruiter-info/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapepilot-linkedin-jobs-scraper-search-salaries-recruiter-info",
        "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/scrapepilot~linkedin-jobs-scraper-search-salaries-recruiter-info/runs": {
      "post": {
        "operationId": "runs-sync-scrapepilot-linkedin-jobs-scraper-search-salaries-recruiter-info",
        "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/scrapepilot~linkedin-jobs-scraper-search-salaries-recruiter-info/run-sync": {
      "post": {
        "operationId": "run-sync-scrapepilot-linkedin-jobs-scraper-search-salaries-recruiter-info",
        "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": {
          "urls": {
            "title": "LinkedIn Jobs Search URLs",
            "type": "array",
            "description": "One or more LinkedIn jobs search URLs or individual job posting URLs (e.g. https://www.linkedin.com/jobs/search/?keywords=software%20engineer&location=United%20States). If provided, AI search filter fields below are ignored.",
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "keywords": {
            "title": "Search Keywords",
            "type": "string",
            "description": "Job title, keywords, skill, or company (e.g. 'software engineer', 'data analyst', 'python developer', 'react', 'sales director').",
            "default": "software engineer"
          },
          "location": {
            "title": "Location",
            "type": "string",
            "description": "City, state, zip code, or country (e.g. 'United States', 'New York, NY', 'London', 'San Francisco Bay Area', 'Remote').",
            "default": "United States"
          },
          "datePosted": {
            "title": "Date Posted",
            "enum": [
              "anytime",
              "past-24h",
              "past-week",
              "past-month"
            ],
            "type": "string",
            "description": "Filter jobs posted within a specific timeframe.",
            "default": "anytime"
          },
          "experienceLevel": {
            "title": "Experience Level",
            "enum": [
              "all",
              "internship",
              "entry-level",
              "associate",
              "mid-senior",
              "director",
              "executive"
            ],
            "type": "string",
            "description": "Required experience level filter.",
            "default": "all"
          },
          "jobType": {
            "title": "Job Type",
            "enum": [
              "all",
              "full-time",
              "part-time",
              "contract",
              "temporary",
              "internship",
              "volunteer"
            ],
            "type": "string",
            "description": "Employment type filter.",
            "default": "all"
          },
          "workplaceType": {
            "title": "Workplace / Remote",
            "enum": [
              "all",
              "on-site",
              "remote",
              "hybrid"
            ],
            "type": "string",
            "description": "Workplace arrangement filter.",
            "default": "all"
          },
          "easyApply": {
            "title": "Easy Apply Only",
            "type": "boolean",
            "description": "Filter for jobs that allow quick submission through LinkedIn Easy Apply (f_AL=true).",
            "default": false
          },
          "under10Applicants": {
            "title": "Under 10 Applicants",
            "type": "boolean",
            "description": "Filter for early-bird listings with fewer than 10 applicants (f_EA=true).",
            "default": false
          },
          "companyIds": {
            "title": "Company IDs",
            "type": "string",
            "description": "Comma-separated list of LinkedIn company numeric IDs to filter by (e.g. '10667' for Meta, '1441' for Google)."
          },
          "autoConvertToAiSearch": {
            "title": "Auto Convert to AI Search",
            "type": "boolean",
            "description": "When enabled, legacy filters (Experience, Job Type) are naturally appended to search keywords for backward compatibility with LinkedIn's latest search algorithm.",
            "default": true
          },
          "scrapeCompanyDetails": {
            "title": "Scrape Full Company Details",
            "type": "boolean",
            "description": "Visit each hiring company's LinkedIn profile page to capture description, website, and employee size.",
            "default": false
          },
          "maxItems": {
            "title": "Max Job Listings Limit",
            "minimum": 1,
            "type": "integer",
            "description": "Maximum number of job postings to collect and push to the dataset.",
            "default": 50
          },
          "proxy": {
            "title": "Proxy Configuration",
            "type": "object",
            "description": "Proxy configuration. Apify Residential proxies matching the target jobs country are recommended for reliable scraping.",
            "default": {
              "useApifyProxy": true,
              "apifyProxyGroups": [
                "RESIDENTIAL"
              ]
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}