PublicLeads

List every industry (trade) PublicLeads sells business lists for, with the slug to pass to search_lists, plus the countries covered (US, Canada, Australia). Call this when the user's industry may not match a name directly.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Find ready-made business contact lists for sale by industry and location. Returns up to 10 lists, best match first (the exact city, then its state/province, then the country): name, scope, number of businesses, how many have an email, price, and preview and buy links. Location can be a city ("Austin", "Austin, TX"), a state or province ("Ontario"), or a country ("USA", "Canada", "Australia"); spelling is matched loosely. Use when someone needs leads or prospects of a type of local business.

{
  "type": "object",
  "properties": {
    "trade": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "Industry, as a slug from list_trades or in plain words, e.g. \"dentists\", \"hvac\", \"real estate agents\", \"businesses without a website\"."
    },
    "location": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "City, state/province or country in the US, Canada or Australia, e.g. \"Austin, TX\", \"Ontario\", \"USA\"."
    }
  },
  "required": [
    "trade",
    "location"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Details of one list from search_lists: the fields included in the file, the price, the freshness policy, and a masked 5-row sample (business name, city, Google rating; emails and phones are masked). Pass the list value search_lists returned, or the list's publicleads.com URL.

{
  "type": "object",
  "properties": {
    "list": {
      "type": "string",
      "minLength": 1,
      "maxLength": 300,
      "description": "The \"list\" value from search_lists, e.g. \"/dentists/usa/texas/austin\", or the list page URL."
    }
  },
  "required": [
    "list"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Aggregate statistics for an industry in a place: number of operational businesses, average Google rating, total reviews, and the percentage with an email, with a company-domain email, with a phone, with a website and with a street address. No contact details. Use for market-sizing questions such as "how many plumbers are there in Ohio".

{
  "type": "object",
  "properties": {
    "trade": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "Industry, as a slug from list_trades or in plain words."
    },
    "location": {
      "type": "string",
      "minLength": 1,
      "maxLength": 80,
      "description": "City, state/province or country in the US, Canada or Australia."
    }
  },
  "required": [
    "trade",
    "location"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

When no ready-made list fits (an unusual industry, a county or a radius, several industries together), return the link to request a custom list and its price. We measure the data and reply with the real count before any payment.

{
  "type": "object",
  "properties": {
    "description": {
      "type": "string",
      "maxLength": 300,
      "description": "Optional: who the user is looking for, in their own words (logged as a demand signal, never shown to anyone)."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}