What it returns
Official US State Department travel advisories for every country, as structured rows: the advisory level from 1 (Exercise Normal Precautions) to 4 (Do Not Travel), the risk indicators named in the advisory (crime, terrorism, civil unrest, health, kidnapping, wrongful detention, natural disaster and others), when it was issued or last updated, a link to the official page and the full text. Filter by country, minimum level, or an updated-since date to watch for changes before a trip.
| field | meaning |
|---|---|
| country, iso3, fipsCode | Country name as the State Department writes it, ISO 3166 alpha-3 (when the page gives it), FIPS code |
| level, levelText | 1 to 4 and its wording |
| riskIndicators | Risks named in the advisory's headline sentence |
| someAreasHigherRisk | True when parts of the country carry a higher level |
| published, updated | Dates the advisory was issued and last updated |
| title, url, summary | Headline, official page, full text |
Common uses
- Travel apps and trip planners showing a safety level per destination
- Duty-of-care and corporate travel tools that alert when a country's level changes
- Insurance and risk scoring by country
Request
POST https://api.pushbuild.com/us-travel-advisories/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
countries | list of strings | Country names or ISO 3166 alpha-3 codes, e.g. Mexico, JPN, United Kingdom. Empty: every country. |
minLevel | integer | 1 Exercise Normal Precautions, 2 Increased Caution, 3 Reconsider Travel, 4 Do Not Travel. Default: 1. |
updatedSince | string | YYYY-MM-DD: only advisories issued or updated on or after this date (for change watches). |
includeSummary | boolean | Add the advisory text as plain text. Default: true. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
Example
curl -X POST https://api.pushbuild.com/us-travel-advisories/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"countries": ["Mexico", "Japan"], "maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.16 per 1,000 advisorys. No charge for errors or empty searches.
Related APIs
Private Jet Tracker API: Live Positions & FAA Owners API
Live positions of private and business jets from open ADS-B data, joined to the FAA registry owner: track by tail number, transponder hex, owner name (e.g.
Private Jet Trips API: Flights by Tail, Owner & Airport API
Recent private and business jet trips with departure and arrival airports, times and duration, recorded from open ADS-B data every 10 minutes and joined to FAA registered owners.
Public Holidays API
Public and bank holidays for 100+ countries by year or date range, with regional (state/province) holidays, holiday types, long weekends with bridge days, worldwide upcoming holidays, and an is-it-a-holiday check for any list of dates..
Tide Times API
Official NOAA tide predictions (high/low and hourly), observed water levels, water and air temperature, wind and pressure for 3,000+ US coastal stations.
TSA Checkpoint Travel Numbers + BTS Transportation Stats API
Daily TSA airport checkpoint passenger counts since 2019 with year-over-year and 7-day averages, plus BTS monthly transportation statistics: airline passengers, on-time performance, air cargo, freight rail, trucking, transit and the Transportation Services Index..
US Weather API
National Weather Service data for any US ZIP code, city or coordinates: 7-day forecast, hourly forecast, latest observed conditions and active severe-weather alerts.
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com