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

team_id · integer · required

The ID of the team whose mention monitors you want to list.

List monitors

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.

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.

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

Example response (list)

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

data · array

List of keyword mention monitors.

id · integer

Unique identifier of the monitor.

keywords · array

Keywords the monitor watches for in posts.

groups · array

Group IDs the monitor is scoped to.

status · integer

Status of the monitor: 1 is active, 0 is disabled.