Evertrace AI connector

1. Install the SDK

   Node.js

   npm install @scalekit-sdk/node

   Python

   pip install scalekit

   Full SDK reference: Node.js | Python

2. Set your credentials

   Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

   .env

   SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
   SCALEKIT_CLIENT_ID=<your-client-id>
   SCALEKIT_CLIENT_SECRET=<your-client-secret>

3. Make your first call

   Node.js

   quickstart.ts

   import { ScalekitClient } from '@scalekit-sdk/node'
   import 'dotenv/config'
   
   const scalekit = new ScalekitClient(
     process.env.SCALEKIT_ENV_URL,
     process.env.SCALEKIT_CLIENT_ID,
     process.env.SCALEKIT_CLIENT_SECRET,
   )
   const actions = scalekit.actions
   
   const connector = 'evertrace'
   const identifier = 'user_123'
   
   // Make your first call
   const result = await actions.executeTool({
     connector,
     identifier,
     toolName: 'evertrace_cities_list',
     toolInput: {},
   })
   console.log(result)

   Python

   quickstart.py

   import os
   from scalekit.client import ScalekitClient
   from dotenv import load_dotenv
   load_dotenv()
   
   scalekit_client = ScalekitClient(
       env_url=os.getenv("SCALEKIT_ENV_URL"),
       client_id=os.getenv("SCALEKIT_CLIENT_ID"),
       client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),
   )
   actions = scalekit_client.actions
   
   connection_name = "evertrace"
   identifier = "user_123"
   
   # Make your first call
   result = actions.execute_tool(
       tool_input={},
       tool_name="evertrace_cities_list",
       connection_name=connection_name,
       identifier=identifier,
   )
   print(result)

What you can do

Connect this agent connector to let your agent:

• List companies, entries delete, entries get — Search companies by name or look up by specific IDs
• Delete lists, searches — Permanently delete a list and all its entries
• Update lists, searches — Rename a list
• Get lists, signals, searches — Get a list by ID with its entries, accesses, and creator information
• Create lists, searches — Create a new list
• Viewed signal mark — Mark a signal as viewed by the current user

Tool list

Use the exact tool names from the Tool list below when you call execute_tool. If you’re not sure which name to use, list the tools available for the current user first.

evertrace_cities_list#Search available cities by name. Returns city name strings sorted by signal count. Use these values in signal filters for the city field.3 params▾

Search available cities by name. Returns city name strings sorted by signal count. Use these values in signal filters for the city field.

NameTypeRequiredDescription

limitstringoptionalNumber of results per page.

pagestringoptionalPage number for pagination.

searchstringoptionalCase-insensitive partial match on city name (e.g. "san fran"). Omit to list all cities sorted by signal count.

evertrace_companies_list#Search companies by name or look up by specific IDs. Returns company entity IDs (exe_* format) needed for signal filtering by past_companies.4 params▾

Search companies by name or look up by specific IDs. Returns company entity IDs (exe_* format) needed for signal filtering by past_companies.

NameTypeRequiredDescription

idsarrayoptionalLook up specific companies by entity ID (exe_* format).

limitstringoptionalNumber of results per page.

pagestringoptionalPage number for pagination.

searchstringoptionalCase-insensitive partial match on company name (e.g. "google").

evertrace_educations_list#Search education institutions by name or look up by specific IDs. Returns institution entity IDs (ede_* format) needed for signal filtering by past_education.4 params▾

Search education institutions by name or look up by specific IDs. Returns institution entity IDs (ede_* format) needed for signal filtering by past_education.

NameTypeRequiredDescription

idsarrayoptionalLook up specific institutions by entity ID (ede_* format).

limitstringoptionalNumber of results per page.

pagestringoptionalPage number for pagination.

searchstringoptionalCase-insensitive partial match on institution name (e.g. "stanford").

evertrace_list_entries_create#Add a signal to a list.2 params▾

Add a signal to a list.

NameTypeRequiredDescription

list_idstringrequiredThe list ID to add the signal to.

signal_idstringrequiredThe signal ID to add.

evertrace_list_entries_delete#Remove an entry from a list.2 params▾

Remove an entry from a list.

NameTypeRequiredDescription

entry_idstringrequiredThe entry ID to remove.

list_idstringrequiredThe list ID.

evertrace_list_entries_get#Get a single list entry with its full signal profile.2 params▾

Get a single list entry with its full signal profile.

NameTypeRequiredDescription

entry_idstringrequiredThe entry ID.

list_idstringrequiredThe list ID.

