{
  "openapi": "3.0.1",
  "info": {
    "title": "Y Combinator Company Lookup with Size & Hiring Filters",
    "description": "Look up Y Combinator companies by direct URL or slug, or filter the directory by team size, founding year, hiring status and founder social presence, with each company's founders, open jobs and social links attached.",
    "version": "1.1",
    "x-build-id": "Md4TeBxFWD3yNcF39"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/nimbryxo-studio~y-combinator-company-lookup-with-size-and-hiring/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-nimbryxo-studio-y-combinator-company-lookup-with-size-and-hiring",
        "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~y-combinator-company-lookup-with-size-and-hiring/runs": {
      "post": {
        "operationId": "runs-sync-nimbryxo-studio-y-combinator-company-lookup-with-size-and-hiring",
        "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~y-combinator-company-lookup-with-size-and-hiring/run-sync": {
      "post": {
        "operationId": "run-sync-nimbryxo-studio-y-combinator-company-lookup-with-size-and-hiring",
        "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": [
          "directoryUrl"
        ],
        "properties": {
          "directoryUrl": {
            "title": "Directory URL",
            "type": "string",
            "description": "Y Combinator directory URL. Paste a pre-filtered URL (e.g. https://www.ycombinator.com/companies?batch=S24&industry=AI) to apply its query-string filters. Defaults to the full directory.",
            "default": "https://www.ycombinator.com/companies"
          },
          "companyUrls": {
            "title": "Company URLs",
            "type": "array",
            "description": "Direct YC company profile URLs, e.g. https://www.ycombinator.com/companies/airbnb. Each URL is fetched independently of the directory search.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "companySlugs": {
            "title": "Company slugs",
            "type": "array",
            "description": "Direct YC company slugs, e.g. airbnb, stripe. Use this instead of URLs when you already have slugs.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "query": {
            "title": "Search query",
            "type": "string",
            "description": "Free-text search across company names, descriptions and tags. Leave empty to browse the directory by filters only."
          },
          "batches": {
            "title": "Batches",
            "type": "array",
            "description": "YC batches, either short codes or full names: S24, W24, F24, SP25, or Summer 2024. Leave empty for every batch. All batches are fetched when you need more than 1,000 companies.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "industries": {
            "title": "Industries",
            "type": "array",
            "description": "Exact YC industry values, e.g. B2B, Consumer, Fintech, Healthcare, Industrials. Values are matched against YC's industry facet.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "subIndustries": {
            "title": "Sub-industries",
            "type": "array",
            "description": "Exact or leaf sub-industry values, e.g. Infrastructure, Productivity, or 'Consumer -> Travel, Leisure and Tourism'.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "statuses": {
            "title": "Statuses",
            "type": "array",
            "description": "Company operating status: Active, Inactive, Acquired, Public. Leave empty for all statuses.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "stages": {
            "title": "Stages",
            "type": "array",
            "description": "Funding stage: Early or Growth. YC's index does not expose stage as a facet, so this filter is applied to each fetched record.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "regions": {
            "title": "Regions",
            "type": "array",
            "description": "Exact YC region values, e.g. Europe, America / Canada, Remote, Fully Remote. Also accepts a free-text location match.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "tags": {
            "title": "Tags",
            "type": "array",
            "description": "Exact YC tags, e.g. AI, B2B, SaaS, Fintech, Developer Tools. Any one match is enough.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "teamSizeMin": {
            "title": "Minimum team size",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Drop companies with fewer employees than this. Uses YC's numeric team-size field."
          },
          "teamSizeMax": {
            "title": "Maximum team size",
            "minimum": 0,
            "maximum": 100000,
            "type": "integer",
            "description": "Drop companies with more employees than this. Uses YC's numeric team-size field."
          },
          "foundedAfterYear": {
            "title": "Founded after year",
            "minimum": 1900,
            "maximum": 2100,
            "type": "integer",
            "description": "Keep companies launched in or after this year. YC's launch timestamp is the numeric field the index supports."
          },
          "foundedBeforeYear": {
            "title": "Founded before year",
            "minimum": 1900,
            "maximum": 2100,
            "type": "integer",
            "description": "Keep companies launched in or before this year."
          },
          "hiringOnly": {
            "title": "YC hiring badge only",
            "type": "boolean",
            "description": "Keep only companies carrying YC's 'is hiring' badge.",
            "default": false
          },
          "onlyWithOpenJobs": {
            "title": "Only companies with open jobs",
            "type": "boolean",
            "description": "Keep only companies whose profile actually lists at least one open job. This checks the live job list, not just the badge.",
            "default": false
          },
          "requireFounderSocial": {
            "title": "Require a founder social profile",
            "type": "boolean",
            "description": "Keep only companies where at least one founder has a LinkedIn, Twitter/X, GitHub or website link.",
            "default": false
          },
          "topCompaniesOnly": {
            "title": "YC top companies only",
            "type": "boolean",
            "description": "Keep only companies YC marks as top companies.",
            "default": false
          },
          "nonprofitOnly": {
            "title": "Nonprofits only",
            "type": "boolean",
            "description": "Keep only companies YC marks as nonprofits.",
            "default": false
          },
          "highlightBlackFounders": {
            "title": "Black-founded companies",
            "type": "boolean",
            "description": "Keep only companies on YC's official Black-founded companies list. The list is an opt-in page, so absence is not proof of anything.",
            "default": false
          },
          "highlightWomenFounders": {
            "title": "Women-founded companies",
            "type": "boolean",
            "description": "Keep only companies on YC's official women-founded companies list.",
            "default": false
          },
          "highlightHispanicFounders": {
            "title": "Hispanic / Latino-founded companies",
            "type": "boolean",
            "description": "Keep only companies on YC's official Hispanic and Latino-founded companies list.",
            "default": false
          },
          "scrapeFounders": {
            "title": "Include founders",
            "type": "boolean",
            "description": "Add each company's founders (name, title, bio, social links) from its profile page.",
            "default": true
          },
          "scrapeFounderProfiles": {
            "title": "Include founder directory profiles",
            "type": "boolean",
            "description": "Also fetch each founder's directory page for schools, previous roles, previous YC companies and a profile URL. Adds one request per founder.",
            "default": false
          },
          "scrapeOpenJobs": {
            "title": "Include open jobs",
            "type": "boolean",
            "description": "Add each company's complete open-job list from its profile page.",
            "default": true
          },
          "includeJobDetails": {
            "title": "Include job descriptions",
            "type": "boolean",
            "description": "Fetch every job's own page to add its description, interview process and hiring manager. Adds one request per open job.",
            "default": false
          },
          "includeNews": {
            "title": "Include news items",
            "type": "boolean",
            "description": "Add the news links listed on each company profile.",
            "default": true
          },
          "includeLaunchPosts": {
            "title": "Include Launch YC posts",
            "type": "boolean",
            "description": "Add each company's Launch YC posts, including the full post body.",
            "default": false
          },
          "includeQa": {
            "title": "Include founder Q&A",
            "type": "boolean",
            "description": "Add the founder Q&A answers published on each company profile.",
            "default": true
          },
          "includeVideos": {
            "title": "Include videos",
            "type": "boolean",
            "description": "Add YC library / YouTube videos and app or demo-day videos. Expiring signed video URLs are re-hosted in the run's key-value store so they stay playable.",
            "default": false
          },
          "sortBy": {
            "title": "Sort order",
            "enum": [
              "launchDateDesc",
              "launchDateAsc",
              "nameAsc",
              "teamSizeDesc",
              "teamSizeAsc"
            ],
            "type": "string",
            "description": "Order in which companies are returned. launchDateDesc, the default, returns the newest launches first.",
            "default": "launchDateDesc"
          },
          "maxItems": {
            "title": "Maximum companies",
            "minimum": 0,
            "maximum": 10000,
            "type": "integer",
            "description": "Maximum number of companies to return. Set 0 to return every match (the directory currently has about 6,400 companies; the actor caps a run at 10,000).",
            "default": 3
          },
          "maxConcurrency": {
            "title": "Maximum concurrency",
            "minimum": 1,
            "maximum": 32,
            "type": "integer",
            "description": "How many profile / job / founder pages are fetched in parallel. Higher is faster; 8 is a polite default.",
            "default": 8
          },
          "emitErrorRecord": {
            "title": "Emit an error record when nothing matches",
            "type": "boolean",
            "description": "When on, a run that matches zero companies pushes one diagnostic record instead of leaving the dataset empty. Upstream failures always fail the run and never produce a success record.",
            "default": 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
                  },
                  "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}