# Product Hunt Lead Enricher (`runtime/product-hunt-lead-enricher`) Actor

Convert Product Hunt launches and product records into CRM-ready startup leads with domains, contacts, makers, traction signals, technologies, evidence, and lead scores.

- **URL**: https://apify.com/runtime/product-hunt-lead-enricher.md
- **Developed by:** [scraping automation](https://apify.com/runtime) (community)
- **Categories:** Lead generation, Business, Marketing
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per usage

This Actor is paid per platform usage. The Actor is free to use, and you only pay for the Apify platform usage, which gets cheaper the higher subscription plan you have.

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

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use 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

## Product Hunt Lead Enricher

Convert Product Hunt launch records into CRM-ready startup leads with domains, contacts, traction, and evidence.

### Who this is for
- Startup sales teams
- Investor research teams
- Partnership teams
- Growth teams

### What it helps you do
- Enrich Product Hunt launches into lead records
- Find company websites and domains
- Prioritize launches by traction and fit

### Inputs you can use
- Product Hunt product records or URLs
- Maximum leads
- Enrichment options

### Data you get
- company
- product
- domain
- website
- tagline
- upvotes
- maker links
- lead score
- source evidence

### How to get better results
- Start with a narrow, specific query or a small list of source URLs.
- Use realistic limits for the first run, then increase the volume once the output looks right.
- Keep source URLs, dates, and location context when you need repeatable market monitoring.
- Review a few sample records before connecting the dataset to a larger workflow.

### Notes
- Results depend on what the public source exposes at run time.
- Some pages may hide, delay, rename, or remove fields, so individual records can have partial data.
- Use the built-in output table to inspect results before exporting to spreadsheets, dashboards, or automation tools.

### Support
If a run returns unexpected data, open an issue from the Actor page with the input used, the run ID, and the result you expected.

# Actor input Schema

## `products` (type: `array`):

Product Hunt product records, for example items exported by Product Hunt Scraper. Each item can include name, tagline, productHuntUrl, companyWebsite, domainUrl, upvotes, makers, hunter, socialLinks, categories, and comments.
## `manualProducts` (type: `array`):

Alias for products, kept for bundles and examples.
## `manualPages` (type: `array`):

Optional HTML pages to parse instead of fetching live websites. Each item needs url and html.
## `includeWebsiteEnrichment` (type: `boolean`):

Fetch or parse company website pages to add emails, socials, technologies, and evidence.
## `includeExternalEmails` (type: `boolean`):

Include emails that do not match the company domain in the main emails field. Disabled by default to avoid saving sample or third-party emails as company contacts.
## `maxProducts` (type: `integer`):

Maximum number of Product Hunt products to enrich.
## `maxPagesPerDomain` (type: `integer`):

Maximum same-domain website pages to inspect per company domain.
## `requestTimeoutSecs` (type: `integer`):

HTTP request timeout in seconds.
## `failOnNoResults` (type: `boolean`):

Fail the run when no Product Hunt lead records are saved.
## `proxyConfiguration` (type: `object`):

Optional Apify Proxy configuration for website enrichment.

## Actor input object example

```json
{
  "products": [
    {
      "name": "Example AI",
      "tagline": "AI sales research for startup teams",
      "productHuntUrl": "https://www.producthunt.com/products/example-ai",
      "companyWebsite": "https://example.com",
      "upvotes": 420,
      "makerNames": [
        "Jane Doe"
      ],
      "hunterUsername": "startuphunter",
      "categories": [
        "Sales",
        "AI"
      ]
    }
  ],
  "manualProducts": [],
  "manualPages": [],
  "includeWebsiteEnrichment": true,
  "includeExternalEmails": false,
  "maxProducts": 25,
  "maxPagesPerDomain": 3,
  "requestTimeoutSecs": 25,
  "failOnNoResults": false,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
````

# Actor output Schema

## `leads` (type: `string`):

No description

## `contacts` (type: `string`):

No description

## `traction` (type: `string`):

No description

# 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 = {
    "products": [
        {
            "name": "Example AI",
            "tagline": "AI sales research for startup teams",
            "productHuntUrl": "https://www.producthunt.com/products/example-ai",
            "companyWebsite": "https://example.com",
            "upvotes": 420,
            "makerNames": [
                "Jane Doe"
            ],
            "hunterUsername": "startuphunter",
            "categories": [
                "Sales",
                "AI"
            ]
        }
    ],
    "manualProducts": [],
    "manualPages": []
};

// Run the Actor and wait for it to finish
const run = await client.actor("runtime/product-hunt-lead-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 = {
    "products": [{
            "name": "Example AI",
            "tagline": "AI sales research for startup teams",
            "productHuntUrl": "https://www.producthunt.com/products/example-ai",
            "companyWebsite": "https://example.com",
            "upvotes": 420,
            "makerNames": ["Jane Doe"],
            "hunterUsername": "startuphunter",
            "categories": [
                "Sales",
                "AI",
            ],
        }],
    "manualProducts": [],
    "manualPages": [],
}

# Run the Actor and wait for it to finish
run = client.actor("runtime/product-hunt-lead-enricher").call(run_input=run_input)

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

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

```

## CLI example

```bash
echo '{
  "products": [
    {
      "name": "Example AI",
      "tagline": "AI sales research for startup teams",
      "productHuntUrl": "https://www.producthunt.com/products/example-ai",
      "companyWebsite": "https://example.com",
      "upvotes": 420,
      "makerNames": [
        "Jane Doe"
      ],
      "hunterUsername": "startuphunter",
      "categories": [
        "Sales",
        "AI"
      ]
    }
  ],
  "manualProducts": [],
  "manualPages": []
}' |
apify call runtime/product-hunt-lead-enricher --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=runtime/product-hunt-lead-enricher",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Product Hunt Lead Enricher",
        "description": "Convert Product Hunt launches and product records into CRM-ready startup leads with domains, contacts, makers, traction signals, technologies, evidence, and lead scores.",
        "version": "0.1",
        "x-build-id": "W8beegmR6MlEKmw1F"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/runtime~product-hunt-lead-enricher/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-runtime-product-hunt-lead-enricher",
                "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/runtime~product-hunt-lead-enricher/runs": {
            "post": {
                "operationId": "runs-sync-runtime-product-hunt-lead-enricher",
                "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/runtime~product-hunt-lead-enricher/run-sync": {
            "post": {
                "operationId": "run-sync-runtime-product-hunt-lead-enricher",
                "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": {
                    "products": {
                        "title": "Product Hunt products",
                        "type": "array",
                        "description": "Product Hunt product records, for example items exported by Product Hunt Scraper. Each item can include name, tagline, productHuntUrl, companyWebsite, domainUrl, upvotes, makers, hunter, socialLinks, categories, and comments."
                    },
                    "manualProducts": {
                        "title": "Manual products",
                        "type": "array",
                        "description": "Alias for products, kept for bundles and examples."
                    },
                    "manualPages": {
                        "title": "Manual website pages",
                        "type": "array",
                        "description": "Optional HTML pages to parse instead of fetching live websites. Each item needs url and html."
                    },
                    "includeWebsiteEnrichment": {
                        "title": "Enrich company websites",
                        "type": "boolean",
                        "description": "Fetch or parse company website pages to add emails, socials, technologies, and evidence.",
                        "default": true
                    },
                    "includeExternalEmails": {
                        "title": "Include external emails",
                        "type": "boolean",
                        "description": "Include emails that do not match the company domain in the main emails field. Disabled by default to avoid saving sample or third-party emails as company contacts.",
                        "default": false
                    },
                    "maxProducts": {
                        "title": "Max products",
                        "minimum": 1,
                        "maximum": 1000,
                        "type": "integer",
                        "description": "Maximum number of Product Hunt products to enrich.",
                        "default": 25
                    },
                    "maxPagesPerDomain": {
                        "title": "Max pages per domain",
                        "minimum": 1,
                        "maximum": 10,
                        "type": "integer",
                        "description": "Maximum same-domain website pages to inspect per company domain.",
                        "default": 3
                    },
                    "requestTimeoutSecs": {
                        "title": "Request timeout",
                        "minimum": 5,
                        "maximum": 120,
                        "type": "integer",
                        "description": "HTTP request timeout in seconds.",
                        "default": 25
                    },
                    "failOnNoResults": {
                        "title": "Fail if no leads are saved",
                        "type": "boolean",
                        "description": "Fail the run when no Product Hunt lead records are saved.",
                        "default": false
                    },
                    "proxyConfiguration": {
                        "title": "Proxy configuration",
                        "type": "object",
                        "description": "Optional Apify Proxy configuration for website enrichment.",
                        "default": {
                            "useApifyProxy": false
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
