{"uid":"cap_xrfpETYKc7hlNEPmHUGoD","slug":"usgs-earthquake-bulk-export-591f40bf","name":"USGS Earthquake Bulk Export","description":"USGS earthquakes in a date window (up to 31 days) above a minimum magnitude: time, magnitude, place, lat/lon, depth.","url":"https://bulk-exports.x402tookit.com/earthquakes-export?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["from"],"properties":{"to":{"type":"string","description":"Last UTC day, YYYY-MM-DD (default = from; window up to 31 days)"},"from":{"type":"string","description":"First UTC day, YYYY-MM-DD"},"format":{"type":"string","description":"json (default) or csv"},"minMagnitude":{"type":"string","description":"Minimum magnitude 0 to 9 (default 4.5)"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"to":{"type":["null","string"]},"asOf":{"type":["null","string"]},"from":{"type":["null","string"]},"rows":{"type":["array","null"],"items":{"type":"object","properties":{"id":{"type":["null","string"]},"url":{"type":["null","string"]},"time":{"type":["null","string"]},"alert":{"type":["null","string"]},"place":{"type":["null","string"]},"status":{"type":["null","string"]},"depthKm":{"type":["null","number"]},"magType":{"type":["null","string"]},"tsunami":{"type":["boolean","null"]},"latitude":{"type":["null","number"]},"longitude":{"type":["null","number"]},"magnitude":{"type":["null","number"]}}}},"format":{"type":["null","string"]},"source":{"type":["null","string"]},"columns":{"type":["array","null"],"items":{"type":"string"}},"reasons":{"type":["array","null"],"items":{"type":"string"}},"summary":{"type":["null","string"]},"verdict":{"type":["null","string"]},"degraded":{"type":["boolean","null"]},"returned":{"type":["null","number"]},"sourceUrl":{"type":["null","string"]},"truncated":{"type":["boolean","null"]},"disclaimer":{"type":["null","string"]},"notChecked":{"type":["array","null"],"items":{"type":"string"}},"minMagnitude":{"type":["null","number"]}}}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_YOLyOGWwpBsiHS1w7X81r","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns USGS earthquake data (time, magnitude, location, depth) for a date window up to 31 days above a minimum magnitude threshold.","exampleAgentPrompt":"Pull all earthquakes magnitude 5.0 or higher from January 1 to January 31, 2025 and give me the results as JSON with time, place, magnitude, lat/lon, and depth.","exampleUseCases":[{"title":"Monthly seismic activity report","prompt":"Get me all earthquakes of magnitude 4.5 or greater that happened in March 2025, formatted as JSON, so I can put together a monthly seismic activity summary."},{"title":"High-magnitude global earthquake alert review","prompt":"Can you pull every earthquake above magnitude 6.0 from the past two weeks? I want to see where the biggest ones hit, their depths, and whether any triggered tsunami alerts."},{"title":"Export earthquake data for GIS mapping","prompt":"Download all USGS earthquake records from April 1 to April 30, 2025 with a minimum magnitude of 3.0 in CSV format — I need the lat/lon and depth columns for mapping in GIS software."}],"resultDescription":"Returns a structured response containing a list of earthquake events with fields: event ID, timestamp, magnitude, magnitude type, place name, latitude, longitude, depth in km, alert level, tsunami flag, USGS event URL, and status. Also includes metadata such as date range, total rows returned, format, source URL, and whether results were truncated.","failureModes":["Date range exceeds 31 days — endpoint rejects with an error; split into multiple shorter windows","Invalid date format (not YYYY-MM-DD) — returns a parsing error","minMagnitude outside 0–9 range — may be rejected or clamped","No earthquakes in the requested window/magnitude — returns empty rows array","USGS upstream data source unavailable — degraded flag may be set in response","Missing required 'from' parameter — request fails validation"],"whenToPreferThis":"Choose this endpoint when you need bulk structured earthquake data from USGS for a specific date range (up to 31 days) with a configurable magnitude threshold, especially for downstream analysis, GIS mapping, reporting, or monitoring pipelines. It is preferable to manual USGS API calls because it wraps pagination and filtering into a single paid call, returns clean JSON or CSV, and includes metadata like truncation flags and source URLs. Not suitable for real-time streaming or windows longer than 31 days.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-11-02T18:32:43.635Z","isFirstParty":false,"canonicalSlug":"usgs-earthquake-bulk-export-591f40bf"}