{
  "openapi": "3.0.1",
  "info": {
    "title": "Y Combinator [Only $1💰] Jobs & Companies scraper",
    "description": "💰 $1/1K One actor for Y Combinator jobs (Work at a Startup) and companies (Startup Directory). Paste any YC URL — auto-routed — or use filters. Companies via Algolia: no proxy, clean schema. Optional founder enrichment: LinkedIn/Twitter URLs, company socials, open jobs. Full batch history to 2005.",
    "version": "0.0",
    "x-build-id": "QUosuhVXsVOPA6ISY"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/memo23~y-combinator-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-memo23-y-combinator-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/memo23~y-combinator-scraper/runs": {
      "post": {
        "operationId": "runs-sync-memo23-y-combinator-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/memo23~y-combinator-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-memo23-y-combinator-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": {
          "startUrls": {
            "title": "Start URLs (accepts Jobs and Companies URLs)",
            "type": "array",
            "description": "Any YC URL. Auto-routed by path. Mix Jobs and Companies URLs freely. The two URLs prefilled below are sample defaults — clear them and paste your own when running.\n\n**Jobs URLs:**\n- `https://www.ycombinator.com/jobs` (curated index)\n- `https://www.ycombinator.com/jobs/role/{role}` (e.g. `…/jobs/role/software-engineer`)\n- `https://www.ycombinator.com/jobs/role/{role}/{location}` (e.g. `…/jobs/role/software-engineer/san-francisco`)\n- `https://www.ycombinator.com/jobs/location/{location}` (e.g. `…/jobs/location/new-york`)\n- `https://www.ycombinator.com/companies/{co}/jobs/{job}` (single job detail)\n\n**Companies URLs:**\n- `https://www.ycombinator.com/companies` (all companies)\n- `https://www.ycombinator.com/companies?batch=Spring%202026&industry=B2B&query=fintech` (filtered search)\n- `https://www.ycombinator.com/companies/{slug}` (e.g. `…/companies/airbnb` — single-company lookup)",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "mode": {
            "title": "Mode",
            "enum": [
              "jobs",
              "companies"
            ],
            "type": "string",
            "description": "Pick a target surface; the matching filter fields below will be used. Jobs uses the role/location selectors; Companies uses the keyword/batch/industry/region/size block.",
            "default": "jobs"
          },
          "role": {
            "title": "💼 Jobs · Role",
            "enum": [
              "",
              "software-engineer",
              "designer",
              "product-manager",
              "operations",
              "marketing",
              "sales-manager",
              "recruiting-hr",
              "support",
              "science"
            ],
            "type": "string",
            "description": "Used when Mode = Jobs and Start URLs is empty. YC role category.",
            "default": ""
          },
          "location": {
            "title": "💼 Jobs · Location",
            "enum": [
              "",
              "san-francisco",
              "new-york",
              "los-angeles",
              "seattle",
              "austin",
              "chicago",
              "india",
              "remote"
            ],
            "type": "string",
            "description": "Used when Mode = Jobs. City slugs match the city name in each job's location string; `remote` matches anything containing 'Remote'; `india` matches the country.",
            "default": ""
          },
          "queries": {
            "title": "🏢 Companies · Search Keywords",
            "type": "array",
            "description": "Used when Mode = Companies. One or more keywords (product category, market, technology, location, …). Multiple keywords run as separate Algolia searches and are merged by company id with dedupe. Empty = no keyword filter.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "topCompany": {
            "title": "🏢 Companies · Include Top Companies Only",
            "type": "boolean",
            "description": "Limit results to companies marked as Top by Y Combinator. Use when you want a smaller, more selective set.",
            "default": false
          },
          "isHiring": {
            "title": "🏢 Companies · Include Hiring Companies Only",
            "type": "boolean",
            "description": "Limit results to companies currently marked as hiring. Useful for recruiting and active-growth research.",
            "default": false
          },
          "nonprofit": {
            "title": "🏢 Companies · Include Nonprofit Companies Only",
            "type": "boolean",
            "description": "Limit results to companies marked as nonprofits. Leave disabled to include both commercial and nonprofit organizations.",
            "default": false
          },
          "batch": {
            "title": "🏢 Companies · YC Batches",
            "uniqueItems": true,
            "type": "array",
            "description": "Select one or more batches to narrow results by cohort.",
            "items": {
              "type": "string",
              "enum": [
                "All Batches",
                "Fall 2026",
                "Summer 2026",
                "Spring 2026",
                "Winter 2026",
                "Fall 2025",
                "Summer 2025",
                "Spring 2025",
                "Winter 2025",
                "Fall 2024",
                "Summer 2024",
                "Winter 2024",
                "Summer 2023",
                "Winter 2023",
                "Summer 2022",
                "Winter 2022",
                "Summer 2021",
                "Winter 2021",
                "Summer 2020",
                "Winter 2020",
                "Summer 2019",
                "Winter 2019",
                "Summer 2018",
                "Winter 2018",
                "Summer 2017",
                "Winter 2017",
                "Summer 2016",
                "Winter 2016",
                "Summer 2015",
                "Winter 2015",
                "Summer 2014",
                "Winter 2014",
                "Summer 2013",
                "Winter 2013",
                "Summer 2012",
                "Winter 2012",
                "Summer 2011",
                "Winter 2011",
                "Summer 2010",
                "Winter 2010",
                "Summer 2009",
                "Winter 2009",
                "Summer 2008",
                "Winter 2008",
                "Summer 2007",
                "Winter 2007",
                "Summer 2006",
                "Winter 2006",
                "Summer 2005"
              ],
              "enumTitles": [
                "📆 All batches (no filter)",
                "📆 Fall 2026 batch",
                "📆 Summer 2026 batch",
                "📆 Spring 2026 batch",
                "📆 Winter 2026 batch",
                "📆 Fall 2025 batch",
                "📆 Summer 2025 batch",
                "📆 Spring 2025 batch",
                "📆 Winter 2025 batch",
                "📆 Fall 2024 batch",
                "📆 Summer 2024 batch",
                "📆 Winter 2024 batch",
                "📆 Summer 2023 batch",
                "📆 Winter 2023 batch",
                "📆 Summer 2022 batch",
                "📆 Winter 2022 batch",
                "📆 Summer 2021 batch",
                "📆 Winter 2021 batch",
                "📆 Summer 2020 batch",
                "📆 Winter 2020 batch",
                "📆 Summer 2019 batch",
                "📆 Winter 2019 batch",
                "📆 Summer 2018 batch",
                "📆 Winter 2018 batch",
                "📆 Summer 2017 batch",
                "📆 Winter 2017 batch",
                "📆 Summer 2016 batch",
                "📆 Winter 2016 batch",
                "📆 Summer 2015 batch",
                "📆 Winter 2015 batch",
                "📆 Summer 2014 batch",
                "📆 Winter 2014 batch",
                "📆 Summer 2013 batch",
                "📆 Winter 2013 batch",
                "📆 Summer 2012 batch",
                "📆 Winter 2012 batch",
                "📆 Summer 2011 batch",
                "📆 Winter 2011 batch",
                "📆 Summer 2010 batch",
                "📆 Winter 2010 batch",
                "📆 Summer 2009 batch",
                "📆 Winter 2009 batch",
                "📆 Summer 2008 batch",
                "📆 Winter 2008 batch",
                "📆 Summer 2007 batch",
                "📆 Winter 2007 batch",
                "📆 Summer 2006 batch",
                "📆 Winter 2006 batch",
                "📆 Summer 2005 batch"
              ]
            },
            "default": [
              "All Batches"
            ]
          },
          "industries": {
            "title": "🏢 Companies · Industries",
            "uniqueItems": true,
            "type": "array",
            "description": "Select one or more industries to focus the run.",
            "items": {
              "type": "string",
              "enum": [
                "All industries",
                "B2B",
                "Consumer",
                "Healthcare",
                "Fintech",
                "Engineering, Product and Design",
                "Industrials",
                "Education",
                "Real Estate and Construction",
                "Government",
                "Unspecified"
              ],
              "enumTitles": [
                "🌐 All industries (no filter)",
                "🤝 B2B (enterprise and business tools)",
                "🛍️ Consumer (consumer products and services)",
                "🩺 Healthcare (health and life sciences)",
                "💳 Fintech (financial technology)",
                "🛠️ Engineering, Product and Design",
                "🏭 Industrials (manufacturing and logistics)",
                "🎓 Education (edtech and learning)",
                "🏗️ Real Estate and Construction",
                "🏛️ Government (public sector)",
                "❓ Unspecified (not categorized)"
              ]
            },
            "default": [
              "All industries"
            ]
          },
          "regions": {
            "title": "🏢 Companies · HQ Regions",
            "uniqueItems": true,
            "type": "array",
            "description": "Select one or more regions to narrow geographically.",
            "items": {
              "type": "string",
              "enum": [
                "Anywhere",
                "United States of America",
                "America / Canada",
                "Canada",
                "Mexico",
                "Latin America",
                "Europe",
                "United Kingdom",
                "Africa",
                "Middle East and North Africa",
                "South Asia",
                "India",
                "Southeast Asia",
                "East Asia",
                "Oceania",
                "Remote",
                "Fully Remote",
                "Partly Remote",
                "Unspecified"
              ],
              "enumTitles": [
                "🌐 Anywhere (no region filter)",
                "🇺🇸 United States of America",
                "🌎 America / Canada",
                "🇨🇦 Canada",
                "🇲🇽 Mexico",
                "🌎 Latin America",
                "🌍 Europe",
                "🇬🇧 United Kingdom",
                "🌍 Africa",
                "🌍 Middle East and North Africa",
                "🌏 South Asia",
                "🇮🇳 India",
                "🌏 Southeast Asia",
                "🌏 East Asia",
                "🌊 Oceania",
                "🛰️ Remote",
                "🛰️ Fully Remote",
                "🛰️ Partly Remote",
                "❓ Unspecified"
              ]
            },
            "default": [
              "Anywhere"
            ]
          },
          "minEmployeeSize": {
            "title": "🏢 Companies · Minimum Employee Size",
            "enum": [
              "1+",
              "5+",
              "10+",
              "25+",
              "50+",
              "100+",
              "250+",
              "500+",
              "1000+"
            ],
            "type": "string",
            "description": "Smallest team size to include. Select '1+' for no minimum.",
            "default": "1+"
          },
          "maxEmployeeSize": {
            "title": "🏢 Companies · Maximum Employee Size",
            "enum": [
              "1+",
              "5",
              "10",
              "25",
              "50",
              "100",
              "250",
              "500",
              "1000+"
            ],
            "type": "string",
            "description": "Largest team size to include. Select '1000+' for no maximum.",
            "default": "1000+"
          },
          "scrapeFounderDetails": {
            "title": "🙌 Companies Enrich · Scrape Founder Details",
            "type": "boolean",
            "description": "Companies mode only. Adds an extra HTTP per company (concurrency = 5) — slows runs. Fetches `/companies/{slug}` and adds `founders[]` (name, title, bio, linkedinUrl, twitterUrl, avatarUrl, isActive, hasEmail) plus `socials` (linkedin, twitter, facebook, crunchbase, github), `appVideoUrl`, `demoDayVideoUrl`.",
            "default": false
          },
          "scrapeOpenJobs": {
            "title": "🙌 Companies Enrich · Scrape Open Job Postings",
            "type": "boolean",
            "description": "Companies mode only. Adds an extra HTTP per company (concurrency = 5) — slows runs. Fetches `/companies/{slug}/jobs` and adds `openJobs[]` (title, role, location, salary, equity, experience, applyUrl, posted-ago).",
            "default": false
          },
          "maxItems": {
            "title": "Output cap — max records to return",
            "minimum": 1,
            "type": "integer",
            "description": "Hard ceiling on dataset rows. Stops the run after this many job-detail pages or company hits have been emitted. Applies to both Jobs and Companies. Free-tier accounts are capped at 100 regardless.",
            "default": 100
          },
          "maxPages": {
            "title": "Pagination depth — max listing pages per URL (jobs only)",
            "minimum": 1,
            "type": "integer",
            "description": "Jobs scraper only: how many `?page=N` listing pages to follow per start URL. Companies scraper paginates Algolia automatically until `maxItems` is reached, ignoring this setting.",
            "default": 10
          },
          "monitoringMode": {
            "title": "Monitoring mode (jobs only)",
            "type": "boolean",
            "description": "Jobs scraper only: only jobs whose numeric id has not been stored in your Key-Value store yet are enqueued (per Apify user id). Useful for scheduled runs that should only emit new postings.",
            "default": false
          },
          "maxConcurrency": {
            "title": "Max concurrency (jobs only)",
            "minimum": 1,
            "type": "integer",
            "description": "Jobs scraper only: max parallel HTTP requests.",
            "default": 10
          },
          "minConcurrency": {
            "title": "Min concurrency (jobs only)",
            "minimum": 1,
            "type": "integer",
            "description": "Jobs scraper only: min parallel HTTP requests to keep active.",
            "default": 1
          },
          "maxRequestRetries": {
            "title": "Max request retries (jobs only)",
            "minimum": 0,
            "type": "integer",
            "description": "Jobs scraper only: retries before a request is marked failed.",
            "default": 3
          },
          "proxy": {
            "title": "Proxy configuration (jobs only)",
            "type": "object",
            "description": "Proxy for the Jobs scraper. Companies mode hits YC's Algolia API directly and does not use a proxy regardless of what's configured here.",
            "default": {
              "useApifyProxy": true
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}