{
  "openapi": "3.0.1",
  "info": {
    "title": "Y Combinator Scraper with Founders & Emails",
    "description": "Scrape the Y Combinator directory and get rich company profiles with socials, founder details + emails, hiring status/job links, and news mentions. Perfect for lead gen, market mapping, recruiting, and competitor tracking.",
    "version": "1.0",
    "x-build-id": "8eUuJuQqd94fWt4wI"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/fatihtahta~y-combinator-directory-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-fatihtahta-y-combinator-directory-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/fatihtahta~y-combinator-directory-scraper/runs": {
      "post": {
        "operationId": "runs-sync-fatihtahta-y-combinator-directory-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/fatihtahta~y-combinator-directory-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-fatihtahta-y-combinator-directory-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": {
          "topCompanies": {
            "title": "Include Top Companies Only",
            "type": "boolean",
            "description": "Limit results to companies marked as top companies by Y Combinator. Use this when you want a smaller, more selective company set."
          },
          "isHiring": {
            "title": "Include Hiring Companies Only",
            "type": "boolean",
            "description": "Limit results to companies currently marked as hiring. This is useful for recruiting, talent market mapping, and active-growth research."
          },
          "nonprofit": {
            "title": "Include Nonprofit Companies Only",
            "type": "boolean",
            "description": "Limit results to companies marked as nonprofits. Leave disabled when you want commercial and nonprofit organizations included together."
          },
          "queries": {
            "title": "Add Company Search Keywords",
            "type": "array",
            "description": "Enter one or more keywords such as a product category, market, technology, or location. More keywords broaden discovery across multiple themes; fewer keywords keep the output easier to review.",
            "items": {
              "type": "string"
            }
          },
          "batches": {
            "title": "Choose YC Batches",
            "uniqueItems": true,
            "type": "array",
            "description": "Select one or more batches to narrow results by cohort. Choose All Batches when batch should not restrict the output.",
            "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": "Choose Industries",
            "uniqueItems": true,
            "type": "array",
            "description": "Select one or more industries to focus the run. Choose All industries when industry should not restrict discovery.",
            "items": {
              "type": "string",
              "enum": [
                "All industries",
                "B2B",
                "Consumer",
                "Fintech",
                "Healthcare",
                "Education",
                "Industrials",
                "Real Estate and Construction",
                "Government",
                "Unspecified"
              ],
              "enumTitles": [
                "🌐 All industries (no filter)",
                "🤝 B2B (enterprise and business tools)",
                "🛍️ Consumer (consumer products and services)",
                "💳 Fintech (financial technology)",
                "🩺 Healthcare (health and life sciences)",
                "🎓 Education (edtech and learning)",
                "🏭 Industrials (manufacturing and logistics)",
                "🏗️ Real estate and construction",
                "🏛️ Government (public sector)",
                "❓ Unspecified (not categorized)"
              ]
            },
            "default": [
              "All industries"
            ]
          },
          "regions": {
            "title": "Choose Company Regions",
            "uniqueItems": true,
            "type": "array",
            "description": "Select one or more regions to narrow the dataset geographically. Choose Anywhere when region should not restrict the output.",
            "items": {
              "type": "string",
              "enum": [
                "Anywhere",
                "America / Canada",
                "Remote",
                "Europe",
                "South Asia",
                "Latin America",
                "Southeast Asia",
                "Africa",
                "Middle East and North Africa",
                "East Asia",
                "Oceania"
              ],
              "enumTitles": [
                "🌐 Anywhere (no region filter)",
                "🌎 America / Canada",
                "🛰️ Remote",
                "🌍 Europe",
                "🌏 South Asia",
                "🌎 Latin America",
                "🌏 Southeast Asia",
                "🌍 Africa",
                "🌍 Middle East and North Africa",
                "🌏 East Asia",
                "🌊 Oceania"
              ]
            },
            "default": [
              "Anywhere"
            ]
          },
          "minEmployeeSize": {
            "title": "Set Minimum Employee Size",
            "enum": [
              "1+",
              "5+",
              "10+",
              "25+",
              "50+",
              "100+",
              "250+",
              "500+",
              "1000+"
            ],
            "type": "string",
            "description": "Choose the smallest company size to include. Select 1+ when you do not want to apply a minimum employee-size filter.",
            "default": "1+"
          },
          "maxEmployeeSize": {
            "title": "Set Maximum Employee Size",
            "enum": [
              "1+",
              "5",
              "10",
              "25",
              "50",
              "100",
              "250",
              "500",
              "1000+"
            ],
            "type": "string",
            "description": "Choose the largest company size to include. Select 1000+ when you do not want to apply a maximum employee-size filter.",
            "default": "1000+"
          },
          "get_founders": {
            "title": "Include Founder Details",
            "type": "boolean",
            "description": "Save founder information inside each company record. Disable this when you only need company-level data or want a lighter output.",
            "default": true
          },
          "getEmails": {
            "title": "Find Founder Email Addresses",
            "type": "boolean",
            "description": "When enabled, add founder email addresses where available. This setting is most useful for outreach workflows that need contact fields in the dataset.",
            "default": true
          },
          "includeRiskyEmails": {
            "title": "Include Lower-Confidence Email Matches",
            "type": "boolean",
            "description": "Include additional potential email matches that may require extra review. Email results are labeled by confidence so you can filter stricter or broader contact lists after the run.",
            "default": true
          },
          "limit": {
            "title": "Set Maximum Companies to Save",
            "type": "integer",
            "description": "Stop saving records after this many companies are collected for each configured search path. Increase the limit for broader coverage, or reduce it when you only need a fast sample.",
            "default": 50000
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}