> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scrape.st/llms.txt
> Use this file to discover all available pages before exploring further.

# Add Keywords

> Attach keyword filters to your API key

Adds keywords to the calling API key. Once at least one keyword is registered,
only events whose text contains a keyword (case-insensitive) are delivered to
this key; each delivered event gains a `keyword_matches` array listing the
keywords that hit. An API key with **no** keywords receives everything,
unfiltered.

Keywords are normalized: trimmed, lowercased, deduplicated. Limits: **100
keywords per API key**, **100 characters per keyword**.

## Request

<ParamField body="keywords" type="string[]" required>
  Keywords to add. Matching is a case-insensitive substring match against the
  event text (post text, message content, OCR-extracted image text).
</ParamField>

## Response

<ResponseField name="data" type="string[]">
  The full keyword list after the addition.
</ResponseField>

<ResponseField name="message" type="string">
  Status message describing the result
</ResponseField>

<RequestExample>
  ```bash theme={null}
  curl -X POST https://scrape.st/keywords \
    -H "x-api-key: YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
      "keywords": ["pepe", "airdrop"]
    }'
  ```
</RequestExample>

<ResponseExample>
  ```json theme={null}
  {
    "data": ["pepe", "airdrop"],
    "message": "Keywords added successfully"
  }
  ```
</ResponseExample>