check_balance
ChatGPTCheck the remaining standard Contact credits for the current API key/account. Note: This does NOT return Company API credits. It only returns standard credits used for revealing person contacts. Returns: A JSON string containing a single 'credits' integer (e.g. {"credits": 94980}).
check_without_contacts_credits
ChatGPTCheck the remaining daily quota (credits) for performing searches and retrieving candidate profiles WITHOUT revealing contact information. Use this tool to see how many 'without contacts' searches you have left before hitting your daily limit. Returns: A JSON string containing a single 'search_credits_left' integer (e.g. {"search_credits_left": 9967}).
find_company
ChatGPTLook up a company by name, ID, or slug to get its stable numeric ID. Does NOT consume credits. Returns: Basic company details including the numeric 'id' required for get_company_info.
get_available_departments
ChatGPTRetrieve a complete list of all candidate professional departments supported by the search API.
get_available_industries
ChatGPTRetrieve a list of supported industry categories for the search API.
get_available_levels
ChatGPTRetrieve a complete list of all candidate seniority levels (Lvl) supported by the search API.
get_company_info
ChatGPTRetrieve full company profile including locations, industry, headcount. WARNING: CHARGES 1 COMPANY CREDIT (this is separate from standard contact credits) - always ask the user for explicit permission before calling this tool! Returns: Comprehensive company data including exact headcount and locations.
retrieve_person_no_contacts
ChatGPTRetrieves person profile data without contact details. Useful for saving contact credits when only profile info is needed. CRITICAL INSTRUCTION: ONLY use this tool if the user EXPLICITLY asks to retrieve a profile WITHOUT contact details or to save credits. In all other cases (e.g. when the user just asks for a 'profile'), you MUST default to using retrieve_person_profile instead. Returns: Full employment history, education, and skills. Emails, phones, and social links are REDACTED.
retrieve_person_profile
ChatGPTRetrieves full person profile and contact information for specific identifiers (LinkedIn URL, email, phone, or SignalHire UID). CRITICAL INSTRUCTION: This is the DEFAULT tool to use when a user asks for a candidate's profile, unless they explicitly specify not to use credits or not to get contacts. WARNING: CHARGES CREDITS - always ask the user for explicit permission before calling this tool! Returns: Complete profile INCLUDING all available emails, phone numbers, and social media links.
scroll_search
ChatGPTFetch the next batch of search results using the scrollId returned by search_candidates_query. The scrollId expires in 15 seconds. Returns: A brief summary containing UID, Name, Location, and Current Job.
search_candidates_query
ChatGPTSearch for candidates in the database using filters like title, location, company, keywords. Does not consume credits, but uses daily search quota. CRITICAL INSTRUCTIONS FOR AGENTS: - If the user asks to search by department, level, or industry, YOU MUST FIRST call get_available_departments, get_available_levels, or get_available_industries to retrieve the exact list of valid options. - You must then PRESENT THIS LIST to the user and ask them to select from it. Do NOT guess the exact names/IDs yourself. - Supports boolean logic in text fields, e.g., (Mandarin OR Chinese) AND (Python OR PHP). - Pagination via scroll_search is impractical for chat agents because the scrollId expires in 15 seconds. If you need more results, it is highly recommended to increase the size parameter (up to 100) in this initial query instead. Returns: A brief summary containing UID, Name, Location, and Current Job. To get full history, pass the returned UIDs to retrieve_person_no_contacts.