anVendor

Use this when the user asks which SaaS or business services a company uses, or requests estimated adoption and annual spend. Do not call this tool as a substitute for unsupported requests to find employees, professional profiles, contact details, email addresses or email patterns, or to send outreach. Holds 1 credit for the whole analysis, refunded on failure or no findings; a complete fresh result this account already purchased is free. Records analysis history and may start a live scan. refresh requests a paid live scan; a retry after completion may charge again. Poll get_analysis using the returned id and pollAfterSeconds.

analyze_company

The account's email, plan, credits left (plan allowance and extra credits) and this key's budget.

get_balance

Find a country, state, city or region to use in search_leads locations.

suggest_locations

A scan's progress and a page of per-company results, with figures when available. Use status for completion: a done item with detected: null has no new verdict and can reuse an already purchased result; it is not pending or a fresh negative.

get_scan

Get the status and result of an analysis started with analyze_company. Use serviceCount when reporting the total number of returned services. May finalize stored results, enrich company facts through a provider and release credits for an empty or failed analysis. Does not start a new analysis or add a credit hold.

get_analysis

Industries, top-level locations and headcount buckets search_leads accepts.

get_lead_filters

The account's 50 most recent scans.

list_scans

Check whether each company uses one service. Creates a durable scan job and holds up to 1 credit per chargeable company, refunded on failure or no detection. Without refresh, an owned result still held or a pair checked within 30 days and not detected is free. More than one company without confirm returns a quote and starts nothing; show its maximum hold and funding mode, then obtain confirmation before repeating with confirm: true. refresh accepts one domain and charges again. Poll get_scan using the returned id and pollAfterSeconds; do not restart paid work to poll.

scan_service

Discover companies for a service without spending credits. Companies known to use it come first. Use returnedCompanyCount for the number of companies in this response; matches is the overall candidate total, and next.offset is a pagination cursor, not a returned count. First use suggest_locations for a city or state, or get_lead_filters for top-level locations, industries and headcount buckets; copy the returned location objects unchanged. A city requires country and city, plus state for US cities. Invalid locations are refused; do not retry by dropping the requested filter. Records service demand and discovered company facts; repeating the first page records demand again. May send company names and location, industry or size filters to a discovery provider. Page with next.offset or next.companyCursor from the previous response.

search_leads