Get Signal
Read one signal in full, including its detection and import filters.
Requires the signals:read scope on the API key.
curl --request GET \
--url https://api.topo.io/v1/signals/{signal_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.topo.io/v1/signals/{signal_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.topo.io/v1/signals/{signal_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"signal_type": "LINKEDIN_OWN_POST_ENGAGEMENT",
"status": "ACTIVE",
"cadence": "DAILY",
"max_per_run": 123,
"max_companies_per_run": 123,
"max_contacts_per_company": 123,
"max_per_day": 123,
"enrich_email": true,
"enrich_phones": true,
"imported_count": 123,
"contact_list_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"account_list_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"archived_at": "2023-11-07T05:31:56Z",
"url": "<string>",
"list_url": "<string>",
"search_filters": {},
"import_search_filters": {},
"sequence_template_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"import_target": "PEOPLE",
"event_subject": "PEOPLE"
}Authorizations
Bearer API key issued from Settings → Developers.
Path Parameters
ID of the signal.
Response
Successful Response
Unique identifier of the signal.
Name of the signal and of its destination list.
Catalog preset the signal watches.
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 ACTIVE checks daily, PAUSED is held until resumed, ARCHIVED is retired and cannot be resumed.
ACTIVE, PAUSED, ARCHIVED How often the signal checks its provider.
DAILY, WEEKLY Daily ceiling on imported entries, when one was set.
Daily ceiling on detected companies consumed, when one was set.
People imported per detected company, when one was set.
Ceiling on the entries the signal imports in one day, resolved from the caps above.
Whether imported leads get their email enriched.
Whether imported leads get their phone enriched.
Entries the signal has imported since it was created.
Destination list, when the signal imports people.
Destination list, when the signal imports companies.
When the signal was created.
When the signal was retired, if it was.
Deep link to the signal in Topo.
Deep link to the destination list in Topo.
Sequence template the imported leads are enrolled into.
Whether the signal imports people or companies.
PEOPLE, COMPANIES What a custom-event signal's own events identify. Null for every provider-backed preset.
PEOPLE, COMPANIES Was this page helpful?
curl --request GET \
--url https://api.topo.io/v1/signals/{signal_id} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.topo.io/v1/signals/{signal_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.topo.io/v1/signals/{signal_id}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"name": "<string>",
"signal_type": "LINKEDIN_OWN_POST_ENGAGEMENT",
"status": "ACTIVE",
"cadence": "DAILY",
"max_per_run": 123,
"max_companies_per_run": 123,
"max_contacts_per_company": 123,
"max_per_day": 123,
"enrich_email": true,
"enrich_phones": true,
"imported_count": 123,
"contact_list_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"account_list_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"created_at": "2023-11-07T05:31:56Z",
"archived_at": "2023-11-07T05:31:56Z",
"url": "<string>",
"list_url": "<string>",
"search_filters": {},
"import_search_filters": {},
"sequence_template_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"import_target": "PEOPLE",
"event_subject": "PEOPLE"
}