goodleads.club

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "Two-letter state code, e.g. TX. Omit for all live states. Use goodleads_list_live_states for current coverage."
    },
    "vertical_keyword": {
      "type": "string",
      "description": "Business-type keyword matched against the classified industry name, e.g. \"plumbing\", \"trucking\", \"real estate\"."
    },
    "require_phone": {
      "type": "boolean",
      "description": "Only records with a verified phone."
    },
    "require_email": {
      "type": "boolean",
      "description": "Only records with a verified email."
    },
    "limit": {
      "type": "integer",
      "description": "Rows to return, 1-10 (default 5)."
    },
    "filters": {
      "type": "array",
      "description": "Filters follow the one GoodLeads filter contract (85 fields; GET /api/v1/schema/attributes?include=grammar): a leaf is {\"field\", \"op\", \"value\"}; the top-level list is an implicit \"and\"; {\"op\": \"and\"|\"or\", \"filters\": [...]} nests one or more children and {\"op\": \"not\", \"filters\": [one child]} negates. Operators by field type — text: eq, neq, in, not_in, contains, does_not_contain, exists, missing; number: eq, neq, gt, gte, lt, lte, between, in, not_in, exists, missing; date: eq, neq, gt, gte, lt, lte, between, in, not_in, exists, missing; boolean: eq, neq; geo: within. Sort with [{field, dir}] over any of the 76 sortable fields. Keyless callers may not filter on contact_name, email_primary, phone_primary. Live states: CO, CT, FL, NY, OR, TX, VA. Records appear here the morning after the state posts them — speed is measured from publication, never from filing.",
      "items": {
        "type": "object"
      }
    }
  }
}