Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
contact:
url: https://www.transcapi.com
description: 'Public transport data for Great Britain (England, Scotland and Wales): stops and places, bus and rail departures and arrivals with live running, routes and services, live bus positions, disruptions and journey planning. Every departure says in `source` whether its time is live or timetabled. Data is official open data; attribution requirements are at https://www.transcapi.com/docs/data-sources.'
termsOfService: https://www.transcapi.com/terms
title: TransC Places API
version: 1.0.0
servers:
- description: Production
url: https://api.transcapi.com
security:
- ApiKeyHeader: []
- ApiKeyQuery: []
tags:
- name: Places
paths:
/v1/places.json:
get:
description: Streets and landmarks (schools, hospitals, parks, hills, lakes) are Great Britain only, from OS Open Names. A street is matched with its town when the query names one, "Broad Street, Sheffield" or "broad street sheffield"; otherwise nearest to lat/lon, or in the largest towns first.
parameters:
- description: Free text search term
in: query
name: query
schema:
type: string
- explode: true
in: query
name: type
schema:
items:
enum:
- bus_stop
- train_station
- tram_stop
- settlement
- postcode
- street
- landmark
- airport
type: string
type: array
style: form
- in: query
name: lat
schema:
type: number
- in: query
name: lon
schema:
type: number
- in: query
name: min_lat
schema:
type: number
- in: query
name: min_lon
schema:
type: number
- in: query
name: max_lat
schema:
type: number
- in: query
name: max_lon
schema:
type: number
- in: query
name: limit
schema:
default: 20
type: integer
- in: query
name: page
schema:
default: 1
type: integer
responses:
'200':
description: List of matching places
summary: Search for places (stops, settlements, postcodes, streets, landmarks)
tags:
- Places
operationId: getV1PlacesJson
x-operation-id-source: derived
components:
securitySchemes:
ApiKeyHeader:
in: header
name: X-Api-Key
type: apiKey
ApiKeyQuery:
in: query
name: api_key
type: apiKey