# Prism Launch Echo API (https://www.socialcrawl.dev/platforms/prism/launch-echo)

> Runs a Hacker News search, digs the top threads' comments, and pulls the dev-blog web echo (content_analysis), with an optional GitHub repo/dossier (explicit `repo=` or auto-resolved from the HN/web hits), folded into a launch-reception snapshot with computed attention + echo + a methodology_version. Comment legs are the coverage spine (<0.5 → 50% refund); a dead HN search → full refund.

TL;DR: `GET /v1/prism/launch-echo` costs 20 credits per call and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `query` | yes | The launch/product name to measure reception for. |
| `repo` | no | Optional owner/repo or github URL to anchor the dossier. |
| `threads` | no | How many top HN threads to dig comments for. |
| `date_from` | no | Window start (YYYY-MM-DD). |
| `date_to` | no | Window end (YYYY-MM-DD). |
| `include` | no | CSV subset toggling the comments/blogs/dossier legs. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/prism/launch-echo?query=Bun%201.2" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What is the SocialCrawl Product Launch Tracking API (Prism Launch Echo)?

GET /v1/prism/launch-echo takes a query and returns how a launch landed: the Hacker News reaction with top threads and comments, a dev-blog echo, and an optional GitHub repo dossier, folded into one response. One call replaces querying HN, blogs, and GitHub and merging them yourself.

### What does the threads parameter control?

threads sets how many top Hacker News threads to pull, and each comes back with its top comments, so you read the actual reaction, not just headlines. Pass repo to attach a GitHub repo dossier for the launched project.

### Can I bound the launch window?

Yes. Pass date_from and date_to to scope the Hacker News and dev-blog legs to the launch period, and use include to toggle which legs run. query is the only required parameter.

### How much does a launch-echo call cost?

Each call is a flat 20 credits covering the Hacker News, dev-blog, and optional repo legs. New accounts get 100 free credits with no credit card. If a strict majority of the legs fail, part of the cost is refunded automatically, and if all legs fail the full 20 credits come back.

### Why use launch-echo instead of scraping Hacker News myself?

One call replaces the HN thread-and-comment pull, dev-blog search, and GitHub lookup plus the folding you would write to combine them. It returns one reaction view of a launch across comment threads, press, and code, so you gauge reception without maintaining scrapers.

See the full Prism API: https://www.socialcrawl.dev/platforms/prism

## Pricing

- Standard endpoints: 1 credit per call
- Advanced endpoints: 5 credits per call
- Premium endpoints: 10 credits per call
- 100 free credits on signup, no credit card required. Cached responses cost 0 credits. Credit packs never expire.
- Full pricing: https://www.socialcrawl.dev/pricing

## Explore with AI

Questions this API answers, phrased for an AI assistant:

- How do I track how a product launch landed on Hacker News in one API call?
- What API returns Hacker News threads and comments plus dev-blog coverage for a launch?
- product launch monitoring API for Hacker News and dev blogs