{
  "openapi": "3.0.1",
  "info": {
    "title": "LinkedIn Jobs - Job Descriptions & New Jobs",
    "description": "Search LinkedIn jobs by keyword and location. One row per job: title, company, location, posted date, URL and available salary text. Optional job descriptions; company, title and date filters. Monitor new jobs across runs. Parsed pages are billed even when filters or monitoring leave no rows.",
    "version": "1.3",
    "x-build-id": "ebrLrCYBinWVDDcVo"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/kestrel~linkedin-job-search/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-kestrel-linkedin-job-search",
        "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/kestrel~linkedin-job-search/runs": {
      "post": {
        "operationId": "runs-sync-kestrel-linkedin-job-search",
        "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/kestrel~linkedin-job-search/run-sync": {
      "post": {
        "operationId": "run-sync-kestrel-linkedin-job-search",
        "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",
        "required": [
          "queries"
        ],
        "properties": {
          "queries": {
            "title": "Search queries",
            "type": "array",
            "description": "Search keywords, for example [\"data engineer\"]. Up to 20 queries. Each query has independent page and delivered-result limits. No separate source account or API key required.",
            "items": {
              "type": "string"
            }
          },
          "maxResultsPerSource": {
            "title": "Maximum delivered rows per source",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Maximum delivered job rows per query, after filters, monitoring and cross-query deduplication. Default 50; maximum 1000. IDs are LinkedIn job IDs, so different jobs at the same company or linkedin.com can all be returned. The same job appearing in several queries is delivered once across the run. Source availability and page caps can leave fewer rows.",
            "default": 50
          },
          "location": {
            "title": "Job search location",
            "type": "string",
            "description": "Location passed to LinkedIn public search, for example \"United States\" or \"London\". Default United States. Source search can include nearby locations; this is not an exact city filter.",
            "default": "United States"
          },
          "includeDetails": {
            "title": "Include job descriptions",
            "type": "boolean",
            "description": "true fetches full public description, seniority, employment type, job function and industries when available. Charges $0.004 per delivered enriched job instead of $0.001 for a listing-only job. Failed descriptions are skipped with an error and no job fee. Page fees still apply.",
            "default": false
          },
          "companies": {
            "title": "Company filters",
            "type": "array",
            "description": "Keep company names containing any phrase, case-insensitive, for example [\"Microsoft\"]. Empty means all. Applied to visible search results before job billing; it does not discover a company directory.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "postedWithinDays": {
            "title": "Posted within days",
            "minimum": 0,
            "maximum": 365,
            "type": "integer",
            "description": "Keep jobs whose source posted_date is within this number of UTC calendar days, for example 7. Zero disables it. Missing dates do not pass an active filter. This filters inspected pages; it does not guarantee every recent job.",
            "default": 0
          },
          "onlyNew": {
            "title": "Only new jobs",
            "type": "boolean",
            "description": "true emits job IDs not previously delivered. First run delivers the baseline; use the same monitorKey later. Successful unchanged checks still pay page fees. Default false.",
            "default": false
          },
          "titleContains": {
            "title": "Title includes any",
            "type": "array",
            "description": "Keep titles containing any phrase, case-insensitive, for example [\"engineer\"]. Empty disables it. Applied before row billing; parsed pages are still billed.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "titleExcludes": {
            "title": "Title excludes any",
            "type": "array",
            "description": "Drop titles containing any phrase, case-insensitive, for example [\"senior\"]. Empty disables it. Filtered rows have no row fee; parsed pages still carry their fee.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "monitorKey": {
            "title": "Monitor name",
            "type": "string",
            "description": "Persistent history name, for example \"daily-watch\". Use 1–60 letters, digits, underscores or hyphens. Use the same targets, filters and name for repeat runs. Keeps the latest 50,000 delivered IDs. Do not overlap runs sharing this name."
          },
          "excludeIds": {
            "title": "Previously collected IDs",
            "type": "array",
            "description": "Skip exact output id values. Up to 10,000. Useful for external deduplication; excluded rows have no row fee, but parsed pages are billed.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "maxPagesPerSource": {
            "title": "Maximum pages per source",
            "minimum": 1,
            "maximum": 20,
            "type": "integer",
            "description": "Safety cap on parsed pages per search, for example 5. Default 5, maximum 20. Each parsed page costs $0.005, including filtered or unchanged checks. Both this cap and maxResultsPerSource apply.",
            "default": 5
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}