Lyre Leads

FREE sample, no account: the first page (up to 20) of ONE Google Maps search for a kind of business in a place, with phones partly hidden. Nothing is saved or enriched, and it returns no emails, contacts or software. Use it only when the user asks for a preview or a sample, or has no account connected and wants to see what comes back. When the user asks to search, find, pull or list businesses, use search_leads (one city, answered at once) or search_areas (whole cities) instead, even for a single page: they save the businesses to the user's account and enrich them, and calling one starts sign-in if the account isn't connected yet. Places look like "Houston, TX", "Copenhagen" or "Lyon, France"; a shared name picks the largest and lists the others.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Kind of business, e.g. \"roofing contractor\" or \"hair salon\""
    },
    "place": {
      "type": "string",
      "description": "City or town, optionally with state and country, e.g. \"Houston, TX\" or \"Aarhus, Denmark\""
    },
    "country": {
      "type": "string",
      "description": "Optional country name, if the place name alone is ambiguous across countries"
    }
  },
  "required": [
    "query",
    "place"
  ]
}

FREE, no account needed. Look up the areas search_areas accepts in a country, most populous first, each with an id. Call without q to browse; call with no country to get the list of countries. When a place name is shared (the US list has four Houstons and thirteen Springfields), pass the id of the one the user means to search_areas.

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "Country name, e.g. \"United States\". Omit to list countries."
    },
    "q": {
      "type": "string",
      "description": "Part of a place name, case-insensitive, e.g. \"hous\""
    },
    "limit": {
      "type": "integer",
      "description": "Max areas (default 20, max 100)"
    }
  }
}

FREE, no account needed. Size a search_areas run before starting it: how many grid points, and, when the user's account is connected, how many areas it already covers for the query (those are skipped). It cannot give an exact cost, because billing is 1 lead per NEW business found and nobody knows how many exist before looking.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Business keyword, e.g. \"roofing contractor\""
    },
    "country": {
      "type": "string",
      "description": "Country name, as listed by find_areas"
    },
    "areas": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Area names like \"Houston, Texas\", or ids from find_areas"
    },
    "mode": {
      "type": "string",
      "enum": [
        "grid",
        "city"
      ],
      "description": "grid covers the whole area (default here); city pages from the centre and is cheaper for small towns"
    }
  },
  "required": [
    "query",
    "country",
    "areas"
  ]
}

The search to use for coverage. Sweeps each area with a grid of map points live against Google Maps, as a background job, the same search the Lyre Leads Search page runs. In Houston this found 1,061 roofing contractors where paging from one centre found 255. Costs 1 lead per NEW business; listings the account already holds cost nothing (a small per-page minimum applies). Every new business is enriched, relevance-checked, its address verified, and enrolled in the monthly re-check automatically. Returns job_id: poll get_job_status with kind "search" until finished is true, then read the leads with get_search_results. If an area name fits more than one place, the call returns the candidates with ids and starts nothing: ask the user which one they mean and resend with that id. At most two searches run at once per account.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Business keyword, e.g. \"roofing contractor\" or \"cosmetic dentist\""
    },
    "country": {
      "type": "string",
      "description": "Country name, as listed by find_areas"
    },
    "areas": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Area names like \"Houston, Texas\", or ids from find_areas"
    },
    "mode": {
      "type": "string",
      "enum": [
        "grid",
        "city"
      ],
      "description": "grid (default here) covers the whole area; city pages from the centre"
    }
  },
  "required": [
    "query",
    "country",
    "areas"
  ]
}

FREE. Read the leads a search_areas job found, up to 500 per page. Accepts the same filters as the Lyre Leads database, passed as filters, e.g. {"relevanceYes": true, "hasVerifiedEmail": true, "noFBPixel": true}. Each lead comes back compact by default: contact details, business email and its verification state, named contact, relevance verdict with its evidence, software and signals, plus a summary and next steps; detail "full" returns every database field. Enrichment keeps landing for a while after the search finishes, so re-read if leads are still enriching.

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "description": "job_id returned by search_areas"
    },
    "limit": {
      "type": "integer",
      "description": "Leads per page (default 50, max 500)"
    },
    "page": {
      "type": "integer",
      "description": "Page number, from 1"
    },
    "filters": {
      "type": "object",
      "description": "Database filter parameters as key/value pairs, e.g. {\"relevanceYes\": true, \"minReviews\": 100}"
    },
    "detail": {
      "type": "string",
      "enum": [
        "compact",
        "full"
      ],
      "description": "compact (default) or full (every field, much longer)"
    }
  },
  "required": [
    "job_id"
  ]
}

