curl --request POST \
--url 'https://api.plyne.ai/v1/signals/leads' \
--header 'Authorization: Bearer plyne_...' \
--header 'Content-Type: application/json' \
--data '{
"signals": ["topic_engagement_signal"],
"sheet_ids": ["sh_6P9vR3"],
"lead_country_codes": ["US"],
"company_country_codes": ["US"],
"latest_signal": {
"start_time": "2026-06-01T00:00:00Z",
"end_time": "2026-07-01T00:00:00Z"
},
"sort": { "field": "date_found", "direction": "SORT_DIRECTION_DESC" },
"cursor": { "limit": 100 }
}'
{
"data": [
{
"id": "ld_8K2mQ9",
"full_name": "Sarah Carter",
"title": "Head of Engineering",
"country_code": "US",
"profile": {
"platform": "linkedin",
"url": "https://linkedin.com/in/sarah-carter"
},
"company": {
"id": "co_4F7xN2",
"name": "Acme",
"domain": "acme.com",
"linkedin_url": "https://linkedin.com/company/acme",
"country_code": "US"
},
"sheet": {
"id": "sh_6P9vR3",
"name": "AI infrastructure buyers"
},
"signal": {
"type": "topic_engagement_signal",
"name": "Post Engagers",
"summary": "Engaged with relevant topic content recently",
"reason": "Sarah engaged with content related to cloud infrastructure modernization.",
"observed_at": "2026-06-15T08:00:00Z"
},
"qualification": {
"status": "qualified",
"reason": "Strong ICP fit based on seniority, role, company profile, and recent intent.",
"reasoning": "The lead matches the target persona and ICP criteria. Head of Engineering matches the target buyer persona, Acme matches the company profile, and recent engagement supports current intent.",
"references": [
{
"type": "evidence",
"label": "Topic engagement",
"url": "https://linkedin.com/posts/example"
}
]
},
"score": {
"value": 86,
"fit": "high",
"reasoning": "High lead priority because the person has strong title fit, resolved company context, and recent relevant signal evidence."
}
}
],
"cursor": {
"next": "",
"has_more": false
}
}
POST /v1/signals/leads
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your API key.
Body
Filter by signal type, matching the signal.type values returned with each lead. See Accepted Filter Values.
Example: [“topic_engagement_signal”]
Filter leads to one or more sheets configured in the dashboard.
Example: [“sh_6P9vR3”]
Return specific leads by ID.
Example: [“ld_8K2mQ9”]
Filter leads to one or more companies.
Example: [“co_4F7xN2”]
Filter by lead country code using two-letter country codes. See Accepted Filter Values.
Example: [“US”, “GB”]
Filter by company country code using two-letter country codes. See Accepted Filter Values.
Example: [“US”, “CA”]
Restrict results by when the lead first entered the Directory.
Restrict results to when the latest matching distinct signal was observed.
Restrict results using inclusive min and max score values from 0 to 100.
Sort by date_found, latest_signal, ai_score, or signal_count. Direction is SORT_DIRECTION_DESC or SORT_DIRECTION_ASC. The default is date_found descending, matching the Leads dashboard.
Number of leads to return per page.
Example: 100
Opaque cursor returned as cursor.next from the previous response.