Stop Search

Search for bus stops by name. Returns only actual stops — no streets, suburbs, restaurants, or other junk results.

GET/v1/stops/search

Parameters

Parameter	Type	Required	Description
q	string	Required	Stop name search query (e.g. "circular quay")
limit	integer	Optional	Max results. Default: 10

Example

cURL

curl "https://api.transitkit.dev/v1/stops/search?q=circular+quay" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

200 OK

{
  "query": "circular quay",
  "results": [
    {
      "stop_id": "200060",
      "name": "Circular Quay, Stand A",
      "suburb": "Sydney"
    },
    {
      "stop_id": "200061",
      "name": "Circular Quay, Stand B",
      "suburb": "Sydney"
    }
  ]
}

Response Fields

Field	Type	Description
stop_id	string	TfNSW stop identifier
name	string	Full stop name
suburb	string	Suburb or locality

Why this matters: Searching for "Newtown" in the raw TfNSW API returns 48 results — streets, suburbs, restaurants, and parks. The actual stop is at position 48. TransitKit returns only stops.