# Prism Demand Signals API (https://www.socialcrawl.dev/platforms/prism/demand-signals)

> Reads up to four consumer-demand axes in parallel — app-review velocity (the freshest public channel), web mention slope (content_analysis phrase-trends, a real stateless time-series), Reddit sort=new velocity, and Amazon review-count level — and fuses them into published demand-index inputs (never an opaque score; every weight, anchor, and observation window is disclosed). v1 is an honest one-shot level+slope: three of the four axes are point-in-time rates/levels whose true week-over-week deltas need a monitor (the methodology block names them). Supply google_play_id/app_store_id for the app-review axis. legs[] reports each leg status, cost, and latency; a strict-majority leg failure refunds half. Flat 30 credits.

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

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `keyword` | yes | The brand or product to nowcast. Drives the mention, Reddit, and Amazon legs. |
| `google_play_id` | no | Google Play package name (e.g. com.spotify.music) for the app-review velocity axis. |
| `app_store_id` | no | Apple App Store numeric id for the app-review velocity axis. |
| `signals` | no | CSV subset of app_reviews,mentions,reddit,commerce (default all). app_reviews is dropped when no app id is supplied. |
| `amazon_query` | no | Override the Amazon product-search term if it differs from the brand. |
| `country` | no | Location for the app-review legs (default United States); a 2-letter code is also applied to the Amazon leg. |
| `date_from` | no | Window start (YYYY-MM-DD) for the mention-slope leg. Defaults to 30 days ago. |
| `date_to` | no | Window end (YYYY-MM-DD). Defaults to today. |
| `depth` | no | Reviews per store for the velocity computation (1-600, default 150). |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/prism/demand-signals?keyword=spotify" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What is the SocialCrawl Demand Signals API?

GET /v1/prism/demand-signals takes one brand and returns four consumer-demand axes in one call — app-review velocity, web mention slope, Reddit posting velocity, and Amazon review-count level — fused into a published, deterministic demand index. Alt-data desks normally assemble this from four separate vendors.

### How is the demand index calculated?

Every input is deterministic and disclosed — there is no opaque score and no LLM in the number. demand_index_inputs returns the raw app-review velocity, an OLS mention slope on a 7-day rolling mean, Reddit posts per day, and the Amazon review level, each blended with published weights and normalization anchors you can see and override.

### Is the demand index a real week-over-week velocity?

It is an honest one-shot nowcast, and the response says so with is_one_shot: true. The mention slope is a real stateless trend, but app-review velocity, Reddit velocity, and the commerce level are point-in-time rates that become true deltas only when you wrap the recipe in a monitor that stores snapshots.

### Do I need an app store ID to use it?

No. Supply google_play_id or app_store_id to add the app-review velocity axis — the freshest public demand channel — and the call uses it. Without an app id the app_reviews axis is dropped gracefully and the other three signals still return; signals= lets you pick which axes to read.

### How much does a demand-signals call cost?

Each call is a flat 30 credits and reads the four axes in parallel. New accounts get 100 free credits with no credit card. If a strict majority of the requested axes fail, half the cost is refunded automatically; if every axis fails, the full 30 credits come 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 returns a consumer demand index from app reviews and social signals?
- How do I measure app-review velocity and demand for a brand via API?
- best alt-data API for app review and mention-based demand signals