evertrace_list_entries_list#List entries in a list with pagination, sorting, and filtering by screening/viewed status.7 params▾

List entries in a list with pagination, sorting, and filtering by screening/viewed status.

NameTypeRequiredDescription

list_idstringrequiredThe list ID.

limitstringoptionalNumber of results per page.

pagestringoptionalPage number for pagination.

screened_byarrayoptionalFilter by screening status. Prefix with "-" to exclude (e.g. ["-me", "-others"]).

sort_bystringoptionalSort field: "entry_created_at" (when added to list) or "signal_discovered_at" (when signal was discovered).

sort_orderstringoptionalSort direction: "asc" (oldest first) or "desc" (newest first).

viewed_byarrayoptionalFilter by viewed status. Prefix with "-" to exclude (e.g. ["-me"]).

evertrace_lists_create#Create a new list. Provide user IDs in accesses to share the list with teammates. The creator is automatically granted access.2 params▾

Create a new list. Provide user IDs in accesses to share the list with teammates. The creator is automatically granted access.

NameTypeRequiredDescription

namestringrequiredName of the new list.

accessesarrayoptionalArray of user IDs to share this list with. Pass an empty array for private list.

evertrace_lists_delete#Permanently delete a list and all its entries.1 param▾

Permanently delete a list and all its entries.

NameTypeRequiredDescription

idstringrequiredThe list ID to delete.

evertrace_lists_get#Get a list by ID with its entries, accesses, and creator information.1 param▾

Get a list by ID with its entries, accesses, and creator information.

NameTypeRequiredDescription

idstringrequiredThe list ID.

evertrace_lists_list#List all lists the current user has access to in evertrace.ai.0 params▾

List all lists the current user has access to in evertrace.ai.

evertrace_lists_update#Rename a list.2 params▾

Rename a list.

NameTypeRequiredDescription

idstringrequiredThe list ID to update.

namestringrequiredNew name for the list.

evertrace_searches_create#Create a new saved search with filters. Each filter requires a key, operator, and value. Provide sharee user IDs to share the search with teammates.5 params▾

Create a new saved search with filters. Each filter requires a key, operator, and value. Provide sharee user IDs to share the search with teammates.

NameTypeRequiredDescription

filtersarrayrequiredArray of filter objects. Each filter has: key (e.g. "country", "industry", "score"), operator (e.g. "in"), and value (e.g. "India").

shareesarrayrequiredArray of user IDs to share this search with.

titlestringrequiredTitle of the saved search (max 50 characters).

visited_atnumberrequiredEpoch timestamp in milliseconds for when the search was last visited.

emojistringoptionalOptional emoji for the saved search.

evertrace_searches_delete#Permanently delete a saved search.1 param▾

Permanently delete a saved search.

NameTypeRequiredDescription

idstringrequiredThe saved search ID to delete.

evertrace_searches_duplicate#Duplicate a saved search, creating a copy with the same filters and settings.1 param▾

Duplicate a saved search, creating a copy with the same filters and settings.

NameTypeRequiredDescription

idstringrequiredThe saved search ID to duplicate.

evertrace_searches_get#Get a saved search by ID with its filters and sharees.1 param▾

Get a saved search by ID with its filters and sharees.

NameTypeRequiredDescription

idstringrequiredThe saved search ID.

evertrace_searches_list#List all saved searches accessible to the current user in evertrace.ai.0 params▾

List all saved searches accessible to the current user in evertrace.ai.

evertrace_searches_signals_list#List signals matching a saved search's filters with pagination.3 params▾

List signals matching a saved search's filters with pagination.

NameTypeRequiredDescription

idstringrequiredThe saved search ID.

limitstringoptionalNumber of results per page.

pagestringoptionalPage number for pagination.

evertrace_searches_update#Update a saved search. All fields are optional — only provided fields are changed. If filters are provided, they replace all existing filters. If sharees are provided, they replace the full access list.6 params▾

Update a saved search. All fields are optional — only provided fields are changed. If filters are provided, they replace all existing filters. If sharees are provided, they replace the full access list.

NameTypeRequiredDescription

idstringrequiredThe saved search ID to update.

emojistringoptionalNew emoji for the saved search.

filtersarrayoptionalReplaces all existing filters. Each filter has: key, operator, value.

shareesarrayoptionalReplaces the full sharee list with these user IDs.

titlestringoptionalNew title for the saved search (max 50 characters).

visited_atnumberoptionalEpoch timestamp in milliseconds for when the search was last visited.

evertrace_signal_mark_viewed#Mark a signal as viewed by the current user.1 param▾

Mark a signal as viewed by the current user.

