{
  "openapi": "3.0.1",
  "info": {
    "title": "YC Hiring Startup Leads Monitor",
    "description": "Track hiring signals from public Y Combinator startup profiles and job pages. Extract companies with open roles, job categories, locations, batch details, websites, hiring velocity signals, and source URLs to help recruiters, HR vendors, agencies, and B2B sales teams find active startup prospects.",
    "version": "0.0",
    "x-build-id": "F9ZPrqrzOPyk2kQtu"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/lead.gen.labs~yc-hiring-startup-leads-monitor/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-lead.gen.labs-yc-hiring-startup-leads-monitor",
        "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/lead.gen.labs~yc-hiring-startup-leads-monitor/runs": {
      "post": {
        "operationId": "runs-sync-lead.gen.labs-yc-hiring-startup-leads-monitor",
        "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/lead.gen.labs~yc-hiring-startup-leads-monitor/run-sync": {
      "post": {
        "operationId": "run-sync-lead.gen.labs-yc-hiring-startup-leads-monitor",
        "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": [
          "max_companies"
        ],
        "properties": {
          "query": {
            "title": "Search Query",
            "type": "string",
            "description": "Keyword search for hiring YC companies, products, descriptions, tags, or markets.",
            "default": ""
          },
          "batches": {
            "title": "YC Batches",
            "type": "array",
            "description": "Optional YC batch filters, for example Summer 2026, Winter 2025, or Summer 2013.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "industries": {
            "title": "Industries",
            "type": "array",
            "description": "Optional industry filters, for example B2B, Consumer, Healthcare, Fintech, or Industrials.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "regions": {
            "title": "Regions",
            "type": "array",
            "description": "Optional region filters, for example Remote, United States of America, India, or Europe.",
            "items": {
              "type": "string"
            },
            "default": [
              "Remote"
            ]
          },
          "stages": {
            "title": "Stages",
            "type": "array",
            "description": "Optional stage filters such as Early, Growth, or Public.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "statuses": {
            "title": "Statuses",
            "type": "array",
            "description": "Company status filters such as Active, Acquired, Inactive, or Public.",
            "items": {
              "type": "string"
            },
            "default": [
              "Active"
            ]
          },
          "tags": {
            "title": "Tags",
            "type": "array",
            "description": "Optional YC tag filters such as Artificial Intelligence, SaaS, Marketplace, Fintech, or Developer Tools.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "job_roles": {
            "title": "Job Roles",
            "type": "array",
            "description": "Optional role filters applied to public job postings, for example Engineering, Sales, Product, Operations, or Design.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "job_locations": {
            "title": "Job Locations",
            "type": "array",
            "description": "Optional job location filters applied to public job postings.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "job_keywords": {
            "title": "Job Keywords",
            "type": "array",
            "description": "Optional keyword filters applied to job title, skills, experience, and visa text.",
            "items": {
              "type": "string"
            },
            "default": []
          },
          "min_open_roles": {
            "title": "Minimum Open Roles",
            "minimum": 0,
            "maximum": 10000,
            "type": "integer",
            "description": "Only save companies with at least this many public YC job postings after enrichment.",
            "default": 0
          },
          "require_job_postings": {
            "title": "Require Job Postings",
            "type": "boolean",
            "description": "Only save records when public job postings are present on the YC company profile page.",
            "default": true
          },
          "top_company_only": {
            "title": "Top Companies Only",
            "type": "boolean",
            "description": "Limit results to YC top-company records.",
            "default": false
          },
          "sort_by": {
            "title": "Sort By",
            "enum": [
              "relevance",
              "launch_date"
            ],
            "type": "string",
            "description": "Use relevance for default YC directory ordering or launch_date for YC launch-date ordering.",
            "default": "relevance"
          },
          "max_companies": {
            "title": "Maximum Companies",
            "minimum": 1,
            "maximum": 100000,
            "type": "integer",
            "description": "Maximum hiring startup profiles to save.",
            "default": 100
          },
          "results_per_page": {
            "title": "Results per Algolia Page",
            "minimum": 1,
            "maximum": 1000,
            "type": "integer",
            "description": "Number of YC directory hits requested from Algolia per page.",
            "default": 100
          },
          "enrich_company_pages": {
            "title": "Enrich Company Pages",
            "type": "boolean",
            "description": "Fetch each public YC company profile page for founders, social links, and job postings.",
            "default": true
          },
          "include_founders": {
            "title": "Include Founders",
            "type": "boolean",
            "description": "Include public founder details from YC profile pages.",
            "default": true
          },
          "include_jobs": {
            "title": "Include Job Postings",
            "type": "boolean",
            "description": "Include public YC job postings and hiring monitor metadata.",
            "default": true
          },
          "extract_emails": {
            "title": "Extract Public Emails",
            "type": "boolean",
            "description": "Extract distinct public email addresses if they appear in fetched YC profile pages.",
            "default": true
          },
          "request_delay_millis": {
            "title": "Request Delay",
            "minimum": 0,
            "maximum": 60000,
            "type": "integer",
            "description": "Delay between YC company profile requests in milliseconds.",
            "default": 500
          },
          "browser_impersonation": {
            "title": "Browser Impersonation",
            "type": "string",
            "description": "curl_cffi browser impersonation profile.",
            "default": "chrome136"
          },
          "custom_proxy_url": {
            "title": "Custom Proxy URL",
            "type": "string",
            "description": "Optional proxy URL.",
            "default": ""
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}