changedInput schema / properties / cursor / description
Previous value: -"Opaque pagination cursor from a previous call."New value: +"next_cursor from the previous 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 new query."
changedInput schema / properties / filters / description
Previous value: -"Filter conditions (optional — omit for everything, newest data first)."New value: +"Conditions, each {field, operator, value, conj}; omit to match every lead. text fields [operators: contains, not_contains, is, is_not, is_empty, is_not_empty]: name, category, city, state, address, website, primary_email (or email_1), email_2, email_3, primary_phone (or phone_1), phone_carrier (or phone_1_carrier), phone_2, phone_2_carrier, phone_3, phone_3_carrier, owner_name, social_facebook, social_instagram, social_linkedin, social_x, social_youtube, social_tiktok, social_yelp, gbp_url, google_cid, logo_url, main_image_url. number fields [operators: eq, neq, gt, gte, lt, lte, is_empty, is_not_empty]: rank, rating, reviews. yes/no fields [operators: is_true, is_false, is_empty, is_not_empty]: claimed. choice fields [operators: is, is_not, is_empty, is_not_empty]: email_status (or email_1_status), email_2_status, email_3_status take safe, risky, invalid, unknown; phone_line_type (or phone_1_type), phone_2_type, phone_3_type take mobile, fixed_line (Landline), fixed_line_or_mobile (Landline or mobile), voip, non_fixed_voip, toll_free (Toll-free), premium_rate, shared_cost, personal_number (Personal), pager, uan, voicemail, unknown. value is one string (a number as text, e.g. '4.5'); is_empty, is_not_empty, is_true and is_false take none. Text matching ignores case. Phone fields compare digits, so '(512) 555' finds +15125550100; website is / is_not compare domains when given a domain ('acme.com', or 'https://www.acme.com/'), and whole addresses when given a path, a query or a fragment ('acme.com/locations/austin'), either way ignoring http(s)://, www. and a closing slash. conj ('and' or 'or') joins a condition to the one before it, and 'and' binds tighter: A and B or C means (A and B) or C. To match any of several values, send one condition per value joined with conj 'or', repeating the other conditions in each group."
changedInput schema / properties / limit / description
Previous value: -"Max leads to return (default 25, max 1000)."New value: +"Max leads to return (default 25, max 1,000)."
addedInput schema / properties / search_id
Added value: +{
+ "description": "Only this search's leads (a search_id from search_leads or list_searches) — e.g. to narrow one search before export_leads with the same search_id and filters. Omit to query the whole library.",
+ "type": "string"
+}
changedInput schema / properties / sort / description
Previous value: -"Sort keys, e.g. [{id:'reviews',dir:-1}]. Optional."New value: +"Sort keys in priority order, e.g. [{id:'reviews',dir:-1}] for most-reviewed first. id is any filter field id (the column ids email_1, email_1_status, phone_1, phone_1_type and phone_1_carrier work too); dir is 1 ascending (the default) or -1 descending. A lead with no value for a key (null) sorts after the leads that have one, in either direction — except social_facebook, social_instagram, social_linkedin, social_x, social_youtube, social_tiktok, social_yelp, gbp_url, logo_url, main_image_url, which sort by whether a lead has one, not by the link: ascending puts the leads WITHOUT one first, so use dir -1 to put the leads that have one first. Without a sort the order is arbitrary but stable."
changedOutput schema / properties / next_cursor / description
Previous value: -"Pass back as 'cursor' for the next page."New value: +"Pass back as 'cursor' for the next page (it carries the filters and sort); null on the last page."
addedOutput schema / properties / results / items / properties / address
Added value: +{
+ "description": "Street address from the Google listing.",
+ "type": [
+ "string",
+ "null"
+ ]
+}
addedOutput schema / properties / results / items / properties / claimed
Added value: +{
+ "description": "Whether the owner has claimed the Google listing.",
+ "type": [
+ "boolean",
+ "null"
+ ]
+}
addedOutput schema / properties / results / items / properties / email_status
Added value: +{
+ "description": "Email 1's SMTP verdict: safe | risky | invalid | unknown.",
+ "type": [
+ "string",
+ "null"
+ ]
+}
addedOutput schema / properties / results / items / properties / google_cid
Added value: +{
+ "description": "Google listing id (the query_leads google_cid field).",
+ "type": [
+ "string",
+ "null"
+ ]
+}
addedOutput schema / properties / results / items / properties / maps_url
Added value: +{
+ "description": "The Google Maps link for the listing.",
+ "type": [
+ "string",
+ "null"
+ ]
+}
addedOutput schema / properties / results / items / properties / phone
Added value: +{
+ "description": "The Google Maps number.",
+ "type": [
+ "string",
+ "null"
+ ]
+}
addedOutput schema / properties / results / items / properties / phone_line_type
Added value: +{
+ "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"
+ ]
+}
addedOutput schema / properties / results / items / properties / primary_email
Added value: +{
+ "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"
+ ]
+}
addedOutput schema / properties / results / items / properties / primary_phone
Added value: +{
+ "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"
+ ]
+}
changedOutput schema / properties / total_matching / description
Previous value: -"Exact match count (first page only; absent on later pages)."New value: +"Exact match count — on the first page only; null on later pages."