Hat Trick Local Directory

Find youth sports clubs in the Hat Trick Local directory by name, town, state or distance (the listings today are soccer clubs). Use it whenever a person names a club, even vaguely or misspelled: when no listing matches every word, the answer lists candidates with similar names. Each result has the club's org_key (for get_club and the link tools), its town, whether registration is open or upcoming with dates and source, its fee range and how its facts were verified. Coverage is Ohio and Pennsylvania first; no result elsewhere means not in this directory, not that no club exists.

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "Two-letter US state code, for example OH or PA.",
      "pattern": "^[A-Za-z]{2}$"
    },
    "city": {
      "type": "string",
      "description": "Town or city name.",
      "maxLength": 80
    },
    "near": {
      "type": "string",
      "description": "A 5-digit US ZIP code, or latitude,longitude, to search by distance. Results then carry distance_mi."
    },
    "radius_mi": {
      "type": "number",
      "description": "Miles around near (default 25).",
      "minimum": 1,
      "maximum": 250
    },
    "query": {
      "type": "string",
      "description": "Club name, part of a name or a town. Every word must match; when nothing does, similar names come back as candidates.",
      "maxLength": 100
    },
    "registration_open": {
      "type": "boolean",
      "description": "true: only clubs whose registration is open today."
    },
    "registration_status": {
      "type": "string",
      "description": "open (today), upcoming (a window starts later) or not_on_record.",
      "enum": [
        "open",
        "upcoming",
        "not_on_record"
      ]
    },
    "sport": {
      "type": "string",
      "description": "soccer, lacrosse or hockey.",
      "maxLength": 30
    },
    "limit": {
      "type": "integer",
      "description": "How many results (default 10, at most 25).",
      "minimum": 1,
      "maximum": 25,
      "default": 10
    },
    "cursor": {
      "type": "string",
      "description": "next_cursor from the previous answer, for the next page of the same search."
    }
  },
  "additionalProperties": false
}

One club's full listing: contacts, programs, locations, and its current season records (registration windows, fees and tryouts, each with its source link and how it was verified), plus its club website, shop link and action links when it has them.

{
  "type": "object",
  "properties": {
    "org_key": {
      "type": "string",
      "description": "The club's org_key from a search (an older key or a plain slug also works).",
      "maxLength": 200
    }
  },
  "required": [
    "org_key"
  ],
  "additionalProperties": false
}

Registration windows on record across clubs, for questions like 'which clubs in Ohio have registration open now' or 'what opens in January'. Filter by state, town, club name words, status and dates. Each window has its opening and closing dates, season, source link and verification.

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "Two-letter US state code, for example OH or PA.",
      "pattern": "^[A-Za-z]{2}$"
    },
    "city": {
      "type": "string",
      "description": "Town or city name.",
      "maxLength": 80
    },
    "query": {
      "type": "string",
      "description": "Words of a club's name or town.",
      "maxLength": 100
    },
    "status": {
      "type": "string",
      "description": "open (covers today) or upcoming (opens later).",
      "enum": [
        "open",
        "upcoming"
      ]
    },
    "date": {
      "type": "string",
      "description": "Only windows that cover this date (YYYY-MM-DD).",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "from": {
      "type": "string",
      "description": "Only windows overlapping from this date (YYYY-MM-DD).",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "to": {
      "type": "string",
      "description": "Only windows overlapping up to this date (YYYY-MM-DD; a range is at most 400 days).",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "limit": {
      "type": "integer",
      "description": "How many results (default 10, at most 25).",
      "minimum": 1,
      "maximum": 25,
      "default": 10
    },
    "cursor": {
      "type": "string",
      "description": "next_cursor from the previous answer, for the next page of the same search."
    }
  },
  "additionalProperties": false
}

Find local sports stores (soccer stores today) by name, chain, town, state or distance, with address, phone, brands and whether they outfit teams. Each result has the store's org_key for get_store and the link tools.

{
  "type": "object",
  "properties": {
    "state": {
      "type": "string",
      "description": "Two-letter US state code, for example OH or PA.",
      "pattern": "^[A-Za-z]{2}$"
    },
    "city": {
      "type": "string",
      "description": "Town or city name.",
      "maxLength": 80
    },
    "near": {
      "type": "string",
      "description": "A 5-digit US ZIP code, or latitude,longitude, to search by distance. Results then carry distance_mi."
    },
    "radius_mi": {
      "type": "number",
      "description": "Miles around near (default 25).",
      "minimum": 1,
      "maximum": 250
    },
    "query": {
      "type": "string",
      "description": "Store name, chain or town. Every word must match; when nothing does, similar names come back as candidates.",
      "maxLength": 100
    },
    "team_dealer": {
      "type": "boolean",
      "description": "true: only stores that outfit teams (uniforms for clubs)."
    },
    "limit": {
      "type": "integer",
      "description": "How many results (default 10, at most 25).",
      "minimum": 1,
      "maximum": 25,
      "default": 10
    },
    "cursor": {
      "type": "string",
      "description": "next_cursor from the previous answer, for the next page of the same search."
    }
  },
  "additionalProperties": false
}

One store's full listing: address, phone, hours where listed, brands, whether it outfits teams, and its online ordering and action links when it has them.

{
  "type": "object",
  "properties": {
    "org_key": {
      "type": "string",
      "description": "The store's org_key from a search (an older key or a plain slug also works).",
      "maxLength": 200
    }
  },
  "required": [
    "org_key"
  ],
  "additionalProperties": false
}

A link to hand a person who runs a club or store, so they can claim its free listing. Opening it changes nothing: the person fills in and sends the claim on the page. If the listing is already claimed, the person can still send a claim and Hat Trick Local reviews it. Never open the link to submit for the person.

{
  "type": "object",
  "properties": {
    "org_key": {
      "type": "string",
      "description": "The club or store's org_key from a search (an older key or a plain slug also works).",
      "maxLength": 200
    }
  },
  "required": [
    "org_key"
  ],
  "additionalProperties": false
}

A link to hand a person who found something wrong in a listing. It opens the listing with the correction form open (field preselects what is wrong); the person writes and sends it, and Hat Trick Local reviews it before anything changes. Never submit for the person.

{
  "type": "object",
  "properties": {
    "org_key": {
      "type": "string",
      "description": "The listing's org_key from a search.",
      "maxLength": 200
    },
    "field": {
      "type": "string",
      "description": "What is wrong, so the form opens with it chosen.",
      "enum": [
        "name",
        "website",
        "city",
        "email_public",
        "phone_public",
        "description",
        "remove_listing"
      ]
    }
  },
  "required": [
    "org_key"
  ],
  "additionalProperties": false
}

A link to where a club or store sells online through Hat Trick Local (a club's team store or a store's online ordering). Many listings do not sell online; the answer then says so and gives the listing's page. The person chooses and pays there; never order or pay for them.

{
  "type": "object",
  "properties": {
    "org_key": {
      "type": "string",
      "description": "The club or store's org_key from a search (an older key or a plain slug also works).",
      "maxLength": 200
    }
  },
  "required": [
    "org_key"
  ],
  "additionalProperties": false
}