{"uid":"cap_Em3u8e3WJbR6DHj0X3jlI","slug":"quakes-withzero-ai-usgs-real-time-earthquake-data-f1e3ad88","name":"USGS Real-Time Earthquake Data","description":"Real-time earthquake data from USGS. Query recent earthquakes by time period and minimum magnitude. Optionally filter by geographic radius. Returns magnitude, location, depth, and tsunami warnings.","url":"https://quakes.withzero.ai/run","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"period":{"enum":["hour","day","week","month"],"type":"string","description":"Time period (default \"day\")"},"latitude":{"type":"number","maximum":90,"minimum":-90,"description":"Filter: center latitude for radius search (-90 to 90)"},"longitude":{"type":"number","maximum":180,"minimum":-180,"description":"Filter: center longitude for radius search (-180 to 180)"},"maxRadiusKm":{"type":"number","maximum":20000,"minimum":0,"description":"Filter: max radius in km from lat/lon (default 500)","exclusiveMinimum":true},"minMagnitude":{"enum":["1.0","2.5","4.5","significant"],"type":"string","description":"Minimum magnitude threshold (default \"2.5\")"}},"additionalProperties":false},"responseSchema":{"type":"object","required":["earthquakes","total","period"],"properties":{"total":{"type":"number","description":"Total earthquakes matching criteria"},"period":{"type":"string","description":"Time period queried"},"earthquakes":{"type":"array","items":{"type":"object","required":["magnitude","place","time","latitude","longitude","depth","url","tsunami"],"properties":{"url":{"type":"string","description":"USGS detail URL"},"time":{"type":"string","description":"Time of earthquake (ISO 8601)"},"alert":{"type":"string","description":"Alert level (green, yellow, orange, red)"},"depth":{"type":"number","description":"Depth in km"},"place":{"type":"string","description":"Location description (e.g. \"45 km E of Chenega, Alaska\")"},"tsunami":{"type":"boolean","description":"Whether a tsunami warning was issued"},"latitude":{"type":"number","description":"Latitude"},"longitude":{"type":"number","description":"Longitude"},"magnitude":{"type":"number","description":"Earthquake magnitude"}},"additionalProperties":false},"description":"List of earthquakes, newest first"}},"additionalProperties":false},"example":null,"exampleRequest":null,"tags":[],"displayCostAmount":"0.001","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.001/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.001","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.001","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm__i2YOUVnj1wHEgTyZIY88","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.001","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":"earthquake-alerts:1"}],"brandName":"quakes.withzero.ai","brandSlug":"quakes-withzero-ai-mpp","brandBaseUrl":"https://quakes.withzero.ai","brandDocsUrl":null,"whatItDoes":"Queries USGS real-time earthquake data by time period, minimum magnitude, and optional geographic radius, returning location, depth, magnitude, and tsunami warnings.","exampleAgentPrompt":"Show me all earthquakes of magnitude 4.5 or greater that happened in the last week within 500 km of Tokyo (latitude 35.68, longitude 139.69), and flag any tsunami warnings.","exampleUseCases":null,"resultDescription":"Returns a list of earthquakes sorted newest first, each with magnitude, human-readable location, ISO 8601 timestamp, latitude/longitude, depth in km, tsunami warning boolean, optional alert level (green/yellow/orange/red), and a USGS detail URL — plus a total count and the queried time period.","failureModes":["Invalid period enum value returns validation error","minMagnitude must be one of the allowed enum strings, not a raw number","maxRadiusKm must be greater than 0 (exclusiveMinimum)","latitude/longitude out of range (-90 to 90 and -180 to 180) returns error","If lat/lon provided without maxRadiusKm, defaults to 500 km radius","USGS upstream unavailable may return 503 or empty results","No earthquakes matching criteria returns empty array with total=0"],"whenToPreferThis":"Use this endpoint when you need real-time or recent USGS earthquake data with flexible filtering by time window, magnitude threshold, and geographic area. Ideal for monitoring seismic activity, alerting on tsunami warnings, or building disaster-awareness features. Prefer this over static datasets when up-to-the-minute data matters.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:33:02.112Z","isFirstParty":true}