> ## Documentation Index
> Fetch the complete documentation index at: https://reach-owl.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# GET /api/v1/mentions — List Keyword Monitors

> Returns keyword mention monitors for your team. Each monitor watches Facebook groups for posts containing specified keywords.

List all keyword mention monitors, or fetch details for a single monitor. You can also list the posts that matched a specific monitor.

## Query parameters

<ParamField query="team_id" type="integer" required>
  The ID of the team whose mention monitors you want to list.
</ParamField>

## List monitors

```bash theme={null}
curl -X GET "https://reachowl.com/api/v1/mentions?team_id=1" \
  -H "Authorization: Bearer YOUR_TOKEN"
```

## Get a single monitor

Fetch details for a specific mention monitor by its ID.

```bash theme={null}
curl -X GET "https://reachowl.com/api/v1/mentions/88" \
  -H "Authorization: Bearer YOUR_TOKEN"
```

## List matched posts

Retrieve the posts that matched a specific keyword monitor.

```bash theme={null}
curl -X GET "https://reachowl.com/api/v1/mentions/posts?mention_id=88" \
  -H "Authorization: Bearer YOUR_TOKEN"
```

## Example response (list)

```json theme={null}
{
  "data": [
    {
      "id": 88,
      "team_id": 1,
      "type": "facebook_groups",
      "keywords": ["SaaS", "growth"],
      "groups": [12, 34, 56],
      "status": 1
    }
  ]
}
```

<ResponseField name="data" type="array">
  List of keyword mention monitors.
</ResponseField>

<ResponseField name="id" type="integer">
  Unique identifier of the monitor.
</ResponseField>

<ResponseField name="keywords" type="array">
  Keywords the monitor watches for in posts.
</ResponseField>

<ResponseField name="groups" type="array">
  Group IDs the monitor is scoped to.
</ResponseField>

<ResponseField name="status" type="integer">
  Status of the monitor: `1` is active, `0` is disabled.
</ResponseField>