Map
Help
News
About
Upgrade
Contact
Dashboard
Register
Login
« Hide Menu Emergency Help
Configure
FLARM devices Oudie & SeeYou Navigator IGC Droid InReach ADSB XContest & XCTrack Syride Devices Satellite Trackers Mobile satellite tracking SSA Contests SoaringSpot Contests FFVL Tracking
Safety Tracking / Watchlist
Pilots Guide Admin Guide States reference
How To
Keyboard shortcuts Setup Alerts View track history Training Videos on YouTube Linking & Embedding PureTrack
For Developers
Insert API Traffic API Feed API PureTrack Label Export
About PureTrack
PureTrack Compared Supported Trackers Buy a Tracker PureTrack on Facebook Training Videos on YouTube FAQ Logo assets Release Notes Terms & Conditions

PureTrack Feed API

The feed API provides approved applications with paginated access to PureTrack live tracking data. Data is sorted by insert timestamp + batch + row number, meaning you can always pull from the last point received, without missing any data.

Requirements:

  • A data feed licence. Contact us to discuss.
  • Data feed API Key.

What this API is for:

  • Commercial use.
  • Pulling complete PureTrack data into your own systems.

To implement PureTrack data as a layer for users to see in your own app, see the traffic API.

Endpoint and authentication

GET https://feed.puretrack.io/api/feed

Send the API key in the X-API-Key header. Send Accept: application/json with each request.

curl -H "Accept: application/json" -H "X-API-Key: your-api-key" "https://feed.puretrack.io/api/feed?start=1713590000:0:0"

Retention and paging

  • Points are available approximately 24 hours.
  • A response contains at most 30,000 points. Persist the returned next value and use it as the next request's start.
  • The cursor format is currently unix_timestamp:batch:row_number, but it is opaque: store and resend it as a string. Do not parse, increment, or generate it. Keep the same filters while following a cursor.

Query parameters

ParameterDescription
startRequired cursor. Use a timestamp within the previous 24 hours followed by :0:0 for an initial request, or use the exact next cursor from a previous response. Note this is the inserted timestamp, not the point timestamp.
endOptional inclusive cursor at which to stop.
limitOptional number of points to return, from 1 to 30,000. Defaults to 30,000.
type_idsOptional comma-separated list of object type IDs.
source_idsOptional comma-separated list of source type IDs.
keysOptional comma-separated list of tracker keys to include, for example Y-ZK-GOP,X-timbo. A maximum of 100 keys may be supplied.
lat1, long1, lat2, long2Optional bounding-box corners, matching the other PureTrack APIs. Supply all four values together; their order does not matter.
GET https://feed.puretrack.io/api/feed?start=1713590000:0:0&keys=Y-ZK-GOP,X-timbo&lat1=-37.82614&long1=175.32898&lat2=-37.78996&long2=175.29426

Response

The data array contains compact, compressed point strings. Each string includes the tracker's point timestamp; the insert timestamp, batch, and row number are used only inside the opaque pagination cursor.

{ "data": [ "T1713592582,L-37.78174,G174.88159,A4685,C338,S144.05,O56,DC828EA,U12,EZK-MZE,KY-ZK-MZE" ], "next": "1713592586:4:37", "has_more": false, "success": true, "http_code": 200 }

To decode the data format, see the Traffic API page for details.

Privacy

Stealth points are excluded. The point payload excludes names and phone numbers, unless included as the main label.


PureTrack.io