Skip to main content
GET
/
api
/
v1
/
monitors
/
{id}
/
events
List monitor events
curl --request GET \
  --url https://developer.thehog.ai/api/v1/monitors/{id}/events \
  --header 'X-Access-Key: <api-key>' \
  --header 'X-Secret-Key: <api-key>'
{
  "data": [
    {
      "id": "<string>",
      "monitor_id": "<string>",
      "dedup_key": "<string>",
      "event_type": "<string>",
      "event_json": {},
      "canonical_person_id": "<string>",
      "canonical_company_id": "<string>",
      "detected_at": "<string>"
    }
  ],
  "next_cursor": "<string>"
}

​
GET /api/v1/monitors/:id/events

List events detected by a monitor.
Retrieve events (posts, mentions, profile changes) detected by a monitor.

​
Example

curl https://developer.thehog.ai/api/v1/monitors/mon_01HZXYZ/events?limit=10 \
  -H "X-Access-Key: ak_xxxxxxxxxxxxxxxx" \
  -H "X-Secret-Key: sk_xxxxxxxxxxxxxxxx"

Authorizations

​
X-Access-Key
string
header
required

The public API key from the Credentials page.

​
X-Secret-Key
string
header
required

The API secret shown when the credential is created.

Path Parameters

​
id
string
required

Monitor ID.

Query Parameters

​
limit
number

Response

Monitor events with pagination.

​
data
object[]
required
​
next_cursor
string | null
required