leadmarina

 ⟨63 unchanged words⟩  search is unnamed and location comes back null. A code for a place outside the US is refused, as is a location ending in another country ('London, UK').","type":"number"},"query":{ ⟨12 unchanged words⟩ 

 ⟨191 unchanged words⟩ "type":["string","null"]},"contact_name":{"description":"The person the business's own website names as running part of it (a manager, a practice's doctor) when it names no owner.","type":["string","null"]},"contact_title":{"description":"That person's role, as the website gives it.","type":["string","null"]},"emails_data":{"description":"Verified emails with SMTP ⟨9 unchanged words⟩ "]},"owner_name":{"type":["string","null"]},"people":{"description":"Everyone the business's own website names as working there, each { name, title, kind } (kind: owner, manager, practitioner, staff).","items":{"type":"object"},"type":["array","null"]},"phones_data":{"description" ⟨45 unchanged words⟩ 

{"properties":{"data_sources":{"description":"Where the sources, licences and notices are for emails and owner names that may come from open datasets and public records. Pass it on with any of this data you share.","type":"string"},"enrichment":{"description":"'pending' or 'complete'.", ⟨380 unchanged words⟩ 

 ⟨41 unchanged words⟩ "},"count":{"type":"number"},"data_sources":{"description":"Where the sources, licences and notices are for emails and owner names that may come from open datasets and public records. Pass it on with any of this data you share.","type":"string"}},"required":["count","automations"],"type":"object"}

{"properties":{"data_sources":{"description":"Where the sources, licences and notices are for emails and owner names that may come from open datasets and public records. Pass it on with any of this data you share.","type":"string"},"next_cursor":{"description":"Pass back as 'cursor' ⟨263 unchanged words⟩ 

 ⟨18 unchanged words⟩  the user.","type":"boolean"},"data_sources":{"description":"Where the sources, licences and notices are for emails and owner names that may come from open datasets and public records. Pass it on with any of this data you share.","type":"string"},"delivered_so_far":{"type":"number"},"discovery" ⟨199 unchanged words⟩ 

{"properties":{"active":{"type":"boolean"},"data_sources":{"description":"Where the sources, licences and notices are for emails and owner names that may come from open datasets and public records. Pass it on with any of this data you share.","type":"string"},"id":{"type":"string"},"note" ⟨7 unchanged words⟩ 

 ⟨24 unchanged words⟩  name, socials). Costs 1 lead per domain.distinct domain — spellings of the same site (acme.com, www.acme.com, https://acme.com/contact) count once. Returns a search_id to poll with get_search_results.

 ⟨15 unchanged words⟩ ,"next_step":{"type":"string"},"note":{"description":"Present when a delivered domain was listed more than once, or when the balance left some domains out (named, not charged).","type":"string"},"search_id":{"type":"string"}},"required ⟨5 unchanged words⟩ 

 ⟨31 unchanged words⟩  file — 'csv' | 'xlsx' | 'json' (a 7-day download link, also emailed to the account owner +when downloadthe linkfile is small enough to attach). Exports EITHER one search's leads (pass search_id) or the whole library (set all=true,). optionallyEither can be narrowed with the same filtersfilter rows as query_leads — with search_id they apply within that search. Leads go out best-ranked first (rank, then id)., the order of the leads table. LIMITS PER CALL, which differ by destination because ⟨41 unchanged words⟩  than the limit, the response sets truncated=true and returns next_cursor — relay that to the user, the export was partial.partial; Previouslyto exportedsend the next batch, call export_leads again with the SAME destination, search_id or all, and filters, plus cursor=next_cursor. A next_cursor with not_sent means the destination's time limit cut this batch short: the same call with that cursor sends the rest. An all=true export spread over several calls reads the library live, so a lead that a search running between calls finds again can be skipped or sent twice; for one consistent copy, export the library in a single csv/xlsx (up to 50,000 leads) areor UPDATEDjson (up to 25,000) call while no search is running. Close, GoHighLevel and a LeadMarina-created sheet passed as spreadsheet_id UPDATE previously exported leads in place (matched by Google CID) —, never duplicated;touching the user's own CRM notes/columnsnotes/columns; area neverfile touched.or a new sheet is a fresh copy every time — so do not repeat a call that succeeded.

 ⟨9 unchanged words⟩  one search.","type":"boolean"},"cursor":{"description":"Continue an export: the next_cursor a previous export_leads call returned. Pass it with the same search_id/all and filters.","type":"string"},"destination":{"description":"Where the leads go. ⟨8 unchanged words⟩ :"string"},"filters":{"description":"WithOptional all=truequery_leads-style filter rows: narrowwithin the librarysearch usingwhen query_leads-stylesearch_id filteris rows.given, across the library with all=true.","items":{"type":"object"}, ⟨31 unchanged words⟩ 

 ⟨37 unchanged words⟩  when truncated.","type":"number"},"next_cursor":{"description":"Present when the per-call limit or this call's time limit left matching leads unsent: pass it as cursor, with the same destination, search_id/all and filters, to send them. It does not offer again a lead the destination refused (counted as failed in outcome).","type":"string"},"not_sent":{"description":"Leads of this batch the destination's time limit did not reach.","type":"number"},"note":{"type":"string"},"outcome" ⟨26 unchanged words⟩ },"warning":{"description":"Present when truncatedthe per-call limit or this call's time limit left leads unsent: what happened and how to getsend them. Leads the rest.destination refused are not covered here — outcome counts them as failed.","type":"string"}},"required": ⟨4 unchanged words⟩ 

{"destructiveHint":false,"idempotentHint":truefalse,"openWorldHint":true,"readOnlyHint":false,"title" ⟨5 unchanged words⟩ 

 ⟨111 unchanged words⟩ "results":{"items":{"properties":{"address":{"description":"Street address from the Google listing.","type":["string","null"]},"category":{"type":["string","null"]},"city":{"type":["string","null"]},"claimed":{"description":"Whether the owner has claimed the Google listing.","type":["boolean","null"]},"email_status":{"description":"Email 1's SMTP verdict: safe | risky | invalid | unknown.","type":["string","null"]},"emails_data":{"description":"Verified emails with SMTP ⟨2 unchanged words⟩ "type":["string","null"]},"google_cid":{"description":"Google listing id (the query_leads google_cid field).","type":["string","null"]},"maps_url":{"description":"The Google Maps link for the listing.","type":["string","null"]},"name":{"type":["string","null"]},"owner_name":{"type":["string","null"]},"phone":{"description":"The Google Maps number.","type":["string","null"]},"phone_line_type":{"description":"Phone 1's line type: mobile, fixed_line, voip or toll_free usually; also unknown, fixed_line_or_mobile and the other values query_leads lists.","type":["string","null"]},"phones_data":{"description":"Verified phones with line type + carrier."},"primary_email":{"description":"Email 1: the first address in emails_data, the one email_status describes. Before emails are verified, the lead's primary address.","type":["string","null"]},"primary_phone":{"description":"Phone 1: the first number in phones_data, the one phone_line_type describes. Before phones are verified, the lead's primary number, or its Google Maps number.","type":["string","null"]},"rating":{"type":["number", ⟨82 unchanged words⟩ 

 ⟨18 unchanged words⟩ search is run and no leads are spent. FilterA fieldsGoogle include:listing name,found category,more city,than state,once rating,appears reviewsonce, website,with claimed,its owner_name,most phone_1,recent email_1,data. email_status,Up phone_1_typeto 1,000 google_cid.leads Operators:per contains,call not_contains,(default 25). When next_cursor is, is_notset, starts_with,call gt,again gte,with lt,cursor lte,= is_empty,next_cursor is_not_empty,for is_truethe next page: the cursor carries its filters and sort, is_false.so Combineit rowscan withbe conjsent 'and'/'or'.alone. Example:Pass findsearch_id rated-4.5+to query one search's leads instead of the whole library. Example — plumbers in Austin rated 4.5 or higher with a verifiedsafe email, most-reviewed first: filters=[{field:'category',operator:'contains',value:'plumb'},{field:'city',operator:'is',value:'Austin',conj:'and'},{field:'rating',operator:'gte',value:'4.5',conj:'and'},{field:'email_status',operator:'is',value:'safe',conj:'and'}], sort=[{id:'reviews',dir:-1}]. A field, operator or value the tool cannot use comes back as an error that names it and lists what works.

{"properties":{"cursor":{"description":"Opaquenext_cursor paginationfrom cursorthe fromprevious call, for the next page. It carries that call's filters and sort: send it alone, or with the same filters and sort — different ones are refused. Leave it out to start a previousnew call.query.","type":"string"},"filters":{"description":"FilterConditions, conditionseach (optional{field, —operator, value, conj}; omit forto everythingmatch every lead. text fields [operators: contains, 

 ⟨3 unchanged words⟩ :"Pass back as 'cursor' for the next page (it carries the filters and sort); null on the last page.","type":["string","null"]},"results":{"items":{"properties":{"address":{"description":"Street address from the Google listing.","type":["string","null"]},"category":{"type":["string","null"]},"city":{"type":["string","null"]},"claimed":{"description":"Whether the owner has claimed the Google listing.","type":["boolean","null"]},"email_status":{"description":"Email 1's SMTP verdict: safe | risky | invalid | unknown.","type":["string","null"]},"emails_data":{"description":"Verified emails with SMTP ⟨2 unchanged words⟩ "type":["string","null"]},"google_cid":{"description":"Google listing id (the query_leads google_cid field).","type":["string","null"]},"maps_url":{"description":"The Google Maps link for the listing.","type":["string","null"]},"name":{"type":["string","null"]},"owner_name":{"type":["string","null"]},"phone":{"description":"The Google Maps number.","type":["string","null"]},"phone_line_type":{"description":"Phone 1's line type: mobile, fixed_line, voip or toll_free usually; also unknown, fixed_line_or_mobile and the other values query_leads lists.","type":["string","null"]},"phones_data":{"description":"Verified phones with line type + carrier."},"primary_email":{"description":"Email 1: the first address in emails_data, the one email_status describes. Before emails are verified, the lead's primary address.","type":["string","null"]},"primary_phone":{"description":"Phone 1: the first number in phones_data, the one phone_line_type describes. Before phones are verified, the lead's primary number, or its Google Maps number.","type":["string","null"]},"rating":{"type":["number","null" ⟨27 unchanged words⟩ "total_matching":{"description":"Exact match count (— on the first page only; absent

 ⟨12 unchanged words⟩ query 'electrician', location 'Austin, TX'). Returns a search_id and, usually, the first batch immediately with(its alistings search_id;are in `results`; their emails and phones are not verified yet — when discovery is 'in_progress' the provider was slow and the whole search was queued, so the leads arrive through get_search_results); more results are found and verified in the background — every email is SMTP-checked and everyphones phoneare verified with line type + carrier. Spends 1 lead per result. Poll get_search_results until enrichment is 'complete'. If enrichment is already 'complete', nothing was found and nothing more is coming; if capped is true, the balance covered fewer leads than were found.

 ⟨2 unchanged words⟩ {"description":"City, e.g. 'Austin, TX'. IgnoredNot ifneeded with location_code, which is given.always what is searched.","type":"string"},"location_code":{"description":"Optional exact location codecode. When given, it is what is searched, whatever location says. Sent with location, the search is named after the code's own place (skipsor after location when the citycode's lookupown name cannot be looked up).; sent alone, the search is unnamed and location comes back null.","type":"number"},"query":{ ⟨12 unchanged words⟩ 

{"properties":{"capped":{"description":"True when the lead balance covered fewer leads than were found — relay this to the user.","type":"boolean"},"delivered_so_far":{"type":"number"},"discovery":{"description":"'complete', or 'in_progress' when the search was queued whole.","type":"string"},"enrichment":{"description":"'pending' until background verification finishes.finishes; 'complete' at once when nothing was found.","type":"string"},"found":{"description":"Listings found in the first batch, before the balance capped delivery.","type":"number"},"leads_remaining":{"description":"Leads spendable now. On ⟨16 unchanged words⟩ ,"type":"number"},"location":{"description":"The place searched, as the location list names it (the location sent, when a code's own name could not be looked up); null for a location_code sent alone.","type":["string","null"]},"next_step":{"type":"string"},"query":{"type":"string"},"results":{"description":"The first batch, as delivered — contacts are verified in the background (get_search_results).","items":{"properties":{"category":{"type":["string","null"]},"city":{"type":["string","null"]},"emails_data":{"description":"Verified emails with SMTP status."},"enrichment_status":{"type":["string","null"]},"name":{"type":["string","null"]},"owner_name":{"type":["string","null"]},"phones_data":{"description":"Verified phones with line type + carrier."},"rating":{"type":["number","null"]},"reviews":{"type":["number","null"]},"socials":{"description":"Social profile links keyed by platform."},"state":{"type":["string","null"]},"website":{"type":["string","null"]}},"type":"object"},"type":"array"},"search_id":{"type":"string"} ⟨7 unchanged words⟩