# Product Hunt Launch Enrichment Monitor (`isotonic/product-hunt-launch-enrichment-monitor`) Actor

Monitors Product Hunt launches and enriches each visible launch with public website, pricing, contact, social, and outreach signal data.

- **URL**: https://apify.com/isotonic/product-hunt-launch-enrichment-monitor.md
- **Developed by:** [Brian Keefe](https://apify.com/isotonic) (community)
- **Categories:** Business, Lead generation, Automation
- **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 Launch Enrichment Monitor

Production-ready Apify Actor for startup scouts, agencies, VC analysts, recruiters, and B2B vendors who want structured launch rows from public Product Hunt pages plus light website enrichment from the launched product's own public site.

The actor uses only public HTML pages:
- Product Hunt public pages when available
- The product website homepage and common pricing/contact/about/team pages
- No login
- No private APIs
- No anti-bot bypass behavior

### What It Produces

One dataset row per launch with visible product and company signals:
- `name`
- `tagline`
- `topics`
- `website`
- `pricingUrl`
- `contactLinks`
- `socialLinks`
- `launchUrl`
- `launchDate`
- `upvotesVisible`
- `commentsVisible`
- `makers`
- `pitchTriggers`
- `warnings`

If Product Hunt blocks requests or its HTML changes, the actor returns warning rows instead of crashing.

### Input

Use either:
- `date`
- `startDate` + `endDate`
- `productUrls`

Optional filters:
- `category`
- `query`

Example:

```json
{
  "date": "2026-06-30",
  "category": "Sales",
  "query": "signal",
  "productUrls": [
    { "url": "https://www.producthunt.com/posts/signalpad" }
  ],
  "maxLaunches": 10,
  "enrichWebsite": true,
  "requestTimeoutSecs": 20
}
````

See `examples/sample-input.json`.

### Output Example

```json
[
  {
    "name": "SignalPad",
    "tagline": "AI buyer signal tracking for GTM teams",
    "topics": ["Sales", "Analytics"],
    "website": "https://signalpad.test/",
    "pricingUrl": "https://signalpad.test/pricing",
    "contactLinks": [
      "mailto:founders@signalpad.test",
      "https://signalpad.test/contact"
    ],
    "socialLinks": {
      "linkedin": ["https://www.linkedin.com/company/signalpad"],
      "x": ["https://x.com/signalpad"],
      "twitter": [],
      "facebook": [],
      "instagram": [],
      "youtube": [],
      "tiktok": [],
      "github": []
    },
    "launchUrl": "https://www.producthunt.com/posts/signalpad",
    "launchDate": null,
    "upvotesVisible": 412,
    "commentsVisible": 38,
    "makers": ["Alex Kim", "Priya Shah"],
    "pitchTriggers": [
      "Pricing page is public for packaging and competitor analysis",
      "Direct email contact was exposed publicly"
    ],
    "warnings": []
  }
]
```

See `examples/sample-output.json`.

### Commercial Use Cases

- Track launches in a category and identify companies with accessible pricing and contact paths
- Build founder/vendor prospecting lists from recent launches
- Support VC scouting with structured launch, topic, maker, and website signals
- Prepare outbound campaigns using public contact and social evidence only

### Extraction Approach

- Parses Product Hunt leaderboard/day pages for launch URLs
- Parses Product Hunt product pages for visible title, tagline, topics, makers, website, and visible engagement counters
- Optionally enriches the product website for public pricing/contact/social links
- Generates `pitchTriggers` from public commercial signals

### Limitations

- Product Hunt HTML can change without notice
- Some launches may not expose a website or visible maker names
- JavaScript-heavy sites may hide links from simple HTML fetches
- `upvotesVisible` and `commentsVisible` are extracted only when visible in fetched HTML
- This actor intentionally avoids private APIs, login flows, and bypass behavior

### Local Development

Install:

```bash
npm install
```

Run tests:

```bash
npm test
```

Run deterministic smoke:

```bash
npm run smoke
```

Run locally with Apify storage:

```bash
npm start
```

### Apify Commands

Run through Apify CLI:

```bash
npx --yes apify-cli run
```

Push after authentication:

```bash
export APIFY_TOKEN=<your Apify API token>
npx --yes apify-cli push
```

### Deterministic Validation

Tests and smoke do not depend on live Product Hunt. They use local HTML fixtures and mocked fetch responses stored under `tests/fixtures`.

# Actor input Schema

## `date` (type: `string`):

Process a single Product Hunt daily leaderboard date in YYYY-MM-DD format.

## `startDate` (type: `string`):

Start of launch date range in YYYY-MM-DD format. Runtime validation handles exclusivity with `date`.

## `endDate` (type: `string`):

End of launch date range in YYYY-MM-DD format. Runtime validation handles exclusivity with `date`.

## `category` (type: `string`):

Optional topic/category filter matched against visible Product Hunt topics.

## `query` (type: `string`):

Optional keyword filter matched against launch name, tagline, and visible topics.

## `productUrls` (type: `array`):

Optional list of Product Hunt product pages to enrich directly.

## `maxLaunches` (type: `integer`):

Maximum number of launches to process after filtering.

## `enrichWebsite` (type: `boolean`):

When enabled, the actor visits the visible website and common pricing/contact pages to extract public links.

## `requestTimeoutSecs` (type: `integer`):

HTTP timeout per page request.

## Actor input object example

```json
{
  "date": "2026-06-30",
  "category": "Sales",
  "query": "signal",
  "maxLaunches": 20,
  "enrichWebsite": true,
  "requestTimeoutSecs": 20
}
```

# 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 = {
    "date": "2026-06-30",
    "category": "Sales",
    "query": "signal"
};

// Run the Actor and wait for it to finish
const run = await client.actor("isotonic/product-hunt-launch-enrichment-monitor").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 = {
    "date": "2026-06-30",
    "category": "Sales",
    "query": "signal",
}

# Run the Actor and wait for it to finish
run = client.actor("isotonic/product-hunt-launch-enrichment-monitor").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 '{
  "date": "2026-06-30",
  "category": "Sales",
  "query": "signal"
}' |
apify call isotonic/product-hunt-launch-enrichment-monitor --silent --output-dataset

```

## MCP server setup

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

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Product Hunt Launch Enrichment Monitor",
        "description": "Monitors Product Hunt launches and enriches each visible launch with public website, pricing, contact, social, and outreach signal data.",
        "version": "0.1",
        "x-build-id": "qatQQ75nWaFNk6And"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/isotonic~product-hunt-launch-enrichment-monitor/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-isotonic-product-hunt-launch-enrichment-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/isotonic~product-hunt-launch-enrichment-monitor/runs": {
            "post": {
                "operationId": "runs-sync-isotonic-product-hunt-launch-enrichment-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/isotonic~product-hunt-launch-enrichment-monitor/run-sync": {
            "post": {
                "operationId": "run-sync-isotonic-product-hunt-launch-enrichment-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",
                "properties": {
                    "date": {
                        "title": "Single launch date",
                        "type": "string",
                        "description": "Process a single Product Hunt daily leaderboard date in YYYY-MM-DD format."
                    },
                    "startDate": {
                        "title": "Start date",
                        "type": "string",
                        "description": "Start of launch date range in YYYY-MM-DD format. Runtime validation handles exclusivity with `date`."
                    },
                    "endDate": {
                        "title": "End date",
                        "type": "string",
                        "description": "End of launch date range in YYYY-MM-DD format. Runtime validation handles exclusivity with `date`."
                    },
                    "category": {
                        "title": "Category or topic filter",
                        "type": "string",
                        "description": "Optional topic/category filter matched against visible Product Hunt topics."
                    },
                    "query": {
                        "title": "Keyword query",
                        "type": "string",
                        "description": "Optional keyword filter matched against launch name, tagline, and visible topics."
                    },
                    "productUrls": {
                        "title": "Specific Product Hunt product URLs",
                        "type": "array",
                        "description": "Optional list of Product Hunt product pages to enrich directly.",
                        "items": {
                            "type": "object",
                            "properties": {
                                "url": {
                                    "title": "Product Hunt URL",
                                    "description": "Public Product Hunt product page URL, for example https://www.producthunt.com/posts/example.",
                                    "type": "string"
                                }
                            }
                        }
                    },
                    "maxLaunches": {
                        "title": "Max launches",
                        "minimum": 1,
                        "maximum": 200,
                        "type": "integer",
                        "description": "Maximum number of launches to process after filtering.",
                        "default": 20
                    },
                    "enrichWebsite": {
                        "title": "Enrich product website",
                        "type": "boolean",
                        "description": "When enabled, the actor visits the visible website and common pricing/contact pages to extract public links.",
                        "default": true
                    },
                    "requestTimeoutSecs": {
                        "title": "Request timeout seconds",
                        "minimum": 5,
                        "maximum": 120,
                        "type": "integer",
                        "description": "HTTP timeout per page request.",
                        "default": 20
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