Search ONE city on the user's account and get the businesses back in the same call: 1 to 5 result pages from the city centre, about 20 per page. Use it when the user asks for a quick search, a page of results or one town; for a whole city or several, use search_areas, which finds several times more. Costs 1 lead per NEW business; ones the account already holds are free. Every new business is then enriched from its own website in the background, about two minutes for 20: business email with its verification state, a named contact where the site names one, the software it runs, and a check that it really is the kind of business searched for. Returns the Maps listing and a search_id. Then call list_results with that search_id and wait_seconds 40, and show the user what enrichment found, not only the listing.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Business keyword, e.g. \"roofing contractor\" or \"cosmetic dentist\" (max 200 chars)"
    },
    "city": {
      "type": "string",
      "description": "City name, e.g. \"Austin\""
    },
    "country": {
      "type": "string",
      "description": "Country name, e.g. \"United States\""
    },
    "pages": {
      "type": "integer",
      "description": "Result pages to pull, 1-5 (about 20 results per page). Default 1.",
      "minimum": 1,
      "maximum": 5
    }
  },
  "required": [
    "query",
    "city",
    "country"
  ]
}

FREE. Read saved leads with what enrichment found: business email and its verification state, named contact (name, title, email and its state), the relevance verdict with the sentence from the business's own site, software (CMS, CRM, booking, chat, email marketing), technologies and signals. Pass the search_id from search_leads to read that search; wait_seconds (up to 45) first waits for enrichment still running on it. Returns a compact view with a summary and next steps; detail "full" returns every field.

{
  "type": "object",
  "properties": {
    "search_id": {
      "type": "string",
      "description": "Batch id returned by search_leads (optional: omit for all results)"
    },
    "limit": {
      "type": "integer",
      "description": "Max rows to return (default 50, max 100)"
    },
    "offset": {
      "type": "integer",
      "description": "Pagination offset"
    },
    "wait_seconds": {
      "type": "integer",
      "minimum": 0,
      "maximum": 45,
      "description": "With search_id: wait up to this many seconds for enrichment to finish before reading. 40 right after search_leads."
    },
    "detail": {
      "type": "string",
      "enum": [
        "compact",
        "full"
      ],
      "description": "compact (default) or full (every field, much longer)"
    }
  }
}

Get the account lead balance and tier. The unit is a lead: 1 lead = 1 new business found by a search, with enrichment, relevance check, verified address and the monthly re-check included. Businesses you already hold: enrichment is five per lead, enrolling in the monthly re-check is two per lead. Named contacts found on the open web cost 2 leads each, charged only when a person is found. Email verification is included at no charge. Unused leads roll over, up to three months' allowance. Plans are bought and changed on the Lyre Leads website, not through these tools; the result carries the link.

{
  "type": "object",
  "properties": {}
}

FREE, no account needed. Answers "what would it cost to find me N businesses, and what data comes with each one". Returns an exact cost in leads broken down by stage (search, enrichment, contact discovery), and when the user's account is connected its balance and the maximum businesses affordable right now, and the full list of data points each lead arrives with. THIS is the tool to use when a user asks what Lyre Leads can get them. Do NOT use count_saved_leads for that question: Lyre Leads generates leads on demand from a live Google Maps search and does not sell access to a stored pile of them, so a count of what an account already holds is not a measure of what is available.

{
  "type": "object",
  "properties": {
    "lead_count": {
      "type": "integer",
      "description": "How many businesses the user wants found (1-100000)"
    },
    "include_contacts": {
      "type": "boolean",
      "description": "Also find the named contacts at each business on the open web and verify their mailboxes. Default false. 2 leads per contact found; a business where nobody is found costs nothing."
    }
  },
  "required": [
    "lead_count"
  ]
}

FREE and exact. Counts leads THIS ACCOUNT has already searched and saved, matching any combination of filters, with a breakdown of how many are enriched, have an email, have a contact email, or have been relevance-checked. Use it to size a job over data the account already owns before spending: "how many of my saved roofers have no CRM and a verified email". CRITICAL: this is NOT an inventory of what Lyre Leads can find, and a small result here means the account has not searched much yet, nothing more. Never report this number to a user as the amount of data available, and never use it to answer "how many X do you have" — call estimate_list for that.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Substring match on the search keyword that found the lead, e.g. \"roofing\""
    },
    "city": {
      "type": "string",
      "description": "Substring match on city"
    },
    "country": {
      "type": "string",
      "description": "Substring match on country"
    },
    "type": {
      "type": "string",
      "description": "Substring match on the Google Maps business category, e.g. \"Dentist\""
    },
    "search_id": {
      "type": "string",
      "description": "Restrict to one batch from search_leads"
    },
    "has_email": {
      "type": "boolean",
      "description": "true = has a business email. false = enriched and confirmed to have none (excludes never-checked rows)."
    },
    "has_website": {
      "type": "boolean",
      "description": "true = has a website. false = enriched and confirmed to have none."
    },
    "has_contact_email": {
      "type": "boolean",
      "description": "true = a named contact address is on file."
    },
    "has_cms": {
      "type": "boolean",
      "description": "true = a CMS was detected. false = enriched and none detected (custom/hand-built site)."
    },
    "has_crm": {
      "type": "boolean",
      "description": "true = a CRM was detected. false = enriched and none detected. This is the classic \"they have no CRM, sell them one\" filter."
    },
    "email_verification_status": {
      "type": "string",
      "description": "One of: verified, catch_all, unknown, invalid"
    },
    "enrichment_status": {
      "type": "string",
      "description": "One of: enriched, pending, unverifiable, no_website, failed"
    },
    "ai_crawler_access": {
      "type": "string",
      "description": "One of: open, partial, blocked, unknown. \"blocked\" = the site is invisible to AI search engines."
    },
    "min_rating": {
      "type": "number",
      "description": "Minimum Google star rating"
    },
    "max_rating": {
      "type": "number",
      "description": "Maximum Google star rating. Use with min_reviews to find well-reviewed but poorly-rated businesses."
    },
    "min_reviews": {
      "type": "integer",
      "description": "Minimum Google review count"
    },
    "max_reviews": {
      "type": "integer",
      "description": "Maximum Google review count"
    },
    "relevance": {
      "type": "string",
      "description": "One of: yes, no, unclear. Did a model reading the business website judge it to be the kind of business this row's own search query asked for? Runs inside enrichment at no extra cost, and every verdict carries a verbatim quote from the page in relevance_evidence. Absent means never judged, which is not the same as \"no\". Filter on \"yes\" to drop the results Google Maps returned that are not the trade you searched for."
    },
    "enrolled": {
      "type": "boolean",
      "description": "true = enrolled in enrichment: re-checked about monthly at no charge. Every business a search found is enrolled. false = not enrolled (usually imported); enroll_leads enrolls it at two businesses per lead."
    }
  }
}

