BGPKIT API v3.0.0
This page is generated from the live OpenAPI specification to stay in sync with the API surface.
BGPKIT API provides access to BGP data and tools offered by BGPKIT. [](https://bgpkit.com)
Base URL
https://api.bgpkit.com
Spec
3.0.0
Endpoint count
13
Examples
These examples are derived from the OpenAPI spec (paths + parameter defaults/examples when provided).
curl
# Search BGP MRT files
curl "https://api.bgpkit.com/v3/broker/search?page=1&page_size=100"
# Get latest BGP MRT files
curl "https://api.bgpkit.com/v3/broker/latest"
# Get BGP peer information
curl "https://api.bgpkit.com/v3/broker/peers?full_feed=false"
# IP address lookup
curl "https://api.bgpkit.com/v3/utils/ip?simple=false"
# ASN information lookup
curl "https://api.bgpkit.com/v3/utils/asn"Tip: if you need a parameter not shown here, scroll down to the endpoint listing for the full parameter set.
Endpoints
Grouped by tag from the OpenAPI spec. Each endpoint includes an auto-generated curl template and parameter list.
BGPKIT Broker
7 endpoint
s
GET
/v3/broker/collectors Get MRT collector information
Get metadata for public MRT route collectors from RouteViews and RIPE RIS projects.
Example
curl "https://api.bgpkit.com/v3/broker/collectors"
curl
curl "https://api.bgpkit.com/v3/broker/collectors"
Parameters
| Name | In | Required | Notes |
|---|---|---|---|
| project | query | no | Filter by collector project ( string ) |
| country | query | no | Filter by country code (e.g., 'US', 'DE', 'JP') ( string ) |
| active | query | no | Filter for active collectors only (not deactivated) ( boolean ) |
GET
/v3/broker/events SSE real-time events
Stream real-time BGP data updates via Server-Sent Events (SSE). Receives notifications when new MRT files are available from RouteViews and RIPE RIS collectors. **Important:** This endpoint returns a 302 redirect to the…
Example
curl "https://api.bgpkit.com/v3/broker/events"
curl
curl "https://api.bgpkit.com/v3/broker/events"
Parameters
| Name | In | Required | Notes |
|---|---|---|---|
| collector_id | query | no | Filter events by collector ID(s). Comma-separated for multiple. Examples: 'rrc23', 'route-views.sg', 'rrc01,rrc02' ( string ) |
| data_type | query | no | Filter by data type: 'rib' or 'updates' ( string ) |
| project | query | no | Filter by project: 'routeviews' or 'riperis' ( string ) |
GET
/v3/broker/health Check broker health
Check BGPKIT broker infrastructure status across deployments. Returns health metrics, uptime, and data freshness. Returns HTTP 500 if data is stale (>1 hour).
Example
curl "https://api.bgpkit.com/v3/broker/health"
curl
curl "https://api.bgpkit.com/v3/broker/health"
Parameters
No
parameters
listed in
the
OpenAPI
spec for
this
endpoint.
GET
/v3/broker/latest Get latest BGP MRT files
Get the most recent BGP MRT files from all active RouteViews and RIPE RIS collectors. Includes delay metrics and download URLs.
Example
curl "https://api.bgpkit.com/v3/broker/latest"
curl
curl "https://api.bgpkit.com/v3/broker/latest"
Parameters
No
parameters
listed in
the
OpenAPI
spec for
this
endpoint.
GET
/v3/broker/peers Get BGP peer information
Get BGP peer statistics from RouteViews and RIPE RIS collectors including IPv4/IPv6 prefix counts, connected ASNs, and activity status.
Example
curl "https://api.bgpkit.com/v3/broker/peers?full_feed=false"
curl
curl "https://api.bgpkit.com/v3/broker/peers?full_feed=false"
Parameters
| Name | In | Required | Notes |
|---|---|---|---|
| full_feed | query | no | Filter for full-feed peers only (>700K IPv4 or >100K IPv6 prefixes) ( boolean ) |
| ip | query | no | Filter by specific peer IP address (IPv4 or IPv6) |
| asn | query | no | Filter by Autonomous System Number ( integer ) |
| collector | query | no | Filter by collector name(s). Comma-separated for multiple collectors. ( string ) |
GET
/v3/broker/search Search BGP MRT files
Search BGP MRT files from RouteViews and RIPE RIS collectors. Returns RIB files and routing updates with download URLs and metadata.
Example
curl "https://api.bgpkit.com/v3/broker/search?page=1&page_size=100"
curl
curl "https://api.bgpkit.com/v3/broker/search?page=1&page_size=100"
Parameters
| Name | In | Required | Notes |
|---|---|---|---|
| page | query | no | Page number (starts from 1) ( integer ) |
| page_size | query | no | Results per page (1-1000, default: 100) ( integer ) |
| ts_start | query | no | Start timestamp (ISO 8601, RFC3339, or Unix timestamp) ( string ) |
| ts_end | query | no | End timestamp (same formats as ts_start) ( string ) |
| project | query | no | Data collection project: "routeviews" or "riperis" ( string ) |
| collector_id | query | no | Specific collector ID(s). Comma-separated for multiple collectors. ( string ) |
| data_type | query | no | Data type: "rib" (routing table snapshots) or "updates" (routing changes) ( string ) |
GET
/v3/broker/streams RouteViews Kafka streams
List all available BGP stream topics from the RouteViews Kafka broker (stream.routeviews.org:9092), grouped by collector. Data is cached hourly in KV and fetched on-demand if the cache is empty.
Example
curl "https://api.bgpkit.com/v3/broker/streams"
curl
curl "https://api.bgpkit.com/v3/broker/streams"
Parameters
| Name | In | Required | Notes |
|---|---|---|---|
| collector | query | no | Filter by broker collector_id (e.g. 'route-views.amsix') or stream_collector name (e.g. 'amsix'). Partial match support… ( string ) |
BGPKIT Utils
5 endpoint
s
GET
/v3/communities Query BGP communities
Query communities by ASN, specific community value, or filters. Supports pagination with default 10 ASNs per page, max 1000.
Example
curl "https://api.bgpkit.com/v3/communities?asn=174&value=174%3A21000&description=blackhole"
curl
curl "https://api.bgpkit.com/v3/communities?asn=174&value=174%3A21000&description=blackhole"
Parameters
| Name | In | Required | Notes |
|---|---|---|---|
| asn | query | no | Filter by ASN number ( string ) |
| value | query | no | Specific community value to lookup (e.g., 174:21000 or 174:20xxx) ( string ) |
| description | query | no | Filter by description text (partial match) ( string ) |
| as_name | query | no | Filter by AS organization name (partial match) ( string ) |
| country | query | no | Filter by country code (ISO 3166-1 alpha-2) ( string ) |
| page | query | no | Page number (0-indexed, default: 0) ( string ) |
| page_size | query | no | Items per page (default: 10, max: 1000) ( string ) |
GET
/v3/communities/sources List community data sources
Get information about all configured data sources
Example
curl "https://api.bgpkit.com/v3/communities/sources"
curl
curl "https://api.bgpkit.com/v3/communities/sources"
Parameters
No
parameters
listed in
the
OpenAPI
spec for
this
endpoint.
GET
/v3/utils/asn ASN information lookup
Get ASN information including organization details, network metrics, geographic presence, and connectivity patterns. Supports single or multiple ASNs (comma-separated), filtering by country, and searching by name/organi…
Example
curl "https://api.bgpkit.com/v3/utils/asn"
curl
curl "https://api.bgpkit.com/v3/utils/asn"
Parameters
| Name | In | Required | Notes |
|---|---|---|---|
| asn | query | no | ASN number(s) to lookup. Single or comma-separated multiple ASNs. Omit for paginated browsing or filtering. ( string ) |
| country | query | no | Filter by country code (ISO 3166-1 alpha-2, e.g., US, DE, JP) ( string ) |
| search | query | no | Search by AS name or organization name (case-insensitive partial match) ( string ) |
| page | query | no | Page number for paginated results when browsing all ASNs ( number ) |
| page_size | query | no | Number of ASNs per page for pagination (max 10000) ( number ) |
POST
/v3/utils/asn Bulk ASNs lookup
Process up to 10,000 ASNs in a single batch request. More efficient than individual requests for large-scale analysis.
Example
curl -X POST "https://api.bgpkit.com/v3/utils/asn"
curl
curl -X POST "https://api.bgpkit.com/v3/utils/asn"
Parameters
No
parameters
listed in
the
OpenAPI
spec for
this
endpoint.
GET
/v3/utils/ip IP address lookup
Get geolocation and network information for IPv4/IPv6 addresses. Returns country, ASN ownership, BGP prefix, and RPKI status. Uses client IP if no address specified.
Example
curl "https://api.bgpkit.com/v3/utils/ip?simple=false"
curl
curl "https://api.bgpkit.com/v3/utils/ip?simple=false"
Parameters
| Name | In | Required | Notes |
|---|---|---|---|
| ip | query | no | IP address to analyze (IPv4 or IPv6). Uses client IP if omitted. ( string ) |
| simple | query | no | Return only IP and country (excludes ASN and BGP data) ( boolean ) |
Metrics
1 endpoint
GET
/v3/metrics Prometheus metrics endpoint
Returns Prometheus-compatible metrics for monitoring. Requires Bearer token authentication.
Example
curl "https://api.bgpkit.com/v3/metrics"
curl
curl "https://api.bgpkit.com/v3/metrics"
Parameters
| Name | In | Required | Notes |
|---|---|---|---|
| authorization | header | no | Bearer bgpkit_public ( string ) |
SDKs
If you prefer an SDK over raw HTTP, use Broker and Parser through the language bindings.