List Signal Imports
List what the workspace’s signals brought in, most recent fact first.
An entry records which signal fired, who or which company it was about, and whether it was imported, was already in the list, or was filtered out.
Requires the signals:read scope on the API key.
curl --request GET \
--url https://api.topo.io/v1/signals/imports \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.topo.io/v1/signals/imports', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.topo.io/v1/signals/imports"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"items": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"signal_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"signal_name": "<string>",
"signal_type": "LINKEDIN_OWN_POST_ENGAGEMENT",
"kind": "CONTACT",
"status": "FOUND",
"skip_detail": "<string>",
"failed_filters": [
"<string>"
],
"occurred_at": "2023-11-07T05:31:56Z",
"processed_at": "2023-11-07T05:31:56Z",
"contact_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"first_name": "<string>",
"last_name": "<string>",
"job_title": "<string>",
"email": "<string>",
"linkedin_url": "<string>",
"company_name": "<string>",
"company_domain": "<string>",
"account_name": "<string>",
"account_domain": "<string>"
}
],
"total_count": 123,
"total_pages": 123,
"has_more": true
}Authorizations
Bearer API key issued from Settings → Developers.
Query Parameters
x >= 11 <= x <= 100Return only what this signal brought in.
Return only entries from signals of this preset.
LINKEDIN_OWN_POST_ENGAGEMENT, LINKEDIN_COMPETITOR_POST_ENGAGEMENT, LINKEDIN_PERSON_POST_ENGAGEMENT, LINKEDIN_KEYWORD_MENTION, LINKEDIN_OWN_COMPANY_FOLLOWERS, LINKEDIN_COMPETITOR_FOLLOWERS, LINKEDIN_COMPANY_PAGE_FOLLOWERS, HIRING_SIGNALS, JOB_DESCRIPTION_KEYWORD, FUNDING_EVENTS, TECH_ADOPTION, NEWS_EVENTS, NEW_JOB, CUSTOM_EVENT, LINKEDIN_PARTNER_FOLLOWERS, LINKEDIN_CUSTOMER_FOLLOWERS, LINKEDIN_PARTNER_POST_ENGAGEMENT, LINKEDIN_CUSTOMER_POST_ENGAGEMENT, LINKEDIN_COMPANY_PAGE_POST_ENGAGEMENT, LINKEDIN_OWN_PROFILE_POST_ENGAGEMENT, LINKEDIN_OWN_EMPLOYEES_POST_ENGAGEMENT, LINKEDIN_COMPETITOR_EMPLOYEES_POST_ENGAGEMENT, LINKEDIN_PARTNER_EMPLOYEES_POST_ENGAGEMENT, LINKEDIN_CUSTOMER_EMPLOYEES_POST_ENGAGEMENT, LINKEDIN_OWN_BRAND_MENTION, LINKEDIN_COMPETITOR_MENTION, LINKEDIN_PARTNER_MENTION, LINKEDIN_CUSTOMER_MENTION, LINKEDIN_EVENT_MENTION, COMPETITOR_TECH_ADOPTION, INTEGRATION_TECH_ADOPTION, LINKEDIN_EVENT_PAGE_FOLLOWERS, CHAMPION_CHANGED_JOB, CRM_LIST_ENTRY Return only people or only companies.
CONTACT, ACCOUNT Return only entries that ended in this state.
Display status for a signal occurrence — collapses the DB-level
SignalStatus/SignalSkipReason pair into the states the product
surfaces. ALREADY_IN_LIST and EXPIRED are kept out of REJECTED so
neither an ordinary duplicate nor a fact that simply aged out reads as
a qualification failure.
FOUND, IMPORTED, ALREADY_IN_LIST, EXPIRED, REJECTED Response
Successful Response
Records on this page.
Hide child attributes
Hide child attributes
Unique identifier of the imported entry.
Signal that produced the entry.
Name of the signal that produced the entry.
Catalog preset behind the signal.
LINKEDIN_OWN_POST_ENGAGEMENT, LINKEDIN_COMPETITOR_POST_ENGAGEMENT, LINKEDIN_PERSON_POST_ENGAGEMENT, LINKEDIN_KEYWORD_MENTION, LINKEDIN_OWN_COMPANY_FOLLOWERS, LINKEDIN_COMPETITOR_FOLLOWERS, LINKEDIN_COMPANY_PAGE_FOLLOWERS, HIRING_SIGNALS, JOB_DESCRIPTION_KEYWORD, FUNDING_EVENTS, TECH_ADOPTION, NEWS_EVENTS, NEW_JOB, CUSTOM_EVENT, LINKEDIN_PARTNER_FOLLOWERS, LINKEDIN_CUSTOMER_FOLLOWERS, LINKEDIN_PARTNER_POST_ENGAGEMENT, LINKEDIN_CUSTOMER_POST_ENGAGEMENT, LINKEDIN_COMPANY_PAGE_POST_ENGAGEMENT, LINKEDIN_OWN_PROFILE_POST_ENGAGEMENT, LINKEDIN_OWN_EMPLOYEES_POST_ENGAGEMENT, LINKEDIN_COMPETITOR_EMPLOYEES_POST_ENGAGEMENT, LINKEDIN_PARTNER_EMPLOYEES_POST_ENGAGEMENT, LINKEDIN_CUSTOMER_EMPLOYEES_POST_ENGAGEMENT, LINKEDIN_OWN_BRAND_MENTION, LINKEDIN_COMPETITOR_MENTION, LINKEDIN_PARTNER_MENTION, LINKEDIN_CUSTOMER_MENTION, LINKEDIN_EVENT_MENTION, COMPETITOR_TECH_ADOPTION, INTEGRATION_TECH_ADOPTION, LINKEDIN_EVENT_PAGE_FOLLOWERS, CHAMPION_CHANGED_JOB, CRM_LIST_ENTRY Whether the entry is a person or a company.
CONTACT, ACCOUNT FOUND is detected but not processed yet, IMPORTED landed in the destination list, ALREADY_IN_LIST was a duplicate, REJECTED was filtered out.
FOUND, IMPORTED, ALREADY_IN_LIST, EXPIRED, REJECTED Why the entry was rejected, when it was.
Filter field names that rejected the entry, when skip_detail is FILTERS_NOT_MATCHED.
When the underlying fact happened at the source.
When the signal decided what to do with the entry.
The imported lead, once it exists in the workspace.
The imported account, once it exists in the workspace.
First name of the person.
Last name of the person.
Job title of the person.
Email of the person.
LinkedIn profile of the person.
Company the person works at.
Domain of the company the person works at.
Name of the detected company.
Domain of the detected company.
Total number of records matching the query.
Total number of pages.
Whether more pages remain after the current one.
Was this page helpful?
curl --request GET \
--url https://api.topo.io/v1/signals/imports \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.topo.io/v1/signals/imports', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.topo.io/v1/signals/imports"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"items": [
{
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"signal_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"signal_name": "<string>",
"signal_type": "LINKEDIN_OWN_POST_ENGAGEMENT",
"kind": "CONTACT",
"status": "FOUND",
"skip_detail": "<string>",
"failed_filters": [
"<string>"
],
"occurred_at": "2023-11-07T05:31:56Z",
"processed_at": "2023-11-07T05:31:56Z",
"contact_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"account_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"first_name": "<string>",
"last_name": "<string>",
"job_title": "<string>",
"email": "<string>",
"linkedin_url": "<string>",
"company_name": "<string>",
"company_domain": "<string>",
"account_name": "<string>",
"account_domain": "<string>"
}
],
"total_count": 123,
"total_pages": 123,
"has_more": true
}