Fetch each lead's website and extract 50+ fields: business email, social profiles, CMS, CRM, email-marketing platform, chat widget, booking system, ad pixels, analytics, schema, SSL, page load, domain age, mail host, and AI-crawler policy. Costs one lead per five businesses, on any business you hold, and does not enroll it. Every address it finds is verified at no extra charge. To keep businesses current, use enroll_leads instead. Runs in the background, returns a job id, poll it with get_job_status. Every field follows the three-state contract: a value, a confirmed absence, or unknown.

{
  "type": "object",
  "properties": {
    "result_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "Lead ids from list_results"
    },
    "force": {
      "type": "boolean",
      "description": "Re-enrich rows that already have data (use to refresh stale enrichment). Default false."
    }
  },
  "required": [
    "result_ids"
  ]
}

Enroll leads in enrichment so they stay current: each lead is enriched now and re-checked about once a month for as long as the user keeps it, with change signals when something moves. Costs one lead per two businesses, paid once. Businesses a search found are already enrolled for free; already-enrolled leads and leads without a website are skipped at no cost. Use it for the imported or chosen leads the user cares about most. Runs in the background and returns a job id: poll get_job_status with kind "enrich".

{
  "type": "object",
  "properties": {
    "result_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "Lead ids to enroll"
    }
  },
  "required": [
    "result_ids"
  ]
}

For leads with a website but no named contact, search the open web for the people the business names (owner, founder, director), then resolve and verify their email. Costs 2 leads per named contact found, and nothing for a business where nobody is found; the run reserves 2 per business up front and settles on what it delivered, so the most a run can cost is 2 leads per lead id sent. Separate from enrichment, which already lists the people a business's own site names, with a verified email where one exists, at no extra charge. This is what reaches local business owners who are not in any LinkedIn-derived contact database. Returns a job id, poll with get_job_status. Outcomes per lead: verified (SMTP-confirmed), published (the address is printed on the company's own site but the domain is catch-all so SMTP cannot confirm it), catch_all (person named, no address obtainable), or searched (no name found).

{
  "type": "object",
  "properties": {
    "result_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "Lead ids to search. Only leads with a website and no personal email yet are eligible; ineligible ids are skipped and not charged."
    }
  },
  "required": [
    "result_ids"
  ]
}

SMTP-verify the business emails on saved leads through MillionVerifier. Included in every plan at no charge; a re-check within 90 days reuses the cached verdict. Runs in the background and returns a job id: poll get_job_status with kind "verify" until status is completed, then read the summary. Each address ends in one of four honest states: verified, catch_all (the domain accepts everything, so deliverability cannot be proven), unknown, or invalid. Never treat catch_all as verified.

{
  "type": "object",
  "properties": {
    "result_ids": {
      "type": "array",
      "items": {
        "type": "integer"
      },
      "description": "Lead ids to verify (max 2,000 per call)"
    }
  },
  "required": [
    "result_ids"
  ]
}

Poll a background job started by search_areas, enrich_leads, enroll_leads (kind "enrich"), find_contacts or verify_emails. Pass the job id and its kind. Long jobs are normal: a grid search works through many map points, and enrichment fetches every website in the batch.

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "description": "Job id returned by the starting tool"
    },
    "kind": {
      "type": "string",
      "enum": [
        "search",
        "enrich",
        "contacts",
        "verify",
        "decision_makers"
      ],
      "description": "Which tool started it: search (search_areas), enrich (enrich_leads, enroll_leads), contacts (find_contacts), verify (verify_emails)"
    }
  },
  "required": [
    "job_id",
    "kind"
  ]
}