# Prism Earned Media API (https://www.socialcrawl.dev/platforms/prism/earned-media)

> Fans out content_analysis news search, a Hacker News leg, and a fresh-web news leg in parallel, then dedupes and ranks them into one earned-media clip feed with computed top outlets, freshness labeling (content_analysis fetch_time lags the live web), and (when a `competitor` is supplied) a coverage gap. Each clipping also carries a judged `mention` label (is it about this brand, or a name collision), and `computed.clipping_count_about_brand`, `top_outlets_about_brand` and `coverage_gap_about_brand` repeat those numbers without the clippings judged to be about something else; the original numbers are unchanged. The content_analysis news leg is the coverage spine (losing it → 50% refund); Hacker News and the fresh-web leg are enrichment. `include=digest` adds an LLM narrative summary leg.

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

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `brand` | yes | The brand/company to map earned media for. |
| `competitor` | no | Optional competitor for a share-of-coverage gap. |
| `date_from` | no | Window start (YYYY-MM-DD). |
| `date_to` | no | Window end (YYYY-MM-DD). |
| `min_domain_rank` | no | Drop clips from sites below this domain authority. |
| `include` | no | Set `digest` to add an LLM narrative summary. |
| `brand_description` | no | Optional one-line description of the brand, used to tell it apart from other things with the same name. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/prism/earned-media" \
  --data-urlencode "brand=Vercel" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What is the SocialCrawl Earned Media API (Prism Earned Media)?

GET /v1/prism/earned-media takes a brand and returns its earned-media footprint: news, tech-press, and fresh-web clips deduped and ranked into one list, with an outlet-coverage rollup showing which publications covered it. One call replaces querying several news and web sources and merging them yourself.

### What can I filter the coverage by?

brand is required. Pass competitor to benchmark share of coverage, date_from and date_to to bound the window, and min_domain_rank to drop low-authority sites and keep credible outlets. include toggles which source legs run.

### What is the outlet-coverage rollup?

It groups the deduped clips by publication, so you see which outlets covered the brand and how often, rather than a flat article list. That turns raw mentions into a coverage map you can hand to a PR or comms team.

### How much does an earned-media call cost?

Each call is a flat 25 credits covering the news, tech-press, and web legs plus dedupe and the rollup. 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 25 credits come back.

### Why use earned-media instead of stitching news APIs together?

One call replaces several news and web queries plus the dedupe, ranking, and grouping you would write to combine them. It returns a deduped, outlet-grouped view of who is covering a brand, so you track press pickup without maintaining multiple integrations.

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 pull a brand's press and news coverage in one API call?
- What API returns earned media coverage with an outlet rollup?
- media monitoring API for news and tech-press coverage of a brand