# Prism Campaign API (https://www.socialcrawl.dev/platforms/prism/campaign)

> Fans out to content_analysis phrase-trends (pre/during/post windows), search/everywhere (consuming items_by_source for real per-platform engagement, not the capped fused items), and tiktok/youtube search for amplifier discovery, then folds them into a lift report (volume lift %, sustained-floor check, ranked amplifiers). YouTube amplifiers are undated in fusion — pass include=amplifier_dates to date the top ones via direct youtube/video calls. Supply hashtag OR phrase plus window_start; window_end defaults to today. legs[] reports each leg; losing the CA timeline or the everywhere engagement spine refunds half. Flat 35 credits.

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

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `hashtag` | no | The campaign hashtag (with or without #). One of hashtag or phrase is required. |
| `phrase` | no | A campaign slogan/phrase instead of a hashtag. One of hashtag or phrase is required. |
| `window_start` | no | Campaign launch date (YYYY-MM-DD) — the pre/during boundary. Optional; defaults to 30 days ago. |
| `window_end` | no | Campaign end date (YYYY-MM-DD) — the during/post boundary. Defaults to today. |
| `pre_days` | no | Baseline days before window_start for lift measurement (1-90, default 14). |
| `post_days` | no | Days after window_end for the post window (0-90, default 14; 0 = no post window). |
| `include` | no | Set amplifier_dates to date YouTube amplifiers via direct youtube/video calls (undated in fusion). |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/prism/campaign" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What is the SocialCrawl Campaign API?

GET /v1/prism/campaign takes one hashtag or phrase and a launch window and returns the campaign's pre/during/post volume lift, a cross-platform engagement rollup, and a ranked list of the top amplifiers driving it — the unified campaign read no single search endpoint produces.

### How is the volume lift measured?

The timeline is tagged pre, during, and post against your window_start and window_end, then volume_lift_pct is the percent change in average daily volume from the pre baseline to the campaign window. A sustained flag tells you whether the post window held above the pre baseline.

### Does it use real per-platform engagement counts?

Yes. The platforms rollup is built from items_by_source — the real per-platform post counts and engagement from the universal search leg — not from a capped fused list, so the cross-platform spread reflects actual reach. Top amplifiers are deduped by URL and ranked by engagement.

### Why are YouTube amplifiers sometimes undated?

YouTube items are undated in the fused search results, so by default a YouTube amplifier carries date_source: undated_in_fusion. Pass include=amplifier_dates and the endpoint drills the top YouTube amplifiers with direct video calls to place them on the timeline with real dates.

### How much does a campaign call cost?

Each call is a flat 35 credits regardless of how many amplifiers you get back. New accounts get 100 free credits with no credit card. The content-analysis timeline and the universal search leg are the coverage spine — losing either refunds half; if both fail the full amount comes back.

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:

- What API measures hashtag campaign lift across platforms?
- How do I track a campaign's top amplifiers and engagement via API?
- best hashtag tracking API with pre during post volume lift