# Prism Store Author or Exclude List API (https://www.socialcrawl.dev/platforms/prism/discover-inputs)

> Stores a list of up to 10,000 author handles and returns `author_list_id`, which `prism/discover` accepts in place of a long `authors` list that would not fit in a URL. POST a JSON body `{ "kind": "authors", "authors": ["handle", "@handle", "https://x.com/handle", "twitter:handle"] }`. A bare handle matches on any platform; a `platform:handle` entry only on that platform. The list is encrypted at rest, belongs to your account only, and expires after 30 days. Each account can hold 20 lists at once. With `{ "kind": "exclude", "exclude": ["rd_0123456789ab", "https://www.reddit.com/r/.../comments/...", "reddit:handle"] }` it stores up to 50,000 evidence ids, post URLs or account keys you already hold and returns `exclude_list_id`: `prism/discover` never returns a row it names, from any API key of your account. An exclude list expires 30 days after it was stored, or 31 days after the last run that read it, and counts toward the same 20 lists. Only author and exclude lists are stored here: send `context` and `questions` in the body of `POST /v1/prism/discover`. Free.

TL;DR: `POST /v1/prism/discover/inputs` costs Free. and returns SocialCrawl's unified JSON schema. Single x-api-key auth, 100 free credits on signup.

## Parameters

| Parameter | Required | Description |
| --- | --- | --- |
| `kind` | yes | "authors" or "exclude". |
| `authors` | no | With kind authors: JSON array of 1 to 10,000 handles (each at most 100 characters): bare handles, @handles, profile URLs or platform:handle account keys. |
| `exclude` | no | With kind exclude: JSON array of 1 to 50,000 evidence ids, post URLs or account keys (each at most 200 characters), in a body under 4,000,000 bytes. |

## Code example

```bash
curl -X POST "https://www.socialcrawl.dev/v1/prism/discover/inputs" \
  -H "x-api-key: sc_YOUR_API_KEY" \
  -H "content-type: application/json" \
  -d '{"kind":"authors"}'
```

## FAQ

### What does the Prism Store Author or Exclude List API return?

Creates a list of up to 10,000 author handles (author_list_id) or 50,000 post ids, URLs or account keys to exclude (exclude_list_id), and returns its id, item count and expiry, free. 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 Store Author or Exclude List endpoint?

Use it when the list of authors to keep, or of posts you already hold, is too long for a URL; pass the returned id as author_list_id or exclude_list_id to prism/discover.

### How much does the Prism Store Author or Exclude List API cost?

This endpoint is free to call and uses no credits. Every new account still gets 100 free credits for the paid endpoints. Credits for failed or empty calls are refunded automatically, and there is no subscription.

### What parameters does the Prism Store Author or Exclude List API need?

The one required parameter is kind ("authors" or "exclude"). It also accepts 2 optional parameters, all listed on this page.

### How do I call the Prism Store Author or Exclude List API?

Send a POST request to https://www.socialcrawl.dev/v1/prism/discover/inputs with a JSON body and 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 Store Author or Exclude List API return?
- How do I get Prism Store Author or Exclude List data with the SocialCrawl API?