{
  "openapi": "3.0.1",
  "info": {
    "title": "Wellfound Startup Jobs Finder with Pay & Remote Filters",
    "description": "Find startup jobs on Wellfound and filter by title, keyword, location, remote status, job type, experience level, salary range and company.",
    "version": "1.1",
    "x-build-id": "rD6tn8XiWSRuLZ90C"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/nimbryxo-studio~wellfound-startup-jobs-finder-with-pay-and-remote/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-nimbryxo-studio-wellfound-startup-jobs-finder-with-pay-and-remote",
        "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/nimbryxo-studio~wellfound-startup-jobs-finder-with-pay-and-remote/runs": {
      "post": {
        "operationId": "runs-sync-nimbryxo-studio-wellfound-startup-jobs-finder-with-pay-and-remote",
        "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/nimbryxo-studio~wellfound-startup-jobs-finder-with-pay-and-remote/run-sync": {
      "post": {
        "operationId": "run-sync-nimbryxo-studio-wellfound-startup-jobs-finder-with-pay-and-remote",
        "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": [
          "mode"
        ],
        "properties": {
          "mode": {
            "title": "Scraping Mode",
            "enum": [
              "auto",
              "search",
              "startUrls",
              "companies"
            ],
            "type": "string",
            "description": "Auto uses startUrls when provided, otherwise role/location search. Search ignores startUrls. Scrape URLs requires at least one start URL. Companies reads the /startups directory.",
            "default": "auto"
          },
          "startUrls": {
            "title": "Start URLs",
            "type": "array",
            "description": "Jobs: /jobs, /role/{role}, /role/l/{role}/{location}, /role/r/{role}, /location/{location}, /remote, /jobs/{id}-{slug} and /job-collections/{slug}. Companies: /startups, /startups/location/{location} and /startups/industry/{industry}. Company profile and login URLs are rejected.",
            "items": {
              "type": "object",
              "properties": {
                "url": {
                  "title": "URL",
                  "type": "string",
                  "description": "Page URL to scrape."
                }
              }
            },
            "default": []
          },
          "role": {
            "title": "Role",
            "type": "string",
            "description": "Wellfound role slug for search mode, for example software-engineer, product-manager, designer or machine-learning-engineer."
          },
          "jobTitle": {
            "title": "Job Title Filter",
            "type": "string",
            "description": "Only keep jobs whose title contains this phrase (case-insensitive)."
          },
          "keyword": {
            "title": "Keyword",
            "type": "string",
            "description": "Only keep jobs matching this text across title, company, locations, compensation and description (case-insensitive)."
          },
          "location": {
            "title": "Location",
            "type": "string",
            "description": "Used as a server-side /location/{location} or /role/l/{role}/{location} path when it is a clean city slug or name, and always as a case-insensitive client filter over locations and accepted remote locations."
          },
          "remoteOnly": {
            "title": "Remote Only",
            "type": "boolean",
            "description": "Search /remote or /role/r/{role} and keep only jobs flagged as remote.",
            "default": false
          },
          "jobType": {
            "title": "Job Type",
            "enum": [
              "any",
              "full-time",
              "part-time",
              "contract",
              "internship"
            ],
            "type": "string",
            "description": "Exact structured job type from Wellfound. Jobs with a missing/unknown type are dropped when a specific type is selected.",
            "default": "any"
          },
          "experience": {
            "title": "Experience Level",
            "enum": [
              "any",
              "junior",
              "mid",
              "senior",
              "executive"
            ],
            "type": "string",
            "description": "Best-effort filter: title keywords first, then yearsExperienceMin (0-2 junior, 3-4 mid, 5+ senior). Unknown jobs are kept and counted.",
            "default": "any"
          },
          "minSalary": {
            "title": "Minimum Salary",
            "minimum": 0,
            "maximum": 10000000,
            "type": "integer",
            "description": "Keep jobs whose salary range top is at or above this amount. Currency is the job's listed currency; no FX conversion. 0 = off.",
            "default": 0
          },
          "maxSalary": {
            "title": "Maximum Salary",
            "minimum": 0,
            "maximum": 10000000,
            "type": "integer",
            "description": "Keep jobs whose salary range bottom is at or below this amount. 0 = unlimited. This is the documented range-start semantics.",
            "default": 0
          },
          "salaryCurrency": {
            "title": "Salary Currency",
            "enum": [
              "any",
              "USD",
              "CAD",
              "INR"
            ],
            "type": "string",
            "description": "Filter parsed salaries by currency. No FX conversion is performed.",
            "default": "any"
          },
          "includeNoSalary": {
            "title": "Include Jobs Without Salary Data",
            "type": "boolean",
            "description": "Only applies when minSalary or maxSalary is set. When false, jobs with no parsed salary are dropped.",
            "default": true
          },
          "companyCategories": {
            "title": "Company Categories",
            "type": "array",
            "description": "Match Wellfound market, industry and company-type tags or the company high concept. This is not a company-name filter; use includeCompanies for names. Requires enrichDetails=true.",
            "items": {
              "type": "string"
            }
          },
          "includeCompanies": {
            "title": "Include Companies",
            "type": "array",
            "description": "Only keep jobs whose company name or slug contains one of these values (case-insensitive).",
            "items": {
              "type": "string"
            }
          },
          "excludeCompanies": {
            "title": "Exclude Companies",
            "type": "array",
            "description": "Drop jobs whose company name or slug contains one of these values. Exclusions win over includeCompanies.",
            "items": {
              "type": "string"
            }
          },
          "postedWithinDays": {
            "title": "Posted Within Days",
            "minimum": 0,
            "maximum": 3650,
            "type": "integer",
            "description": "Keep jobs posted within the last N days. Jobs without a parsed posted date are dropped and counted. 0 = off.",
            "default": 0
          },
          "companySizes": {
            "title": "Company Sizes",
            "type": "array",
            "description": "Keep jobs or companies whose company size matches one of these values, for example 11-50, 51-200 or SIZE_51_200. Rows without a size are dropped and counted.",
            "items": {
              "type": "string"
            }
          },
          "companyStages": {
            "title": "Company Stages",
            "type": "array",
            "description": "Keep jobs or companies whose stage matches one of these values, for example seed, early-stage, growth-stage or scale-stage. Rows without a stage are dropped and counted.",
            "items": {
              "type": "string"
            }
          },
          "ycOnly": {
            "title": "YC Funded Only",
            "type": "boolean",
            "description": "Keep rows where the YC Funded badge is present.",
            "default": false
          },
          "minCompanyFunding": {
            "title": "Minimum Company Funding",
            "minimum": 0,
            "maximum": 10000000000,
            "type": "integer",
            "description": "Keep jobs whose parsed total funding is at or above this amount. Requires detail enrichment; unknown funding is dropped. 0 = off.",
            "default": 0
          },
          "minOpenJobs": {
            "title": "Minimum Open Jobs",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Keep rows whose company open-job count is at or above this value. Requires detail enrichment for jobs; unknown counts are dropped. 0 = off.",
            "default": 0
          },
          "visaSponsorshipOnly": {
            "title": "Visa Sponsorship Only",
            "type": "boolean",
            "description": "Keep jobs whose detail page says visa sponsorship is available. Requires detail enrichment; unknown values are dropped.",
            "default": false
          },
          "minEquity": {
            "title": "Minimum Equity",
            "minimum": 0,
            "maximum": 100,
            "type": "number",
            "description": "Keep jobs whose equity range top is at or above this percentage. Jobs without equity data are dropped. 0 = off.",
            "default": 0
          },
          "maxEquity": {
            "title": "Maximum Equity",
            "minimum": 0,
            "maximum": 100,
            "type": "number",
            "description": "Keep jobs whose equity range bottom is at or below this percentage. 0 = unlimited.",
            "default": 0
          },
          "equityOnly": {
            "title": "Equity Only",
            "type": "boolean",
            "description": "Keep jobs that explicitly offer equity; jobs that say No equity or do not mention equity are dropped.",
            "default": false
          },
          "remoteWfhFlexible": {
            "title": "Remote / WFH Flexible",
            "type": "boolean",
            "description": "Keep jobs whose remote configuration explicitly reports work-from-home flexibility. Requires detail enrichment; unknown values are dropped.",
            "default": false
          },
          "sort": {
            "title": "Sort Order",
            "enum": [
              "newest",
              "oldest",
              "none"
            ],
            "type": "string",
            "description": "none keeps first-seen source order. newest/oldest sort the whole run by parsed posted date; jobs without a date are last.",
            "default": "none"
          },
          "pageLimit": {
            "title": "Page Limit",
            "minimum": 0,
            "maximum": 500,
            "type": "integer",
            "description": "0 fetches every page up to pageCount. N fetches the first N pages. An explicit ?page=N start URL fetches only that page.",
            "default": 0
          },
          "enrichDetails": {
            "title": "Enrich Job Details",
            "type": "boolean",
            "description": "Fetch plain and autoOpen detail pages for selected jobs to add description HTML, structured salary/equity, visa/relocation, skills, company funding, founders, socials and benefits. Direct job URLs are always enriched. Default true; the saved prefill turns it off to keep scheduled runs fast.",
            "default": true
          },
          "maxItems": {
            "title": "Max Items",
            "minimum": 1,
            "maximum": 10000,
            "type": "integer",
            "description": "Maximum jobs or companies pushed after all filters and sorting.",
            "default": 50
          },
          "onlyNew": {
            "title": "Only New Items",
            "type": "boolean",
            "description": "Push only jobs or companies whose IDs have not been seen for this stateKey. Requires stateKey.",
            "default": false
          },
          "stateKey": {
            "title": "State Key",
            "type": "string",
            "description": "Persistent key in the wellfound-monitor key-value store used to remember seen job/company IDs between runs. Changing it starts a fresh history."
          },
          "expandSimilar": {
            "title": "Expand Similar Jobs",
            "type": "boolean",
            "description": "Add related jobs from the autoOpen detail page similarJobs edges, bounded by similarDepth and similarLimit. Only applies to job modes.",
            "default": false
          },
          "similarDepth": {
            "title": "Similar Depth",
            "minimum": 1,
            "maximum": 3,
            "type": "integer",
            "description": "1 emits the similar jobs embedded in the enriched page. 2-3 follow additional autoOpen pages within similarLimit.",
            "default": 1
          },
          "similarLimit": {
            "title": "Similar Limit",
            "minimum": 1,
            "maximum": 100,
            "type": "integer",
            "description": "Maximum additional similar jobs emitted per run, also bounded by maxItems.",
            "default": 10
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}