{
  "openapi": "3.0.1",
  "info": {
    "title": "Y Combinator Scraper - YC Companies, Founders & Open Jobs",
    "description": "$2 per 1,000 companies; $1 on Business. Every Y Combinator company past the 1,000-result cap with its founders (LinkedIn, X, Hacker News, past companies) and open jobs (salary, equity, hiring manager, description); founder and job rows free. Paste a YC directory URL or filter by batch.",
    "version": "0.1",
    "x-build-id": "06RwnQgnHmiaXzbYg"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/scrapersdelight~yc-company-founder-contact-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-scrapersdelight-yc-company-founder-contact-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/scrapersdelight~yc-company-founder-contact-scraper/runs": {
      "post": {
        "operationId": "runs-sync-scrapersdelight-yc-company-founder-contact-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/scrapersdelight~yc-company-founder-contact-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-scrapersdelight-yc-company-founder-contact-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": {
          "url": {
            "title": "YC directory search URL",
            "type": "string",
            "description": "Set your filters on [ycombinator.com/companies](https://www.ycombinator.com/companies) (batch, industry, region, company size, hiring, top companies, nonprofit, public videos, search text), then copy the full address bar URL and paste it here. Every filter in it is applied exactly as the directory applies it. Leave empty to use the filter fields below instead."
          },
          "scrapeAllCompanies": {
            "title": "Scrape all companies",
            "type": "boolean",
            "description": "Every company in the YC directory (6,265 on 2026-09-30), from all batches. The URL and filters are ignored; Maximum companies still applies if you set it. You pay per company: the whole directory is about $12.53.",
            "default": false
          },
          "scrapeAllFounders": {
            "title": "Founder rows (free)",
            "type": "boolean",
            "description": "Also output one row per founder (type \"founder\"): name, title, bio, LinkedIn, X, Hacker News username, region, past companies and photo, plus the company's name, website and batch. Free: you pay per company, and every company row already lists its founders; this only adds them as their own rows for spreadsheets and CRMs.",
            "default": false
          },
          "scrapeAllJobs": {
            "title": "Open job rows (free)",
            "type": "boolean",
            "description": "Also output one row per open job (type \"job\"): full description, salary and equity (as text and as numbers), location, remote, job type, role, experience, visa, skills, hiring manager, interview process and apply link. Free: you pay per company. Tip: filter on hiring companies (isHiring=true in the URL, or Only companies that are hiring) to skip companies without jobs.",
            "default": false
          },
          "maxItems": {
            "title": "Maximum companies",
            "minimum": 0,
            "type": "integer",
            "description": "Stop after this many companies (you pay per company; founder and job rows come with it free). Leave empty for every match of your URL or filters. With no URL, filter or \"Scrape all companies\" at all, a run returns a 100-company sample. 0 = no limit."
          },
          "batches": {
            "title": "YC batches",
            "type": "array",
            "description": "Keep companies from ANY of these batches. Type them the way you know them: \"S24\", \"W09\", \"P25\" or \"X25\" (Spring), \"F24\" (Fall), \"Summer 2024\", or a year like \"2024\" for every batch that year. Each value is checked against the live directory and an unknown one stops the run before anything is charged.",
            "items": {
              "type": "string"
            }
          },
          "industries": {
            "title": "Industries",
            "type": "array",
            "description": "Keep companies in ANY of these YC industries or sub-industries, e.g. \"Fintech\", \"B2B\", \"Healthcare\", \"Sales\" or \"B2B -> Sales\" (\"Developer Tools\" and \"AI\" are tags - use the Tags field). Matched to the directory's own values (case-insensitive); an unknown value stops the run and lists close matches.",
            "items": {
              "type": "string"
            }
          },
          "regions": {
            "title": "HQ regions",
            "type": "array",
            "description": "Keep companies in ANY of these YC regions, e.g. \"United States of America\" (or \"USA\"), \"Europe\", \"United Kingdom\" (or \"UK\"), \"India\", \"Latin America\", \"Remote\".",
            "items": {
              "type": "string"
            }
          },
          "tags": {
            "title": "Tags",
            "type": "array",
            "description": "Keep companies with ANY of these YC tags, e.g. \"SaaS\", \"Artificial Intelligence\", \"AI\", \"Developer Tools\", \"Marketplace\". The directory has about 330 tags.",
            "items": {
              "type": "string"
            }
          },
          "statuses": {
            "title": "Company status",
            "type": "array",
            "description": "Keep companies with ANY of these statuses. Empty = all four.",
            "items": {
              "type": "string",
              "enum": [
                "Active",
                "Acquired",
                "Public",
                "Inactive"
              ]
            }
          },
          "onlyHiring": {
            "title": "Only companies that are hiring",
            "type": "boolean",
            "description": "Only companies YC marks as hiring (1,485 of 6,265 on 2026-09-30).",
            "default": false
          },
          "onlyTopCompanies": {
            "title": "Only YC Top Companies",
            "type": "boolean",
            "description": "Only companies on YC's Top Companies list (91 on 2026-09-30).",
            "default": false
          },
          "onlyNonprofits": {
            "title": "Only nonprofits",
            "type": "boolean",
            "description": "Only companies YC marks as nonprofit (42 on 2026-09-30).",
            "default": false
          },
          "minTeamSize": {
            "title": "Minimum team size",
            "minimum": 0,
            "type": "integer",
            "description": "Only companies with at least this many people. 0 = no minimum.",
            "default": 0
          },
          "maxTeamSize": {
            "title": "Maximum team size",
            "minimum": 0,
            "type": "integer",
            "description": "Only companies with at most this many people (e.g. 10 for early-stage teams). 0 = no maximum.",
            "default": 0
          },
          "launchedAfter": {
            "title": "Launched on or after",
            "type": "string",
            "description": "Only companies whose YC directory launch date is on or after this date: \"2026-06-01\", or relative like \"30 days\", \"6 months\", \"1 year\". Useful on a schedule to catch each new batch."
          },
          "searchQuery": {
            "title": "Search text",
            "type": "string",
            "description": "Optional free text, the same as the search box on ycombinator.com/companies (company names, one-liners, descriptions)."
          },
          "companyUrls": {
            "title": "Specific companies (URLs or slugs)",
            "type": "array",
            "description": "Look up exact companies instead of searching: ycombinator.com/companies/airbnb URLs (or workatastartup.com/companies/airbnb) or bare slugs like \"airbnb\". The URL and filters are then ignored. A slug YC does not have is reported in RUN_SUMMARY and not charged.",
            "items": {
              "type": "string"
            }
          },
          "requireFounderLinkedin": {
            "title": "Only companies with a founder LinkedIn",
            "type": "boolean",
            "description": "Skip companies where no founder has a LinkedIn profile URL. Skipped companies (and their founder and job rows) are never delivered and never charged.",
            "default": false
          },
          "sortBy": {
            "title": "Order",
            "enum": [
              "relevance",
              "launchDate"
            ],
            "type": "string",
            "description": "\"relevance\" = the directory's own order; \"launchDate\" = newest launched first. When a match is over 1,000 companies it is read batch by batch, newest batch first.",
            "default": "relevance"
          },
          "directoryOnly": {
            "title": "Directory fields only (fastest)",
            "type": "boolean",
            "description": "Skip each company's profile page: company rows carry the directory fields only (name, website, one-liner, description, batch, status, team size, location, industries, tags, regions, logo, launch date), and the whole directory comes back in about half a minute. Founder rows, job rows and \"Only companies with a founder LinkedIn\" need the profile, so this is ignored while any of them is on.",
            "default": false
          },
          "proxyConfiguration": {
            "title": "Proxy configuration",
            "type": "object",
            "description": "Optional. Runs connect directly by default (YC answered Apify's network directly when measured). If YC ever blocks a run, it moves to this proxy, then to Apify RESIDENTIAL, automatically."
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}