# 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 -G "https://www.socialcrawl.dev/v1/prism/adverse-screen" \
  --data-urlencode "twitter=elonmusk" \
  -H "x-api-key: sc_YOUR_API_KEY"
```

## FAQ

### What does the Prism Adverse Screen API return?

Returns the posts on a person's own public profiles that need review, each citing its post with a probability per category and a severity level, plus counts per category. 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 Adverse Screen endpoint?

Use it in background or KYC screening to find adverse posts across a candidate's profiles without reading every post by hand. Your reviewer makes the call.

### How much does the Prism Adverse Screen API cost?

The price depends on the request, from 25 to 75 credits per call. Every new account gets 100 free credits. Credits for failed or empty calls are refunded automatically, and there is no subscription.

### What parameters does the Prism Adverse Screen API need?

Identify the target with one of linkedin, twitter, facebook, instagram, threads, tiktok. It also accepts 13 optional parameters, all listed on this page.

### How do I call the Prism Adverse Screen API?

Send a GET request to https://www.socialcrawl.dev/v1/prism/adverse-screen?twitter=elonmusk 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 Adverse Screen API return?
- How do I get Prism Adverse Screen data with the SocialCrawl API?