# Prism Earliness API (https://www.socialcrawl.dev/platforms/prism/earliness)

> Pass term, and an optional region. The response gives the earliest relevant post date on TikTok, X, Reddit, YouTube, and Instagram, the first non-zero Google Trends point, and whether an ad for the term is already in the TikTok or Meta library. Gaps are in days. A page whose oldest row is still within 30 days, and which did not reach the start of the index, is marked censored: first seen before that date, not a first-seen date. A different subject that shares the words is not counted. Ads that are not about the term do not make it late. The price is provisional.

TL;DR: `GET /v1/prism/earliness` costs 25 credits (provisional). One date-sorted page per platform, Google Trends over five years, and one page of the TikTok and Meta ad libraries. A lane that does not answer is listed and is not a first-seen date. and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `term` | yes | The phrase, sound title, hashtag, or trend name to date. |
| `region` | no | Optional country code passed to the lanes that accept one, such as US. |

## Code example

```bash
curl -G "https://www.socialcrawl.dev/v1/prism/earliness" \
  --data-urlencode "term=swerve app" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What does the Prism Earliness API return?

Returns the first relevant post date per platform for one term, when Trends started, whether ads exist, and the gap in days. The response uses the same JSON envelope as every SocialCrawl endpoint, with the data, credits_used and request_id fields.

### When should I use the Prism Earliness endpoint?

Use it to see whether a term appeared before search trends and before ads. A different subject that shares the words is not the first sighting.

### How much does the Prism Earliness API cost?

Each call costs 25 credits, so the 100 free credits every new account gets cover 4 calls. Credits for failed or empty calls are refunded automatically, and there is no subscription.

### What parameters does the Prism Earliness API need?

The one required parameter is term (the phrase, sound title, hashtag, or trend name to date). It also accepts 1 optional parameter, listed on this page. The optional parameter to try first is region (Results for one market).

### How do I call the Prism Earliness API?

Send a GET request to https://www.socialcrawl.dev/v1/prism/earliness?term=swerve%20app with your API key in the x-api-key header. An Authorization: Bearer header works too.

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 does the SocialCrawl Prism Earliness API return?
- How do I get Prism Earliness data with the SocialCrawl API?