# 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 "https://www.socialcrawl.dev/v1/prism/earliness?term=swerve%20app" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

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