# Prism Adverse Screen API (https://www.socialcrawl.dev/platforms/prism/adverse-screen)

> Reads the recent public posts of a person's own profiles (one per platform: `linkedin`, `twitter`, `facebook`, `instagram`, `threads`, `tiktok`, each a handle or a profile URL) and asks, post by post, whether the author engages in, admits, threatens or promotes each category you screen for: `fraud_or_financial_crime`, `violence_or_threats`, `hate_or_harassment`, `drugs`, `sanctions_or_terror_links`, `sexual_misconduct`, `reputational_other` (default: all). A separate check keeps posts that report, quote, warn about or condemn what someone else did (news, a scam warning) from counting as the author's conduct, and a severity level (1 minor, 2 serious, 3 severe) is given for every flagged post. Every entry of `flags` cites its post (`platform`, `post_id`, `url`, `published_at`, an `excerpt`) with the probability for each requested category; `category_counts` counts flagged and uncertain posts per category; `requires_review` is true when any post is flagged. With `name` (and optionally `employer`, `city`), each profile is first checked against the named person: only profiles judged to be the person's own are screened, the rest are listed in `profiles` with the identity verdict and are not screened (`screen_unconfirmed=true` screens possible matches too, never a profile judged to be someone else). These are automated labels for a human reviewer, not a decision: there is no summary, verdict or score about the person, and political opinion, religion, health, sexuality and other personal characteristics are never screened. Public posts only; private accounts return nothing. `screen_complete` is false when a profile or a post could not be screened, and `_warnings` says why.

TL;DR: `GET /v1/prism/adverse-screen` costs 25 credits for one profile, plus 10 for each further profile (4 profiles cost 55). Profiles that could not be screened are refunded their share, and a call that screened nothing keeps 5 and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `linkedin` | no | LinkedIn profile URL (linkedin.com/in/...) or the profile slug. |
| `twitter` | no | X (Twitter) handle or profile URL. |
| `facebook` | no | Facebook profile or page URL, or its username. |
| `instagram` | no | Instagram handle or profile URL. |
| `threads` | no | Threads handle or profile URL. |
| `tiktok` | no | TikTok handle or profile URL. |
| `name` | no | The person's full name. When set, each profile is checked against it before screening. |
| `employer` | no | Optional current employer, used only for the identity check. |
| `city` | no | Optional city or country, used only for the identity check. |
| `categories` | no | Comma-separated subset of fraud_or_financial_crime, violence_or_threats, hate_or_harassment, drugs, sanctions_or_terror_links, sexual_misconduct, reputational_other. Default: all. An unknown member is a 400. |
| `since` | no | Only screen posts published on or after this date (YYYY-MM-DD). |
| `limit` | no | Most recent posts screened per profile, 1 to 100 (default 50). One timeline page is read per profile. |
| `screen_unconfirmed` | no | Set true to also screen profiles whose identity is possible or could not be judged. Profiles judged to be someone else are never screened. |

## Code example

```bash
curl "https://www.socialcrawl.dev/v1/prism/adverse-screen?twitter=elonmusk" \
  -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