New: education details on get_person_profile
get_person_profile returns more of a person’s education, matching the REST API’s person endpoint.- The response has
education_level(the highest level reached, such asDoctoral degree) andlast_updated. - Each
educationentry hasdescription(research focus, honours, modules, and a grade written as text),locationandschool_linkedin_url.
New: the company ID on talent signals
A talent signal returned byget_saved_search_items or search has current_position_company_external_id: the ID of the company the person’s current position is at, as get_company_profile and the other company tools take it. It is null when Specter holds that company only by name.What to do: nothing. The field is additive.Changed: get_person_email returns professional addresses only
get_person_email answers with a person’s professional (work) address. It no longer returns a personal address, and no longer falls back to one when no professional address is on file: that call now fails with “No email found”, as a call for a person with no address at all always did. The response’s email_type is always professional.email_type is still accepted and is now refused. A call that passes it — any value, including professional — fails with “email_type is no longer supported: get_person_email returns professional (work) email addresses only.” The parameter was kept rather than removed so that a call written against the old behavior fails with that message, instead of quietly returning a different kind of address.What to do: drop email_type from your calls. A call that selected professional returns what it always did. A call that selected personal, or that relied on either falling back to a personal address, no longer receives one.New: list columns on get_lists and get_list_items, and created on create_list and create_saved_search
Four tools return new fields. Nothing was removed or renamed, and no input changed.get_lists- Each list has
custom_fields: the list’s own columns beyond Specter’s data. - The response has
workspace_custom_fields: the columns every list of that product shows, shared cell for cell. When a list has its own column with the same name, the list’s own column is the one it means.
get_list_items- The response has
custom_fields: the list’s columns, in the shape above. - Each item has
custom_fields: its values in those columns, keyed by column name. A select value is given by its label. A column the item has no value in is absent.
create_list and create_saved_searchBoth return created. It is false when you already had a list of that name and product, or a saved search of that name over that query, and that one was returned instead of a new one. create_list still adds any requested items the list did not hold yet.What to do: nothing. The fields are additive. Read created to tell a new list or search from one you already had.Changed: get_investor_profile lists at most 25 portfolio companies
portfolio_companies holds at most 25 company IDs: the companies the investor backed across the most rounds, most first. A large fund’s whole portfolio ran to thousands of IDs, which made one profile too large to use.What to do: to work through a whole portfolio, page through get_investor_funding_rounds, which lists every round the investor joined with the company it funded.Removed: signal_mode='new' on get_saved_search_items
signal_mode='new' applied a fixed time window: the current month for company searches, the current week for talent-signal and interest-signal searches. The value is no longer accepted. A call that sends it fails with the same “not valid for this search” error as any other unsupported signal_mode.To select results by time, pass a cutoff:new_results_afterreturns the results added after the given timestamp.since_last_viewedreturns the results added since the saved search was last opened.
signal_mode='new_talent_signals' on a people search is unaffected.What to do: replace signal_mode='new' with new_results_after or since_last_viewed.