List Social Engagement Engagers
curl --request POST \
--url https://gateway.firsttouch.ai/api/public/tools/list_social_engagement_engagers \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"linkedinUrl": null,
"limit": null,
"cursor": null,
"earliestEngagementPerContact": null,
"engagementType": null,
"postUrl": null,
"engagedFromUtc": null,
"engagedToUtc": null,
"profileId": null,
"signalId": null
}
'import requests
url = "https://gateway.firsttouch.ai/api/public/tools/list_social_engagement_engagers"
payload = {
"linkedinUrl": None,
"limit": None,
"cursor": None,
"earliestEngagementPerContact": None,
"engagementType": None,
"postUrl": None,
"engagedFromUtc": None,
"engagedToUtc": None,
"profileId": None,
"signalId": None
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
linkedinUrl: null,
limit: null,
cursor: null,
earliestEngagementPerContact: null,
engagementType: null,
postUrl: null,
engagedFromUtc: null,
engagedToUtc: null,
profileId: null,
signalId: null
})
};
fetch('https://gateway.firsttouch.ai/api/public/tools/list_social_engagement_engagers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://gateway.firsttouch.ai/api/public/tools/list_social_engagement_engagers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'linkedinUrl' => null,
'limit' => null,
'cursor' => null,
'earliestEngagementPerContact' => null,
'engagementType' => null,
'postUrl' => null,
'engagedFromUtc' => null,
'engagedToUtc' => null,
'profileId' => null,
'signalId' => null
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://gateway.firsttouch.ai/api/public/tools/list_social_engagement_engagers"
payload := strings.NewReader("{\n \"linkedinUrl\": null,\n \"limit\": null,\n \"cursor\": null,\n \"earliestEngagementPerContact\": null,\n \"engagementType\": null,\n \"postUrl\": null,\n \"engagedFromUtc\": null,\n \"engagedToUtc\": null,\n \"profileId\": null,\n \"signalId\": null\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://gateway.firsttouch.ai/api/public/tools/list_social_engagement_engagers")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"linkedinUrl\": null,\n \"limit\": null,\n \"cursor\": null,\n \"earliestEngagementPerContact\": null,\n \"engagementType\": null,\n \"postUrl\": null,\n \"engagedFromUtc\": null,\n \"engagedToUtc\": null,\n \"profileId\": null,\n \"signalId\": null\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://gateway.firsttouch.ai/api/public/tools/list_social_engagement_engagers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"linkedinUrl\": null,\n \"limit\": null,\n \"cursor\": null,\n \"earliestEngagementPerContact\": null,\n \"engagementType\": null,\n \"postUrl\": null,\n \"engagedFromUtc\": null,\n \"engagedToUtc\": null,\n \"profileId\": null,\n \"signalId\": null\n}"
response = http.request(request)
puts response.read_body{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}Social Engagement
List Social Engagement Engagers
Requires the admin team role or global admin access. Check get_current_user.toolAccess before calling.
Read get_guide with topic=social_engagement before using this tool; reuse it if already read for the current request.
Detailed usage guidance
- Lists stored Social Engagement engagers using FirstTouch data only.
- Requires team owner/admin access.
- Supply profileId for one exact monitored subscription, linkedinUrl for that URL across all team signals, or signalId for all monitored profiles in that signal without a URL.
- Supplied selectors combine with AND.
- Requires at least one selector.
- Filters by engagementType, exact postUrl, and engagement time before deduplication, counting, and pagination across the complete selection.
- Defaults earliestEngagementPerContact=true: one earliest matching event by engaged_at per contact, across team signals for a URL-only call or within the selected signal/subscription.
- With false, URL-only calls deduplicate by person plus saved event key across signals while preserving different actions by the same person; scoped calls retain all matching saved events.
- Returns saved data without fetching live engagement.
POST
/
api
/
public
/
tools
/
list_social_engagement_engagers
List Social Engagement Engagers
curl --request POST \
--url https://gateway.firsttouch.ai/api/public/tools/list_social_engagement_engagers \
--header 'Content-Type: application/json' \
--header 'X-API-Key: <api-key>' \
--data '
{
"linkedinUrl": null,
"limit": null,
"cursor": null,
"earliestEngagementPerContact": null,
"engagementType": null,
"postUrl": null,
"engagedFromUtc": null,
"engagedToUtc": null,
"profileId": null,
"signalId": null
}
'import requests
url = "https://gateway.firsttouch.ai/api/public/tools/list_social_engagement_engagers"
payload = {
"linkedinUrl": None,
"limit": None,
"cursor": None,
"earliestEngagementPerContact": None,
"engagementType": None,
"postUrl": None,
"engagedFromUtc": None,
"engagedToUtc": None,
"profileId": None,
"signalId": None
}
headers = {
"X-API-Key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-API-Key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
linkedinUrl: null,
limit: null,
cursor: null,
earliestEngagementPerContact: null,
engagementType: null,
postUrl: null,
engagedFromUtc: null,
engagedToUtc: null,
profileId: null,
signalId: null
})
};
fetch('https://gateway.firsttouch.ai/api/public/tools/list_social_engagement_engagers', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://gateway.firsttouch.ai/api/public/tools/list_social_engagement_engagers",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'linkedinUrl' => null,
'limit' => null,
'cursor' => null,
'earliestEngagementPerContact' => null,
'engagementType' => null,
'postUrl' => null,
'engagedFromUtc' => null,
'engagedToUtc' => null,
'profileId' => null,
'signalId' => null
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-API-Key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://gateway.firsttouch.ai/api/public/tools/list_social_engagement_engagers"
payload := strings.NewReader("{\n \"linkedinUrl\": null,\n \"limit\": null,\n \"cursor\": null,\n \"earliestEngagementPerContact\": null,\n \"engagementType\": null,\n \"postUrl\": null,\n \"engagedFromUtc\": null,\n \"engagedToUtc\": null,\n \"profileId\": null,\n \"signalId\": null\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-API-Key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://gateway.firsttouch.ai/api/public/tools/list_social_engagement_engagers")
.header("X-API-Key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"linkedinUrl\": null,\n \"limit\": null,\n \"cursor\": null,\n \"earliestEngagementPerContact\": null,\n \"engagementType\": null,\n \"postUrl\": null,\n \"engagedFromUtc\": null,\n \"engagedToUtc\": null,\n \"profileId\": null,\n \"signalId\": null\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://gateway.firsttouch.ai/api/public/tools/list_social_engagement_engagers")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-API-Key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"linkedinUrl\": null,\n \"limit\": null,\n \"cursor\": null,\n \"earliestEngagementPerContact\": null,\n \"engagementType\": null,\n \"postUrl\": null,\n \"engagedFromUtc\": null,\n \"engagedToUtc\": null,\n \"profileId\": null,\n \"signalId\": null\n}"
response = http.request(request)
puts response.read_body{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}{
"error": "<string>",
"message": "<string>",
"traceId": "<string>",
"details": {
"currentStatus": "pending"
}
}Body
application/json
Defaults to true.
- When true, keeps one earliest matching event by engaged_at per contact (normalized engager profile URL) after all filters, with the smallest event id breaking ties.
- Without signalId, selects the earliest across all signals monitoring linkedinUrl; with signalId, selects the earliest within that signal; profileId narrows to one subscription.
- When false, returns all matching events; URL-only calls collapse copies by normalized person URL plus saved event key across signals while preserving different actions.
- Use false when further local filtering requires event history.
Response
Tool result.