# YC Startup Intelligence Enricher (`constant_hyssop/yc-startup-enricher`) Actor

Extract 5,800+ Y Combinator startups with founder names, LinkedIn profiles, direct contact emails, phones, and social media handles via deep website enrichment. Filter by batch, industry, status, or hiring status.

- **URL**: https://apify.com/constant\_hyssop/yc-startup-enricher.md
- **Developed by:** [Saidur Rahman Pulok](https://apify.com/constant_hyssop) (community)
- **Categories:** Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $7.00 / 1,000 dataset items

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.
Actors are written with capital "A".

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## YC Startup Intelligence & Founder Contact Enricher

[![Apify Actor](https://img.shields.io/badge/Apify-Actor-blue?logo=apify\&logoColor=white)](https://apify.com/constant_hyssop/yc-startup-enricher)
[![TypeScript](https://img.shields.io/badge/TypeScript-5.7-3178C6?logo=typescript\&logoColor=white)](https://www.typescriptlang.org/)
[![Crawlee](https://img.shields.io/badge/Crawlee-v3-orange)](https://crawlee.dev/)
[![Docker](https://img.shields.io/badge/Docker-Ready-2496ED?logo=docker\&logoColor=white)](https://www.docker.com/)

An advanced data intelligence and prospecting Actor that extracts **5,800+ Y Combinator-backed startups** from the official YC directory and deeply enriches them with **verified founder names, direct emails, founder & company LinkedIn URLs, phone numbers, and official social media channels**.

***

### Overview & Key Capabilities

Traditional YC scrapers only export a basic company directory without decision-maker contacts. This Actor combines the official YC database with deep website content extraction to deliver actionable sales and investment intelligence.

```
+------------------------+      +---------------------------+      +---------------------------+
| YC Algolia Public API  | ---> | Founder Scraper Engine    | ---> | Deep Website Crawl        |
| • 5,800+ Companies     |      | • Founder Names & Roles   |      | • Direct Corporate Emails |
| • Batch & Statuses     |      | • Personal LinkedIn/X     |      | • Social Profiles & Phones|
+------------------------+      +---------------------------+      +---------------------------+
```

#### Core Features

- **Complete Directory Coverage**: Access all 5,800+ YC startups across every batch (W05 to present).
- **Founder Intelligence**: Automatically extracts founder names and personal LinkedIn/X handles.
- **Deep Website Enrichment**: Crawls company domains (`/contact`, `/about`, `/team`) to discover public corporate emails, phone lines, and social handles.
- **Granular Filtering**: Filter by YC batch (e.g. `W24`, `S23`), status (`Active`, `Acquired`, `Public`), industry (`AI`, `B2B`, `Fintech`, `Healthcare`), and hiring status (`isHiring`).
- **High-Speed Execution**: Directly queries official search endpoints without fragile browser rendering.

***

### Comparison: Traditional Scrapers vs. This Actor

| Feature | Basic YC Directory Scrapers | YC Startup Intelligence Enricher |
|---|---|---|
| Company Name & Description | Yes | Yes |
| Batch, Industry & Status | Yes | Yes |
| Founder Names & Roles | Rarely / Incomplete | **Yes (Automated Extraction)** |
| Direct Contact Emails | No | **Yes (Deep Website Crawl)** |
| Personal & Company LinkedIn | Basic / Missing | **Yes (Both Company & Founders)** |
| Social Media Footprint | No | **LinkedIn, Twitter/X, GitHub, FB, IG** |
| CRM / Webhook Ready | Basic | **JSON, CSV, Excel, n8n, Zapier** |

***

### Input Parameters

| Parameter | Type | Default | Description |
|---|---|---|---|
| `searchQuery` | `string` | `""` | Search keyword for company name, technology, or description. |
| `batch` | `string` | `""` | Filter by YC batch (e.g. `W24`, `S23`, `F25`). |
| `status` | `string` | `""` | Filter by status: `Active`, `Acquired`, `Inactive`, or `Public`. |
| `industry` | `string` | `""` | Filter by industry (e.g. `Healthcare`, `Fintech`, `B2B`, `AI`). |
| `region` | `string` | `""` | Filter by region (e.g. `United States`, `Europe`). |
| `isHiring` | `boolean` | `false` | Only return companies currently hiring. |
| `isTopCompany` | `boolean` | `false` | Only return YC top companies. |
| `maxCompanies` | `integer` | `100` | Maximum number of startups to extract (0 for all). |
| `enrichContacts` | `boolean` | `true` | Deep-crawl startup websites for verified emails, phones, and socials. |

#### Sample Input

```json
{
  "searchQuery": "AI",
  "batch": "W24",
  "isHiring": true,
  "maxCompanies": 50,
  "enrichContacts": true
}
```

***

### Output Data Structure

The Actor produces clean, structured JSON items in the default dataset:

```json
{
  "id": 12345,
  "name": "Acme AI",
  "slug": "acme-ai",
  "website": "https://www.acme-ai.com",
  "oneLiner": "Autonomous intelligence workflow engine.",
  "longDescription": "Acme AI provides enterprise workflow automation...",
  "teamSize": 12,
  "ycUrl": "https://www.ycombinator.com/companies/acme-ai",
  "batch": "W24",
  "status": "Active",
  "industries": ["B2B", "Artificial Intelligence"],
  "founders": [
    {
      "name": "Jane Doe",
      "title": "Co-Founder & CEO",
      "linkedin": "https://www.linkedin.com/in/janedoe"
    }
  ],
  "email": "contact@acme-ai.com",
  "emails": ["contact@acme-ai.com", "support@acme-ai.com"],
  "phone": "+1-415-555-0199",
  "linkedin": "https://www.linkedin.com/company/acme-ai",
  "twitter": "https://x.com/AcmeAI",
  "github": "https://github.com/acme-ai",
  "isHiring": true,
  "isTopCompany": false,
  "scrapedAt": "2026-08-16T12:00:00.000Z",
  "enriched": true
}
```

***

### API & Automation Integration

#### Python

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run_input = {
    "batch": "W24",
    "isHiring": True,
    "maxCompanies": 50,
    "enrichContacts": True
}

run = client.actor("constant_hyssop/yc-startup-enricher").call(run_input=run_input)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['name']} | Email: {item['email']} | Founders: {item['founders']}")
```

#### Node.js / TypeScript

```typescript
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });

const run = await client.actor('constant_hyssop/yc-startup-enricher').call({
    searchQuery: 'Fintech',
    maxCompanies: 25,
    enrichContacts: true,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Extracted ${items.length} enriched YC startups.`);
```

***

### Use Cases

- **Venture Capital & Deal Flow**: Source high-velocity startups matching specific investment theses immediately upon batch announcements.
- **B2B Outbound Prospecting**: Target funded early-stage startups with direct founder LinkedIn contacts and corporate emails.
- **Talent & Recruitment Agencies**: Discover high-growth companies actively hiring engineering and product roles.

# Actor input Schema

## `searchQuery` (type: `string`):

Search by company name or description. Leave empty to fetch all YC companies.

## `batch` (type: `string`):

Filter by YC batch (e.g. W24, S23, F25). Leave empty for all batches.

## `status` (type: `string`):

Filter by status: Active, Acquired, Inactive, or Public.

## `industry` (type: `string`):

Filter by industry (e.g. Healthcare, Fintech, B2B). Leave empty for all.

## `region` (type: `string`):

Filter by region (e.g. United States, Europe). Leave empty for all.

## `isHiring` (type: `boolean`):

Only include companies that are currently hiring.

## `tags` (type: `string`):

Filter by tag (e.g. Artificial Intelligence, SaaS).

## `isTopCompany` (type: `boolean`):

Only include YC top companies.

## `maxCompanies` (type: `integer`):

Maximum number of companies to fetch. Set to 0 for all 5,800+ companies.

## `enrichContacts` (type: `boolean`):

When enabled, crawls each startup's website and YC profile page for founder names, LinkedIn URLs, emails, phones, and social handles.

## `maxEnrichmentPages` (type: `integer`):

Number of pages to crawl per startup website for contact enrichment.

## Actor input object example

```json
{
  "isHiring": false,
  "isTopCompany": false,
  "maxCompanies": 100,
  "enrichContacts": true,
  "maxEnrichmentPages": 3
}
```

# Actor output Schema

## `results` (type: `string`):

Dataset containing YC startup profiles enriched with founder contacts, emails, phones, and social media handles.

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {};

// Run the Actor and wait for it to finish
const run = await client.actor("constant_hyssop/yc-startup-enricher").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {}

# Run the Actor and wait for it to finish
run = client.actor("constant_hyssop/yc-startup-enricher").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{}' |
apify call constant_hyssop/yc-startup-enricher --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,constant_hyssop/yc-startup-enricher"
        }
    }
}

```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/isGWc4KbIrN2NIGw2/builds/nuZ57tLaMNdXjzjlS/openapi.json
