Skip to main content
POST
/
public
/
v1
/
activity-feed
General activity feed
curl --request POST \
  --url http://app.stairoids.com/api/public/v1/activity-feed \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "startDate": 0,
  "endDate": 0,
  "signalTypes": [
    "<string>"
  ],
  "limit": 500,
  "icpOnly": false
}
'
[
  {
    "id": 991234,
    "signalType": "COMPANY_VISIT_WEBSITE",
    "causeId": "<string>",
    "causeType": "PAGE_VISIT",
    "weightOverride": 123,
    "timestamp": 1719500000000,
    "entityId": "4521",
    "entityType": "COMPANY",
    "owner": {
      "id": 30,
      "name": "Stairoids",
      "firstName": "Thomas",
      "lastName": "Berrens",
      "profilePicture": "<string>"
    },
    "channel": "website",
    "name": "Visited page: Pricing",
    "description": "<string>",
    "logo": "<string>",
    "useIcon": false
  }
]

Authorizations

​
X-Api-Key
string
header
required

Your organization's public API key. Manage it at GET /api/user/public-api-key.

Body

application/json

Filter for the general activity feed.

​
startDate
integer<int64>

Window start, epoch millis. Omit or 0 = a 90-day window before endDate.

Example:

0

​
endDate
integer<int64>

Window end, epoch millis. Omit or 0 = now.

Example:

0

​
signalTypes
string[]

Restrict to these signal types (codes from GET /signal-types). Empty = all types.

Restrict to these signal types (codes from GET /signal-types). Empty = all types.

​
limit
integer<int32>
default:500

Max signals to return. Default 500, ceiling 1000. The time window is the primary bound; narrow startDate/endDate to page through more.

Example:

500

​
icpOnly
boolean
default:false

Limit to companies that match one of your ICPs.

Example:

false

Response

OK

​
id
integer<int64>

Lead-score value id. Pass this as leadScoreId to POST /lead-score-details.

Example:

991234

​
signalType
string

Signal type.

Example:

"COMPANY_VISIT_WEBSITE"

​
causeId
string

Id of the underlying cause (e.g. a page-visit id, a like urn).

​
causeType
string

Type of the underlying cause.

Example:

"PAGE_VISIT"

​
weightOverride
integer<int32> | null

Manual weight override for this signal, if any.

​
timestamp
integer<int64>

When the signal occurred, epoch millis.

Example:

1719500000000

​
entityId
string

The entity the signal is about — a company id or a person public identifier.

Example:

"4521"

​
entityType
enum<string>

Whether the entity is a company or a person.

Available options:
COMPANY,
PERSON
Example:

"COMPANY"

​
owner
object

The user who owns this resource (id, name, avatar — no email).

​
channel
string

Higher-level channel the signal belongs to.

Example:

"website"

​
name
string

Human-readable headline for the signal.

Example:

"Visited page: Pricing"

​
description
string

Longer description of the signal, if any.

Icon/logo URL for the signal, if any.

​
useIcon
boolean

Whether the logo should render as an icon.

Example:

false