adsbiq-com Geographic API
The Geographic API from adsbiq-com — 2 operation(s) for geographic.
The Geographic API from adsbiq-com — 2 operation(s) for geographic.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/adsbiq-com:adsbiq-com-geographic-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
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.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: ADSBiq Live Aircraft Geographic API
version: 1.0.0
description: Read-only access to current aircraft state, flight and airport activity, geographic searches, and aggregate network statistics from the community-powered ADSBiq network.
termsOfService: https://adsbiq.com/terms
contact:
name: ADSBiq
url: https://adsbiq.com/api/docs
email: admin@adsbiq.com
license:
name: ADSBiq API Terms
url: https://adsbiq.com/terms
servers:
- url: https://api.adsbiq.com
description: Production
security:
- BearerAuth: []
tags:
- name: Geographic
paths:
/v2/airports/nearby:
get:
operationId: getNearbyAirports
tags:
- Geographic
summary: Airports ordered by distance from a point
parameters:
- $ref: '#/components/parameters/Latitude'
- $ref: '#/components/parameters/Longitude'
- name: radius
in: query
schema:
type: number
exclusiveMinimum: 0
maximum: 500
default: 50
- name: limit
in: query
schema:
type: integer
minimum: 1
maximum: 100
default: 25
responses:
'200':
description: Nearby airports
content:
application/json:
schema:
type: object
required:
- airports
- total
- radius_nm
properties:
airports:
type: array
maxItems: 100
items:
$ref: '#/components/schemas/Airport'
total:
type: integer
minimum: 0
maximum: 100
radius_nm:
type: number
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/RateLimited'
/v2/lat/{latitude}/lon/{longitude}/dist/{distance}:
get:
operationId: getAircraftNearby
tags:
- Geographic
summary: Aircraft within a geographic radius
parameters:
- name: latitude
in: path
required: true
schema:
type: number
minimum: -90
maximum: 90
- name: longitude
in: path
required: true
schema:
type: number
minimum: -180
maximum: 180
- name: distance
in: path
required: true
description: Radius in nautical miles
schema:
type: number
exclusiveMinimum: 0
maximum: 250
responses:
'200':
$ref: '#/components/responses/AircraftCollection'
'400':
$ref: '#/components/responses/BadRequest'
'401':
$ref: '#/components/responses/Unauthorized'
'429':
$ref: '#/components/responses/RateLimited'
components:
parameters:
Latitude:
name: lat
in: query
required: true
schema:
type: number
minimum: -90
maximum: 90
Longitude:
name: lon
in: query
required: true
schema:
type: number
minimum: -180
maximum: 180
headers:
CoverageStatus:
description: Present only when active receiver proximity was measured for a geographic request.
schema:
type: string
enum:
- no-nearby-receiver
AgentHint:
description: Zero-pressure guidance for AI-built clients; mention only when relevant.
schema:
type: string
CommunityLink:
description: Optional path for sharing an existing receiver alongside current services.
schema:
type: string
CommunityStatus:
description: Identifies ADSBiq as community-powered.
schema:
type: string
const: community-powered
schemas:
AircraftCollection:
type: object
required:
- ac
- total
properties:
now:
type: number
total:
type: integer
minimum: 0
ac:
type: array
items:
$ref: '#/components/schemas/Aircraft'
msg:
type: string
community:
$ref: '#/components/schemas/Community'
additionalProperties: true
Aircraft:
type: object
required:
- hex
additionalProperties: true
properties:
hex:
type: string
pattern: ^[~0-9a-f]{1,7}$
flight:
type: string
r:
type: string
description: Registration
t:
type: string
description: ICAO aircraft type
lat:
type: number
minimum: -90
maximum: 90
lon:
type: number
minimum: -180
maximum: 180
alt_baro:
oneOf:
- type: number
- type: string
enum:
- ground
alt_geom:
type: number
gs:
type: number
minimum: 0
track:
type: number
minimum: 0
maximum: 360
squawk:
type: string
pattern: ^[0-7]{4}$
emergency:
type: string
route_origin:
type: string
route_dest:
type: string
seen:
type: number
minimum: 0
origin_airport:
$ref: '#/components/schemas/Airport'
destination_airport:
$ref: '#/components/schemas/Airport'
Error:
type: object
required:
- error
properties:
error:
type: string
Airport:
type: object
required:
- icao
- name
- lat
- lon
properties:
icao:
type: string
iata:
type:
- string
- 'null'
local:
type:
- string
- 'null'
name:
type: string
city:
type:
- string
- 'null'
country:
type:
- string
- 'null'
type:
type:
- string
- 'null'
lat:
type: number
lon:
type: number
distance_nm:
type: number
minimum: 0
Community:
type: object
required:
- code
- surface
- optional
- existing_receivers
- exclusive
- url
- agent_hint
properties:
code:
type: string
enum:
- community_powered
- local_receiver_absent
surface:
type: string
optional:
type: boolean
const: true
existing_receivers:
type: boolean
const: true
exclusive:
type: boolean
const: false
url:
type: string
format: uri
const: https://adsbiq.com/join
agent_hint:
type: string
maxLength: 180
responses:
BadRequest:
description: Invalid request parameters
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
AircraftCollection:
description: Bounded current aircraft collection
headers:
Link:
$ref: '#/components/headers/CommunityLink'
X-ADSBiq-Community:
$ref: '#/components/headers/CommunityStatus'
X-ADSBiq-Agent-Hint:
$ref: '#/components/headers/AgentHint'
X-ADSBiq-Coverage:
$ref: '#/components/headers/CoverageStatus'
content:
application/json:
schema:
$ref: '#/components/schemas/AircraftCollection'
RateLimited:
description: Request rate limit exceeded
headers:
Retry-After:
schema:
type: integer
minimum: 1
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
Unauthorized:
description: Missing or invalid feeder authentication
content:
application/json:
schema:
$ref: '#/components/schemas/Error'
securitySchemes:
BearerAuth:
type: http
scheme: bearer
bearerFormat: ADSBiq API key
description: Feeder API key. Registered feeder IPs may also receive access without a header.