LeadProof

Price tiers, review-filter multipliers, quantity limits and what a delivered list contains. Call this before quoting if the person wants to compare options.

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

Exact price for a lead list: business types, locations, quantity and optional minimum-review bar. Returns the amount the site charges, what is included and delivery terms. Nothing is created.

{
  "type": "object",
  "properties": {
    "business_types": {
      "type": "array",
      "minItems": 1,
      "maxItems": 10,
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 80
      },
      "description": "Business categories to find, e.g. [\"HVAC contractor\"]. Each one becomes a Google Maps search term."
    },
    "locations": {
      "type": "array",
      "minItems": 1,
      "maxItems": 20,
      "items": {
        "type": "string",
        "minLength": 2,
        "maxLength": 80
      },
      "description": "Cities, regions or countries, e.g. [\"Austin, TX\", \"Dallas, TX\"]. Anything Google Maps can resolve."
    },
    "qty": {
      "type": "integer",
      "minimum": 100,
      "maximum": 1000,
      "description": "How many verified leads to deliver, 100 to 1000."
    },
    "min_reviews": {
      "type": "integer",
      "enum": [
        0,
        30,
        50,
        100
      ],
      "default": 0,
      "description": "Only businesses with at least this many Google reviews. 0 means no filter. A higher bar costs more per lead and screens out more businesses."
    }
  },
  "required": [
    "business_types",
    "locations",
    "qty"
  ],
  "additionalProperties": false
}

A few illustrative rows in the exact delivered format (placeholder businesses on reserved example domains, not real leads), plus the column reference.

{
  "type": "object",
  "properties": {
    "count": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10,
      "default": 5,
      "description": "How many sample rows, 1 to 10."
    }
  },
  "additionalProperties": false
}

A leadproof.co link with the list already configured. The person opens it, reviews the price and pays on the site. Use this when they prefer to finish in a browser. Nothing is created until they order.

{
  "type": "object",
  "properties": {
    "business_types": {
      "type": "array",
      "minItems": 1,
      "maxItems": 10,
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 80
      },
      "description": "Business categories to find, e.g. [\"HVAC contractor\"]. Each one becomes a Google Maps search term."
    },
    "locations": {
      "type": "array",
      "minItems": 1,
      "maxItems": 20,
      "items": {
        "type": "string",
        "minLength": 2,
        "maxLength": 80
      },
      "description": "Cities, regions or countries, e.g. [\"Austin, TX\", \"Dallas, TX\"]. Anything Google Maps can resolve."
    },
    "qty": {
      "type": "integer",
      "minimum": 100,
      "maximum": 1000,
      "description": "How many verified leads to deliver, 100 to 1000."
    },
    "min_reviews": {
      "type": "integer",
      "enum": [
        0,
        30,
        50,
        100
      ],
      "default": 0,
      "description": "Only businesses with at least this many Google reviews. 0 means no filter. A higher bar costs more per lead and screens out more businesses."
    }
  },
  "required": [
    "business_types",
    "locations",
    "qty"
  ],
  "additionalProperties": false
}

Creates the order and returns a PayPal approval link. The PERSON must open the link and approve the payment; nothing is charged until they do. Ask for the delivery email first: the CSV and the order page go there. Returns the order id, the approval link, an order-status link and a status token for get_order_status.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "format": "email",
      "maxLength": 254,
      "description": "Delivery email. The CSV download and order updates go here."
    },
    "business_types": {
      "type": "array",
      "minItems": 1,
      "maxItems": 10,
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 80
      },
      "description": "Business categories to find, e.g. [\"HVAC contractor\"]. Each one becomes a Google Maps search term."
    },
    "locations": {
      "type": "array",
      "minItems": 1,
      "maxItems": 20,
      "items": {
        "type": "string",
        "minLength": 2,
        "maxLength": 80
      },
      "description": "Cities, regions or countries, e.g. [\"Austin, TX\", \"Dallas, TX\"]. Anything Google Maps can resolve."
    },
    "qty": {
      "type": "integer",
      "minimum": 100,
      "maximum": 1000,
      "description": "How many verified leads to deliver, 100 to 1000."
    },
    "min_reviews": {
      "type": "integer",
      "enum": [
        0,
        30,
        50,
        100
      ],
      "default": 0,
      "description": "Only businesses with at least this many Google reviews. 0 means no filter. A higher bar costs more per lead and screens out more businesses."
    }
  },
  "required": [
    "email",
    "business_types",
    "locations",
    "qty"
  ],
  "additionalProperties": false
}

Status of an order created with create_order: awaiting approval, in review, building, delivered (with a download link) or refunded. Needs the order_id and status_token that create_order returned.

{
  "type": "object",
  "properties": {
    "order_id": {
      "type": "string",
      "pattern": "^[a-f0-9-]{36}$",
      "description": "The order id from create_order."
    },
    "status_token": {
      "type": "string",
      "minLength": 8,
      "description": "The status_token from create_order."
    }
  },
  "required": [
    "order_id",
    "status_token"
  ],
  "additionalProperties": false
}