{"uid":"cap_TLk2zxGSgyOfpq0a74seQ","slug":"bnm-data-shop-usda-fas-gain-attach-reports-98951b49","name":"BNM Data Shop – USDA FAS GAIN Attaché Reports","description":"Official public data as JSON. Unpaid paid routes return HTTP 402.","url":"https://ticks.bnm.farm/gain?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","HEAD","DELETE"],"type":"string"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":false},"output":{"type":"object","properties":{"type":{"type":"string"},"schema":{"type":"object"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","schema":{"type":"object","required":["ok","product","status","fetchedAt","asOf","source","recordCount","records","cards"],"properties":{"ok":{"type":"boolean"},"asOf":{"type":"string"},"cards":{"type":"array","items":{"type":"object"}},"source":{"type":"string"},"status":{"type":"string"},"product":{"type":"string"},"records":{"type":"array","items":{"type":"object"}},"fetchedAt":{"type":"string"},"recordCount":{"type":"integer"}}},"example":{"ok":true,"asOf":"2026-08-24","cards":[{"id":"MX2026-0040","body":"This teaser is not an official attaché body. USDA FAS GAIN MX2026-0040 excerpt.","date":"2026-08-24","post":"Mexico City","country":"Mexico","category":"Livestock and Products","sourceUrl":"https://apps.fas.usda.gov/newgainapi/api/Report/DownloadReportByFileName?fileName=Livestock%20and%20Products%20Annual_Mexico%20City_Mexico_MX2026-0040.pdf","reportNumber":"MX2026-0040"}],"source":"https://gain.fas.usda.gov/","status":"ok","product":"gain-attache-report-bodies","records":[{"id":"MX2026-0040","url":"https://apps.fas.usda.gov/newgainapi/api/Report/DownloadReportByFileName?fileName=Livestock%20and%20Products%20Annual_Mexico%20City_Mexico_MX2026-0040.pdf","date":"2026-08-24","firm":"Mexico","type":"gain"}],"fetchedAt":"2026-08-27T21:37:10.176Z","recordCount":1}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_nYnXHAjC_ogorSOOSuQ7u","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns USDA Foreign Agricultural Service GAIN (Global Agricultural Information Network) attaché report records and card summaries as JSON","exampleAgentPrompt":"Can you pull the latest USDA FAS GAIN attaché reports as structured JSON — I want the records and card summaries including report IDs, countries, categories, and source URLs?","exampleUseCases":[{"title":"Tracking livestock trade intelligence","prompt":"Get me the latest USDA GAIN attaché reports on livestock and products so I can see which countries have new annual reports and what their source URLs are."},{"title":"Agricultural market research pipeline","prompt":"Fetch all the current USDA FAS GAIN report records as JSON — I need the report IDs, dates, country names, and download links to feed into my agricultural market analysis tool."},{"title":"Monitoring foreign agricultural conditions","prompt":"Pull the GAIN attaché report data right now so I can check what new country-level agricultural intelligence reports have been published and when they were last updated."}],"resultDescription":"A JSON object with ok status, product name ('gain-attache-report-bodies'), asOf date, fetchedAt timestamp, source URL, total recordCount, an array of records (each with id, url, date, firm/country, type), and an array of cards (each with id, body excerpt, date, post, country, category, sourceUrl, reportNumber).","failureModes":["HTTP 402 if payment not included — endpoint requires $0.05 USDC via x402 protocol","Empty records array if no new reports are available for the queried period","Stale data if upstream USDA FAS GAIN source is delayed or unavailable","Network timeout if upstream GAIN API is slow to respond","Malformed response if upstream source structure changes"],"whenToPreferThis":"Choose this endpoint when you need structured, machine-readable JSON access to USDA FAS GAIN attaché reports without scraping the USDA website directly. It is the right choice for agents that need agricultural intelligence data (livestock, commodities, country-level reports) with consistent schema, card summaries, and direct PDF source links, all delivered for a flat $0.05 per call via x402 micropayment.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:43:03.395Z","isFirstParty":false,"canonicalSlug":"bnm-data-shop-usda-fas-gain-attach-reports-98951b49"}