Skip to main content

Get Social Signals Lead

GET 
/signals/leads/:id

Returns a single Social Signals lead belonging to the authenticated brand, including recent engagement history. The engagements array is always present and contains up to the 20 most recent engagements, ordered newest-first by trackedAt (descending). Unlike the list endpoint, no includeEngagements flag is required and no engagementsMeta is returned.

The array is a bounded window, not a full history: a lead with more than 20 engagements returns only its 20 most recent, and there is no way to page past them. Upsert by engagement id and treat an absent engagement as aged out of the window rather than deleted.

Changed 2026-07-28: this endpoint previously returned the oldest 20 engagements in storage order. See Versioning & Breaking Changes for migration guidance.

Data notice: Responses contain PII (names, LinkedIn URLs, profile images, and engagement metadata). See the Data Handling & Privacy section for required safeguards.

Brand ownership is enforced server-side. If the lead does not belong to the authenticated brand, the API returns 404.

Request​

Responses​

Social Signals lead retrieved successfully

Response Headers
    X-RateLimit-Limit

    The maximum number of requests allowed per minute

    X-RateLimit-Remaining

    The number of requests remaining in the current window

    X-RateLimit-Reset

    Unix timestamp when the rate limit window resets