NameTypeRequiredDescription

signal_idstringrequiredThe ID of the signal to mark as viewed.

evertrace_signal_screen#Screen a signal, marking it as reviewed by the current user. Screened signals are hidden from default views.1 param▾

Screen a signal, marking it as reviewed by the current user. Screened signals are hidden from default views.

NameTypeRequiredDescription

signal_idstringrequiredThe ID of the signal to screen.

evertrace_signal_unscreen#Unscreen a signal, making it visible again in default views.1 param▾

Unscreen a signal, making it visible again in default views.

NameTypeRequiredDescription

signal_idstringrequiredThe ID of the signal to unscreen.

evertrace_signals_entries#Get all list entries for a signal. Shows which lists this signal has been added to.1 param▾

Get all list entries for a signal. Shows which lists this signal has been added to.

NameTypeRequiredDescription

idstringrequiredThe signal ID.

evertrace_signals_get#Get a single talent signal by ID with full profile details including experiences, educations, taggings, views, and screenings.1 param▾

Get a single talent signal by ID with full profile details including experiences, educations, taggings, views, and screenings.

NameTypeRequiredDescription

idstringrequiredThe signal ID to retrieve.

evertrace_signals_list#Search and filter talent signals with pagination. Returns full signal profiles including experiences, educations, taggings, views, and screenings.22 params▾

Search and filter talent signals with pagination. Returns full signal profiles including experiences, educations, taggings, views, and screenings.

NameTypeRequiredDescription

agearrayoptionalFilter by age range buckets. Valid values: "Below 25", "25 to 29", "30 to 34", "35 to 39", "40 to 44", "45 to 49", "Above 49".

cityarrayoptionalFilter by city name (e.g. ["San Francisco"]). Use evertrace_cities_list to search available cities. Prefix with "!" to exclude.

countryarrayoptionalFilter by country name (e.g. ["United States"]). Prefix with "!" to exclude.

created_afterstringoptionalEpoch timestamp in milliseconds. Only returns signals discovered after this point.

customer_focusarrayoptionalFilter by target market. Valid values: "B2B", "B2C".

education_levelarrayoptionalFilter by highest education level. Valid values: "Bachelor", "Master", "PhD or Above", "MBA", "No university degree".

fullnamestringoptionalFree-text search on person name (case-insensitive partial match).

genderarrayoptionalFilter by gender. Valid values: "man", "woman".

industryarrayoptionalFilter by industry vertical (e.g. ["Technology", "Healthcare"]). Prefix with "!" to exclude.

limitstringoptionalNumber of results per page.

originarrayoptionalFilter by nationality/origin country (e.g. ["India"]). Prefix with "!" to exclude.

pagestringoptionalPage number for pagination.

past_companiesarrayoptionalFilter by past employer using company entity IDs in exe_* format. Use evertrace_companies_list to look up IDs.

past_educationarrayoptionalFilter by past education institution using IDs in ede_* format. Use evertrace_educations_list to look up IDs.

profile_tagsarrayoptionalFilter by profile background tags. Valid values: "Serial Founder", "VC Backed Founder", "VC Backed Operator", "VC Investor", "YC Alumni", "Big Tech experience", "Big 4 experience", "Banking experience", "Consulting experience".

regionarrayoptionalFilter by geographic region or US state (e.g. ["Europe", "California"]). Prefix with "!" to exclude.

scorestringoptionalMinimum score threshold (1–10). Acts as a >= filter.

screened_byarrayoptionalFilter by screening status. Use "me", "others", or user IDs. Prefix with "-" to exclude.

sourcearrayoptionalFilter by data source name. Values are dynamic per workspace.

time_rangearrayoptionalAbsolute date range as [from, to] in YYYY-MM-DD format (e.g. ["2026-01-01", "2026-03-01"]). Mutually exclusive with time_relative.

time_relativestringoptionalRelative time window in days from today (e.g. "30", "60", "90") or epoch ms timestamp. Mutually exclusive with time_range.

typearrayoptionalFilter by signal type. Valid values: "New Company", "Stealth Position", "Left Position", "Investor Position", "Board Position", "New Position", "Promoted", "New Patent", "New Grant".

evertrace_signals_list_by_linkedin_id#Get all signals representing the same person, matched by LinkedIn ID. Useful for finding duplicate or historical signals for the same individual.1 param▾

Get all signals representing the same person, matched by LinkedIn ID. Useful for finding duplicate or historical signals for the same individual.

NameTypeRequiredDescription

idstringrequiredThe signal ID to match LinkedIn ID from.