{
  "openapi": "3.0.1",
  "info": {
    "title": "Y Combinator Companies Scraper - $0.90 per 1,000",
    "description": "Filter the YC startup directory by batch (W24, S23), industry, region, tag or status and get one row per company: pitch, batch, status, team size, founded year, location, website, tags, and founder names with LinkedIn links. $0.90 per 1,000. No key, no login, no browser.",
    "version": "0.1",
    "x-build-id": "ZGKJk33BRjraW5dOw"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/dami_studio~ycombinator-companies-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-dami_studio-ycombinator-companies-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/dami_studio~ycombinator-companies-scraper/runs": {
      "post": {
        "operationId": "runs-sync-dami_studio-ycombinator-companies-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/dami_studio~ycombinator-companies-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-dami_studio-ycombinator-companies-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": {
          "batches": {
            "title": "Batches",
            "minItems": 0,
            "maxItems": 60,
            "type": "array",
            "description": "YC batches to pull, written either short (W24, S23, F24, P25) or long (Winter 2024, Summer 2023). Leave empty to search across every batch. Each batch is queried separately, so ten batches and 100 rows gives you ten companies from each.",
            "items": {
              "type": "string"
            }
          },
          "industries": {
            "title": "Industries",
            "minItems": 0,
            "maxItems": 60,
            "type": "array",
            "description": "Filter by the industry labels the directory itself uses, for example B2B, Consumer, Healthcare, Fintech, Industrials, Education, Infrastructure, Marketing, Security, Climate. Several values are combined with OR.",
            "items": {
              "type": "string"
            }
          },
          "regions": {
            "title": "Regions",
            "minItems": 0,
            "maxItems": 60,
            "type": "array",
            "description": "Filter by the region labels the directory uses, for example United States of America, Europe, India, Latin America, Remote, Canada, Africa, Southeast Asia. Several values are combined with OR.",
            "items": {
              "type": "string"
            }
          },
          "tags": {
            "title": "Tags",
            "minItems": 0,
            "maxItems": 60,
            "type": "array",
            "description": "Filter by the free-form tags on a company profile, for example Artificial Intelligence, SaaS, Developer Tools, Marketplace, Generative AI, Open Source, Health Tech. Several values are combined with OR.",
            "items": {
              "type": "string"
            }
          },
          "statuses": {
            "title": "Company status",
            "minItems": 0,
            "maxItems": 4,
            "type": "array",
            "description": "Keep only companies with these statuses. Leave empty for all four.",
            "items": {
              "type": "string",
              "enum": [
                "Active",
                "Acquired",
                "Public",
                "Inactive"
              ]
            }
          },
          "searchTerms": {
            "title": "Search terms",
            "minItems": 0,
            "maxItems": 60,
            "type": "array",
            "description": "Free-text search across company names, pitches and descriptions, for example \"robotics\", \"climate\", \"payments in Africa\". Each term is searched separately and can be combined with the filters above.",
            "items": {
              "type": "string"
            }
          },
          "companyUrls": {
            "title": "Company profile URLs",
            "minItems": 0,
            "maxItems": 500,
            "type": "array",
            "description": "Look up specific companies instead of searching. Paste full profile URLs (https://www.ycombinator.com/companies/doordash) or bare slugs (doordash). Up to 500 per run.",
            "items": {
              "type": "string"
            }
          },
          "allCompanies": {
            "title": "Whole directory",
            "type": "boolean",
            "description": "Sweep the entire directory instead of filtering. Combine it with a high row limit; the run walks batch by batch, newest first. Remember you pay per company."
          },
          "isHiring": {
            "title": "Only companies that are hiring",
            "type": "boolean",
            "description": "Keep only companies flagged as hiring on their directory card."
          },
          "topCompaniesOnly": {
            "title": "Only top companies",
            "type": "boolean",
            "description": "Keep only the companies the directory marks as top companies."
          },
          "nonprofitOnly": {
            "title": "Only non-profits",
            "type": "boolean",
            "description": "Keep only the non-profit organisations in the directory."
          },
          "includeFounders": {
            "title": "Include founders and founded year",
            "type": "boolean",
            "description": "On by default. Reads each company's own profile page as well, which is what fills in founder names and titles, the year the company was founded, its city and country, and its LinkedIn, X, Facebook, Crunchbase and GitHub links. Turn it off for a faster, lighter run when you only need the directory card. The price per company is the same either way."
          },
          "maxItems": {
            "title": "Maximum companies",
            "minimum": 1,
            "maximum": 7000,
            "type": "integer",
            "description": "Total number of companies to return in this run, shared evenly across your batches and search terms. Default 20, hard ceiling 7,000 (the directory holds about 6,200). Keep it low while you are testing - you pay per company."
          },
          "proxyUrls": {
            "title": "Your own proxy servers (optional)",
            "minItems": 0,
            "maxItems": 50,
            "type": "array",
            "description": "Leave this empty. By default the run rotates a large pool of addresses that cost you nothing per gigabyte. Fill it in only if you specifically want the traffic to leave through proxy servers you already pay for, in the form http://user:pass@host:port.",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}