data-analyst-mcp 0.3.0 → 0.3.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +262 -262
- package/dist/report/method_audit.js +7 -1
- package/dist/report/method_audit.js.map +1 -1
- package/dist/report/scan_secrets.d.ts +4 -1
- package/dist/report/scan_secrets.js +36 -5
- package/dist/report/scan_secrets.js.map +1 -1
- package/dist/server.d.ts +1 -1
- package/dist/server.js +3 -2
- package/dist/server.js.map +1 -1
- package/guide/WORKFLOW.md +134 -134
- package/guide/assets/disclaimer.txt +1 -1
- package/guide/assets/download_data.ps1 +162 -162
- package/guide/assets/report_template.html +597 -597
- package/guide/references/routing.md +171 -171
- package/guide/references/style_guide.md +398 -398
- package/package.json +56 -56
- package/packs/acf/endpoints.json +114 -114
- package/packs/acf/policy.json +104 -104
- package/packs/actuaries/endpoints.json +82 -82
- package/packs/actuaries/policy.json +109 -109
- package/packs/bea/assets/download_bea.ps1 +182 -182
- package/packs/bea/docs/bea_api.md +461 -461
- package/packs/bea/docs/datasets.md +157 -157
- package/packs/bea/docs/report_patterns.md +112 -112
- package/packs/bea/policy.json +170 -170
- package/packs/bea/source.md +152 -152
- package/packs/bls/assets/download_bls.ps1 +152 -152
- package/packs/bls/docs/analysis_patterns.md +108 -108
- package/packs/bls/docs/bls_api.md +73 -73
- package/packs/bls/docs/series_ids.md +149 -149
- package/packs/bls/policy.json +238 -238
- package/packs/bts/endpoints.json +346 -346
- package/packs/bts/policy.json +94 -94
- package/packs/cdc/endpoints.json +197 -197
- package/packs/cdc/policy.json +83 -83
- package/packs/census/endpoints.json +99 -99
- package/packs/cfpb/endpoints.json +326 -326
- package/packs/cfpb/policy.json +119 -119
- package/packs/clinical-trials/endpoints.json +166 -166
- package/packs/clinical-trials/policy.json +84 -84
- package/packs/cms/endpoints.json +69 -69
- package/packs/cms/policy.json +96 -96
- package/packs/college-scorecard/endpoints.json +252 -252
- package/packs/college-scorecard/policy.json +106 -106
- package/packs/congress/endpoints.json +1701 -1701
- package/packs/congress/policy.json +117 -117
- package/packs/dhs-ohss/endpoints.json +66 -66
- package/packs/dhs-ohss/policy.json +107 -107
- package/packs/doj-news/endpoints.json +59 -59
- package/packs/doj-news/policy.json +96 -96
- package/packs/dol/endpoints.json +817 -817
- package/packs/dol/policy.json +135 -135
- package/packs/eia/endpoints.json +717 -717
- package/packs/eia/policy.json +112 -112
- package/packs/epa/endpoints.json +291 -291
- package/packs/epa/policy.json +99 -99
- package/packs/epa-aqs/endpoints.json +173 -173
- package/packs/epa-aqs/policy.json +96 -96
- package/packs/fbi/endpoints.json +1841 -1841
- package/packs/fbi/policy.json +118 -118
- package/packs/fda/endpoints.json +237 -237
- package/packs/fda/policy.json +121 -121
- package/packs/fdic/endpoints.json +416 -416
- package/packs/fdic/policy.json +83 -83
- package/packs/fec/endpoints.json +707 -707
- package/packs/fec/policy.json +93 -93
- package/packs/fed-board/endpoints.json +89 -89
- package/packs/fed-board/policy.json +136 -136
- package/packs/federal-register/endpoints.json +143 -143
- package/packs/federal-register/policy.json +86 -86
- package/packs/fema/endpoints.json +645 -645
- package/packs/fema/policy.json +103 -103
- package/packs/fhfa/endpoints.json +105 -105
- package/packs/fhfa/policy.json +109 -109
- package/packs/fred/assets/download_fred.ps1 +122 -122
- package/packs/fred/docs/analysis_patterns.md +124 -124
- package/packs/fred/docs/fred_api.md +94 -94
- package/packs/fred/docs/series.md +188 -188
- package/packs/fred/policy.json +253 -253
- package/packs/fsa/endpoints.json +150 -150
- package/packs/fsa/policy.json +99 -99
- package/packs/govinfo/endpoints.json +519 -519
- package/packs/gsa-calc/endpoints.json +93 -93
- package/packs/gsa-calc/policy.json +97 -97
- package/packs/hud/endpoints.json +146 -146
- package/packs/hud/policy.json +84 -84
- package/packs/ipums/docs/report_patterns.md +117 -117
- package/packs/irs-soi/endpoints.json +114 -114
- package/packs/irs-soi/policy.json +107 -107
- package/packs/medicaid/endpoints.json +412 -412
- package/packs/medicaid/policy.json +108 -108
- package/packs/naep/endpoints.json +217 -217
- package/packs/naep/policy.json +100 -100
- package/packs/nhtsa/endpoints.json +132 -132
- package/packs/nhtsa/policy.json +93 -93
- package/packs/nih/endpoints.json +452 -452
- package/packs/nih/policy.json +86 -86
- package/packs/noaa/endpoints.json +431 -431
- package/packs/noaa/policy.json +95 -95
- package/packs/nrel/endpoints.json +327 -327
- package/packs/nrel/policy.json +96 -96
- package/packs/nws/endpoints.json +271 -271
- package/packs/nws/policy.json +82 -82
- package/packs/nyfed/endpoints.json +80 -80
- package/packs/nyfed/policy.json +92 -92
- package/packs/omb/endpoints.json +460 -460
- package/packs/omb/policy.json +106 -106
- package/packs/open-payments/endpoints.json +297 -297
- package/packs/open-payments/policy.json +101 -101
- package/packs/opm/assets/download_opm.ps1 +125 -125
- package/packs/opm/docs/fields.md +184 -184
- package/packs/opm/docs/opm_api.md +71 -71
- package/packs/opm/docs/report_patterns.md +83 -83
- package/packs/opm/lib/data_dictionary.csv +73 -73
- package/packs/pbgc/endpoints.json +483 -483
- package/packs/pbgc/policy.json +94 -94
- package/packs/philfed/endpoints.json +85 -85
- package/packs/philfed/policy.json +94 -94
- package/packs/regulations/endpoints.json +287 -287
- package/packs/regulations/policy.json +86 -86
- package/packs/sec/endpoints.json +236 -236
- package/packs/sec/policy.json +86 -86
- package/packs/senate-lobbying/endpoints.json +553 -553
- package/packs/senate-lobbying/policy.json +99 -99
- package/packs/snapqc/endpoints.json +1426 -1426
- package/packs/snapqc/policy.json +92 -92
- package/packs/treasury/catalog.json +2267 -2267
- package/packs/treasury/docs/api_guide.md +245 -245
- package/packs/treasury/docs/datasets.md +56 -56
- package/packs/treasury/docs/report_patterns.md +126 -126
- package/packs/treasury/policy.json +159 -159
- package/packs/treasury/source.md +170 -165
- package/packs/treasury-yields/endpoints.json +226 -226
- package/packs/treasury-yields/policy.json +86 -86
- package/packs/usaspending/endpoints.json +1315 -1315
- package/packs/usaspending/policy.json +109 -109
- package/packs/usda-fna/policy.json +133 -133
- package/packs/usda-fooddata/endpoints.json +180 -180
- package/packs/usda-fooddata/policy.json +94 -94
- package/packs/usda-nass/endpoints.json +323 -323
- package/packs/usda-nass/policy.json +95 -95
- package/packs/usda-outlook/endpoints.json +86 -86
- package/packs/usda-outlook/policy.json +109 -109
- package/packs/usgs/endpoints.json +313 -313
- package/packs/usgs/policy.json +95 -95
- package/packs/usitc/endpoints.json +74 -74
- package/packs/usitc/policy.json +111 -111
- package/packs/uspto/endpoints.json +141 -141
- package/packs/uspto/policy.json +95 -95
- package/packs/va/endpoints.json +414 -414
- package/packs/va/policy.json +101 -101
- package/packs/world-bank/endpoints.json +122 -122
- package/packs/world-bank/policy.json +101 -101
|
@@ -1,95 +1,95 @@
|
|
|
1
|
-
{
|
|
2
|
-
"id": "usda-nass",
|
|
3
|
-
"title": "USDA NASS Quick Stats",
|
|
4
|
-
"agency": "U.S. Department of Agriculture, National Agricultural Statistics Service",
|
|
5
|
-
"depth": "standard",
|
|
6
|
-
"domains": [
|
|
7
|
-
"agriculture",
|
|
8
|
-
"food"
|
|
9
|
-
],
|
|
10
|
-
"keywords": [
|
|
11
|
-
"agriculture",
|
|
12
|
-
"crop",
|
|
13
|
-
"crops",
|
|
14
|
-
"corn",
|
|
15
|
-
"soybeans",
|
|
16
|
-
"wheat",
|
|
17
|
-
"cotton",
|
|
18
|
-
"yield",
|
|
19
|
-
"acres planted",
|
|
20
|
-
"harvested",
|
|
21
|
-
"crop production",
|
|
22
|
-
"livestock",
|
|
23
|
-
"cattle",
|
|
24
|
-
"hogs",
|
|
25
|
-
"milk",
|
|
26
|
-
"eggs",
|
|
27
|
-
"price received",
|
|
28
|
-
"farm",
|
|
29
|
-
"farms",
|
|
30
|
-
"census of agriculture",
|
|
31
|
-
"nass",
|
|
32
|
-
"quick stats",
|
|
33
|
-
"county crop"
|
|
34
|
-
],
|
|
35
|
-
"questions": [
|
|
36
|
-
"corn production by state in 2024",
|
|
37
|
-
"soybean yield trend in Iowa",
|
|
38
|
-
"cattle inventory over time",
|
|
39
|
-
"prices received by farmers for wheat",
|
|
40
|
-
"number of farms by county from the Census of Agriculture"
|
|
41
|
-
],
|
|
42
|
-
"homepage": "https://quickstats.nass.usda.gov/",
|
|
43
|
-
"terms_url": "https://quickstats.nass.usda.gov/api",
|
|
44
|
-
"auth": {
|
|
45
|
-
"env": "USDA_NASS_API_KEY",
|
|
46
|
-
"required": "required",
|
|
47
|
-
"placement": "query",
|
|
48
|
-
"param": "key",
|
|
49
|
-
"home": "usda-nass",
|
|
50
|
-
"signup_url": "https://quickstats.nass.usda.gov/api",
|
|
51
|
-
"echoes_key": false,
|
|
52
|
-
"key_only": []
|
|
53
|
-
},
|
|
54
|
-
"limits": {
|
|
55
|
-
"rps": 1,
|
|
56
|
-
"burst": 3,
|
|
57
|
-
"max_rows": 50000
|
|
58
|
-
},
|
|
59
|
-
"routes": {
|
|
60
|
-
"api": {
|
|
61
|
-
"base": "https://quickstats.nass.usda.gov",
|
|
62
|
-
"probe": "https://quickstats.nass.usda.gov/api/get_counts/?commodity_desc=CORN&year__GE=2012&state_alpha=VA",
|
|
63
|
-
"hosts": [
|
|
64
|
-
"quickstats.nass.usda.gov"
|
|
65
|
-
]
|
|
66
|
-
},
|
|
67
|
-
"manual": {
|
|
68
|
-
"how": "Build the same query on https://quickstats.nass.usda.gov/ (no key needed: pick Program, Sector, Group, Commodity, Category, Data Item, Geographic Level, State and Year, then Get Data > Spreadsheet) and upload the CSV; or, with a key, run the download script in the bundle."
|
|
69
|
-
}
|
|
70
|
-
},
|
|
71
|
-
"cache": {
|
|
72
|
-
"mode": "run_only",
|
|
73
|
-
"ttl_hours": null,
|
|
74
|
-
"why": "Estimates are revised with each report (annual summaries revise earlier forecasts); queries are small."
|
|
75
|
-
},
|
|
76
|
-
"redistribution": {
|
|
77
|
-
"mode": "allowed",
|
|
78
|
-
"why": "NASS statistics are U.S. government works in the public domain (17 U.S.C. 105); the Quick Stats API terms govern access and rate of use, not reuse of the data."
|
|
79
|
-
},
|
|
80
|
-
"notices": [
|
|
81
|
-
"This product uses the NASS API but is not endorsed or certified by NASS."
|
|
82
|
-
],
|
|
83
|
-
"retention": null,
|
|
84
|
-
"citation": "USDA National Agricultural Statistics Service, Quick Stats ({dataset}), quickstats.nass.usda.gov, retrieved {retrieved_long}.",
|
|
85
|
-
"audit_hooks": [],
|
|
86
|
-
"clarify": [
|
|
87
|
-
"Survey estimates (annual and monthly) or the Census of Agriculture (every five years, county detail)? They differ and must not be mixed in one series.",
|
|
88
|
-
"Marketing-year or calendar-year values? Prices received are published monthly and as marketing-year averages."
|
|
89
|
-
],
|
|
90
|
-
"formats": [
|
|
91
|
-
"json",
|
|
92
|
-
"csv",
|
|
93
|
-
"xml"
|
|
94
|
-
]
|
|
95
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"id": "usda-nass",
|
|
3
|
+
"title": "USDA NASS Quick Stats",
|
|
4
|
+
"agency": "U.S. Department of Agriculture, National Agricultural Statistics Service",
|
|
5
|
+
"depth": "standard",
|
|
6
|
+
"domains": [
|
|
7
|
+
"agriculture",
|
|
8
|
+
"food"
|
|
9
|
+
],
|
|
10
|
+
"keywords": [
|
|
11
|
+
"agriculture",
|
|
12
|
+
"crop",
|
|
13
|
+
"crops",
|
|
14
|
+
"corn",
|
|
15
|
+
"soybeans",
|
|
16
|
+
"wheat",
|
|
17
|
+
"cotton",
|
|
18
|
+
"yield",
|
|
19
|
+
"acres planted",
|
|
20
|
+
"harvested",
|
|
21
|
+
"crop production",
|
|
22
|
+
"livestock",
|
|
23
|
+
"cattle",
|
|
24
|
+
"hogs",
|
|
25
|
+
"milk",
|
|
26
|
+
"eggs",
|
|
27
|
+
"price received",
|
|
28
|
+
"farm",
|
|
29
|
+
"farms",
|
|
30
|
+
"census of agriculture",
|
|
31
|
+
"nass",
|
|
32
|
+
"quick stats",
|
|
33
|
+
"county crop"
|
|
34
|
+
],
|
|
35
|
+
"questions": [
|
|
36
|
+
"corn production by state in 2024",
|
|
37
|
+
"soybean yield trend in Iowa",
|
|
38
|
+
"cattle inventory over time",
|
|
39
|
+
"prices received by farmers for wheat",
|
|
40
|
+
"number of farms by county from the Census of Agriculture"
|
|
41
|
+
],
|
|
42
|
+
"homepage": "https://quickstats.nass.usda.gov/",
|
|
43
|
+
"terms_url": "https://quickstats.nass.usda.gov/api",
|
|
44
|
+
"auth": {
|
|
45
|
+
"env": "USDA_NASS_API_KEY",
|
|
46
|
+
"required": "required",
|
|
47
|
+
"placement": "query",
|
|
48
|
+
"param": "key",
|
|
49
|
+
"home": "usda-nass",
|
|
50
|
+
"signup_url": "https://quickstats.nass.usda.gov/api",
|
|
51
|
+
"echoes_key": false,
|
|
52
|
+
"key_only": []
|
|
53
|
+
},
|
|
54
|
+
"limits": {
|
|
55
|
+
"rps": 1,
|
|
56
|
+
"burst": 3,
|
|
57
|
+
"max_rows": 50000
|
|
58
|
+
},
|
|
59
|
+
"routes": {
|
|
60
|
+
"api": {
|
|
61
|
+
"base": "https://quickstats.nass.usda.gov",
|
|
62
|
+
"probe": "https://quickstats.nass.usda.gov/api/get_counts/?commodity_desc=CORN&year__GE=2012&state_alpha=VA",
|
|
63
|
+
"hosts": [
|
|
64
|
+
"quickstats.nass.usda.gov"
|
|
65
|
+
]
|
|
66
|
+
},
|
|
67
|
+
"manual": {
|
|
68
|
+
"how": "Build the same query on https://quickstats.nass.usda.gov/ (no key needed: pick Program, Sector, Group, Commodity, Category, Data Item, Geographic Level, State and Year, then Get Data > Spreadsheet) and upload the CSV; or, with a key, run the download script in the bundle."
|
|
69
|
+
}
|
|
70
|
+
},
|
|
71
|
+
"cache": {
|
|
72
|
+
"mode": "run_only",
|
|
73
|
+
"ttl_hours": null,
|
|
74
|
+
"why": "Estimates are revised with each report (annual summaries revise earlier forecasts); queries are small."
|
|
75
|
+
},
|
|
76
|
+
"redistribution": {
|
|
77
|
+
"mode": "allowed",
|
|
78
|
+
"why": "NASS statistics are U.S. government works in the public domain (17 U.S.C. 105); the Quick Stats API terms govern access and rate of use, not reuse of the data."
|
|
79
|
+
},
|
|
80
|
+
"notices": [
|
|
81
|
+
"This product uses the NASS API but is not endorsed or certified by NASS."
|
|
82
|
+
],
|
|
83
|
+
"retention": null,
|
|
84
|
+
"citation": "USDA National Agricultural Statistics Service, Quick Stats ({dataset}), quickstats.nass.usda.gov, retrieved {retrieved_long}.",
|
|
85
|
+
"audit_hooks": [],
|
|
86
|
+
"clarify": [
|
|
87
|
+
"Survey estimates (annual and monthly) or the Census of Agriculture (every five years, county detail)? They differ and must not be mixed in one series.",
|
|
88
|
+
"Marketing-year or calendar-year values? Prices received are published monthly and as marketing-year averages."
|
|
89
|
+
],
|
|
90
|
+
"formats": [
|
|
91
|
+
"json",
|
|
92
|
+
"csv",
|
|
93
|
+
"xml"
|
|
94
|
+
]
|
|
95
|
+
}
|
|
@@ -1,86 +1,86 @@
|
|
|
1
|
-
{
|
|
2
|
-
"base_url": "https://www.ers.usda.gov",
|
|
3
|
-
"timeout": 90,
|
|
4
|
-
"endpoints": {
|
|
5
|
-
"wasde": {
|
|
6
|
-
"path": "https://www.usda.gov/sites/default/files/documents/oce-wasde-report-data-{report}.csv",
|
|
7
|
-
"description": "World Agricultural Supply and Demand Estimates (WASDE), one monthly report (or a range of reports) as USDA's long-format CSV: one row per report table, commodity, region, attribute and marketing year, with Value, Unit and ProjEstFlag (Proj. = projection, Est. = estimate, blank = history). January 2021 report on. The pack filters the rows by the spec's commodity, region, attribute, report_title, market_year and proj_est.",
|
|
8
|
-
"params": {
|
|
9
|
-
"report": {"in": "spec", "desc": "report month YYYY-MM (2021-01 on), or \"latest\" (default: the newest report listed on USDA ESMIS whose CSV is posted)"},
|
|
10
|
-
"start_report": {"in": "spec", "desc": "first report month YYYY-MM of a range (with end_report; one CSV per month, at most 72): for month-to-month revisions"},
|
|
11
|
-
"end_report": {"in": "spec", "desc": "last report month YYYY-MM of a range (default: latest)"},
|
|
12
|
-
"commodity": {"in": "spec", "desc": "Commodity as published, case-insensitive, one or a list: Corn, Wheat, \"Oilseed, Soybean\", \"Meal, Soybean\", \"Oil, Soybean\", Cotton, Rice, \"Rice, milled\", Sorghum, Barley, Oats, Sugar, Beef, Pork, Broiler, Turkey, Eggs, Milk, Coarse Grains ... (names differ by table)"},
|
|
13
|
-
"region": {"in": "spec", "desc": "Region as published: United States, World, Foreign, a country (Brazil, China, European Union ...) or group (Major Exporters)"},
|
|
14
|
-
"attribute": {"in": "spec", "desc": "Attribute as published: Ending Stocks, Production, Exports, Imports, Beginning Stocks, Feed and Residual, Avg. Farm Price, Area Planted, Yield per Harvested Acre, Domestic, Total ..."},
|
|
15
|
-
"report_title": {"in": "spec", "desc": "ReportTitle (the report table), e.g. \"U.S. Feed Grain and Corn Supply and Use\", \"World Corn Supply and Use\"; the same item appears in several tables in different units"},
|
|
16
|
-
"market_year": {"in": "spec", "desc": "MarketYear as published: 2026/27 for crops, 2026 for livestock (calendar year)"},
|
|
17
|
-
"proj_est": {"in": "spec", "enum": ["proj", "est", "none"], "desc": "proj = projections (Proj.), est = estimates (Est.), none = rows with no flag (history and the reliability tables)"},
|
|
18
|
-
"include_reliability": {"in": "spec", "desc": "true keeps the 'Reliability of ... Projections' tables (past forecast errors); default false drops them"}
|
|
19
|
-
},
|
|
20
|
-
"records": "$csv",
|
|
21
|
-
"paging": {"type": "none"}
|
|
22
|
-
},
|
|
23
|
-
"farm_income": {
|
|
24
|
-
"path": "/data-products/farm-income-and-wealth-statistics/data-files-us-and-state-level-farm-income-and-wealth-statistics",
|
|
25
|
-
"description": "ERS Farm Income and Wealth Statistics, one release (default: the latest, scraped from the data-files page): U.S. and state farm income statement, cash receipts by commodity, government payments, production expenses, balance sheet (assets, debt, equity) and ratios, 1910 on (states 1949 on), current-year forecast. Nominal dollars ($1,000) with ChainType_GDP_Deflator; the pack streams the 111 MB CSV inside the release ZIP and keeps only the rows the spec asks for.",
|
|
26
|
-
"params": {
|
|
27
|
-
"release": {"in": "spec", "desc": "\"latest\" (default) or a release date: YYYY-MM-DD or YYYY-MM (2014-08 on; releases are in February, late August/early September and late November/early December)"},
|
|
28
|
-
"variable": {"in": "spec", "desc": "VariableDescriptionTotal as published, case-insensitive, one or a list: \"Net farm income\", \"Net cash income\", \"Cash receipts value, all commodities , all\" (sic), \"Value of government payments, total\", \"Dec. 31 value of farm equity, all, excl. operator dwelling\" ..."},
|
|
29
|
-
"key": {"in": "spec", "desc": "artificialKey, one or a list: FIAUSNTFI--P (U.S. net farm income), FIAUSNTCI--P (U.S. net cash income); the 3rd-4th letters are the state"},
|
|
30
|
-
"search": {"in": "spec", "desc": "case-insensitive text that VariableDescriptionTotal must contain (to discover variables: e.g. \"government payments\")"},
|
|
31
|
-
"state": {"in": "spec", "desc": "US or a two-letter state code, one or a list (default: all)"},
|
|
32
|
-
"year": {"in": "spec", "desc": "one calendar year"},
|
|
33
|
-
"start_year": {"in": "spec", "desc": "first calendar year"},
|
|
34
|
-
"end_year": {"in": "spec", "desc": "last calendar year"}
|
|
35
|
-
},
|
|
36
|
-
"records": "$zip:*.csv",
|
|
37
|
-
"paging": {"type": "none"}
|
|
38
|
-
},
|
|
39
|
-
"farm_income_summary": {
|
|
40
|
-
"path": "/data-products/farm-income-and-wealth-statistics/data-files-us-and-state-level-farm-income-and-wealth-statistics",
|
|
41
|
-
"description": "The 'U.S. farm sector financial indicators' table of the latest release (one small .xlsx, billion dollars, last eight years with the forecast year marked F, e.g. 2026F, plus percent changes): cash income statement, farm income statement, balance sheet, debt by lender, debt-to-equity and debt-to-asset ratios. One row per line item with section and unit.",
|
|
42
|
-
"params": {},
|
|
43
|
-
"records": "$xlsx",
|
|
44
|
-
"paging": {"type": "none"}
|
|
45
|
-
},
|
|
46
|
-
"farm_income_archive": {
|
|
47
|
-
"path": "/data-products/farm-income-and-wealth-statistics/data-files-us-and-state-level-farm-income-and-wealth-statistics",
|
|
48
|
-
"description": "ERS archive of past forecasts and estimates (U.S. only): every release's value of net farm income (nfi), net cash income (nci) and cash receipts (cr_all) for each year, first 15 releases per year, February 1977 release on. For forecast accuracy and revision paths.",
|
|
49
|
-
"params": {
|
|
50
|
-
"item": {"in": "spec", "enum": ["nfi", "nci", "cr_all"], "desc": "nfi = net farm income, nci = net cash income, cr_all = cash receipts, all commodities (default: all three)"},
|
|
51
|
-
"year": {"in": "spec", "desc": "one calendar year being forecast or estimated"},
|
|
52
|
-
"start_year": {"in": "spec", "desc": "first year"},
|
|
53
|
-
"end_year": {"in": "spec", "desc": "last year"}
|
|
54
|
-
},
|
|
55
|
-
"records": "$zip:archive.csv",
|
|
56
|
-
"paging": {"type": "none"}
|
|
57
|
-
},
|
|
58
|
-
"baseline": {
|
|
59
|
-
"path": "/data-products/agricultural-baseline-database",
|
|
60
|
-
"description": "USDA Agricultural Projections (the 10-year baseline of the Interagency Agricultural Projections Committee), one edition's ZIP: by default its machine-readable Projections<year>.csv (one row per commodity, attribute and year: supply and use, area, yield, prices for crops; production, use and prices for livestock and dairy), or one of its .xlsx tables (farm income, trade, macro assumptions ...).",
|
|
61
|
-
"params": {
|
|
62
|
-
"edition": {"in": "spec", "desc": "\"latest\" (default: the most recent full release), \"early\" (the most recent early release, before the report), or the last projection year, e.g. 2035 or 2034 (projections to that year; full release)"},
|
|
63
|
-
"member": {"in": "spec", "desc": "file in the ZIP, a glob (case-insensitive): default \"Projections*.csv\"; e.g. \"*Farm receipts*\" for Table 26 (farm income), \"*Feed Grains*\", \"*Macroeoconomic*\" (sic, as published)"},
|
|
64
|
-
"sheet": {"in": "spec", "desc": ".xlsx member: sheet name or 1-based number (default 1)"},
|
|
65
|
-
"header_row": {"in": "spec", "desc": ".xlsx member: 1-based row holding the column names (default: the first row with three or more filled cells)"},
|
|
66
|
-
"commodity": {"in": "spec", "desc": "CSV member: commodity as published, case-insensitive, one or a list (Corn, Wheat, Soybeans, Upland Cotton, Beef, Pork, Broilers ...)"},
|
|
67
|
-
"attribute": {"in": "spec", "desc": "CSV member: attribute as published (Ending stocks, Planted acres, Farm price ...)"},
|
|
68
|
-
"year": {"in": "spec", "desc": "CSV member: year as published (2030/31 for marketing years, 2030 for calendar years), one or a list"}
|
|
69
|
-
},
|
|
70
|
-
"records": "$zip:Projections*.csv",
|
|
71
|
-
"paging": {"type": "none"}
|
|
72
|
-
}
|
|
73
|
-
},
|
|
74
|
-
"catalog": {
|
|
75
|
-
"wasde": {"id": "wasde", "endpoint": "wasde", "name": "WASDE monthly supply and use projections",
|
|
76
|
-
"description": "World Agricultural Supply and Demand Estimates: U.S. and world supply, use, ending stocks, prices for grains, oilseeds, cotton, rice, sugar, livestock, poultry, dairy; monthly, 2021 on"},
|
|
77
|
-
"farm_income": {"id": "farm_income", "endpoint": "farm_income", "name": "ERS farm income and wealth statistics (U.S. and states)",
|
|
78
|
-
"description": "net farm income, net cash farm income, cash receipts by commodity, government payments, expenses, farm assets, debt, equity; annual 1910 on with the current-year forecast"},
|
|
79
|
-
"farm_income_summary": {"id": "farm_income_summary", "endpoint": "farm_income_summary", "name": "U.S. farm sector financial indicators (latest forecast table)",
|
|
80
|
-
"description": "one-page summary of the latest farm income forecast in billion dollars, with the forecast year marked F"},
|
|
81
|
-
"farm_income_archive": {"id": "farm_income_archive", "endpoint": "farm_income_archive", "name": "Archive of past farm income forecasts",
|
|
82
|
-
"description": "net farm income, net cash income and cash receipts as forecast and estimated in each release since 1977: forecast accuracy, revisions"},
|
|
83
|
-
"baseline": {"id": "baseline", "endpoint": "baseline", "name": "USDA Agricultural Projections (10-year baseline)",
|
|
84
|
-
"description": "long-term projections of U.S. crop and livestock supply, use, prices, farm income and trade, ten years ahead, under current law"}
|
|
85
|
-
}
|
|
86
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"base_url": "https://www.ers.usda.gov",
|
|
3
|
+
"timeout": 90,
|
|
4
|
+
"endpoints": {
|
|
5
|
+
"wasde": {
|
|
6
|
+
"path": "https://www.usda.gov/sites/default/files/documents/oce-wasde-report-data-{report}.csv",
|
|
7
|
+
"description": "World Agricultural Supply and Demand Estimates (WASDE), one monthly report (or a range of reports) as USDA's long-format CSV: one row per report table, commodity, region, attribute and marketing year, with Value, Unit and ProjEstFlag (Proj. = projection, Est. = estimate, blank = history). January 2021 report on. The pack filters the rows by the spec's commodity, region, attribute, report_title, market_year and proj_est.",
|
|
8
|
+
"params": {
|
|
9
|
+
"report": {"in": "spec", "desc": "report month YYYY-MM (2021-01 on), or \"latest\" (default: the newest report listed on USDA ESMIS whose CSV is posted)"},
|
|
10
|
+
"start_report": {"in": "spec", "desc": "first report month YYYY-MM of a range (with end_report; one CSV per month, at most 72): for month-to-month revisions"},
|
|
11
|
+
"end_report": {"in": "spec", "desc": "last report month YYYY-MM of a range (default: latest)"},
|
|
12
|
+
"commodity": {"in": "spec", "desc": "Commodity as published, case-insensitive, one or a list: Corn, Wheat, \"Oilseed, Soybean\", \"Meal, Soybean\", \"Oil, Soybean\", Cotton, Rice, \"Rice, milled\", Sorghum, Barley, Oats, Sugar, Beef, Pork, Broiler, Turkey, Eggs, Milk, Coarse Grains ... (names differ by table)"},
|
|
13
|
+
"region": {"in": "spec", "desc": "Region as published: United States, World, Foreign, a country (Brazil, China, European Union ...) or group (Major Exporters)"},
|
|
14
|
+
"attribute": {"in": "spec", "desc": "Attribute as published: Ending Stocks, Production, Exports, Imports, Beginning Stocks, Feed and Residual, Avg. Farm Price, Area Planted, Yield per Harvested Acre, Domestic, Total ..."},
|
|
15
|
+
"report_title": {"in": "spec", "desc": "ReportTitle (the report table), e.g. \"U.S. Feed Grain and Corn Supply and Use\", \"World Corn Supply and Use\"; the same item appears in several tables in different units"},
|
|
16
|
+
"market_year": {"in": "spec", "desc": "MarketYear as published: 2026/27 for crops, 2026 for livestock (calendar year)"},
|
|
17
|
+
"proj_est": {"in": "spec", "enum": ["proj", "est", "none"], "desc": "proj = projections (Proj.), est = estimates (Est.), none = rows with no flag (history and the reliability tables)"},
|
|
18
|
+
"include_reliability": {"in": "spec", "desc": "true keeps the 'Reliability of ... Projections' tables (past forecast errors); default false drops them"}
|
|
19
|
+
},
|
|
20
|
+
"records": "$csv",
|
|
21
|
+
"paging": {"type": "none"}
|
|
22
|
+
},
|
|
23
|
+
"farm_income": {
|
|
24
|
+
"path": "/data-products/farm-income-and-wealth-statistics/data-files-us-and-state-level-farm-income-and-wealth-statistics",
|
|
25
|
+
"description": "ERS Farm Income and Wealth Statistics, one release (default: the latest, scraped from the data-files page): U.S. and state farm income statement, cash receipts by commodity, government payments, production expenses, balance sheet (assets, debt, equity) and ratios, 1910 on (states 1949 on), current-year forecast. Nominal dollars ($1,000) with ChainType_GDP_Deflator; the pack streams the 111 MB CSV inside the release ZIP and keeps only the rows the spec asks for.",
|
|
26
|
+
"params": {
|
|
27
|
+
"release": {"in": "spec", "desc": "\"latest\" (default) or a release date: YYYY-MM-DD or YYYY-MM (2014-08 on; releases are in February, late August/early September and late November/early December)"},
|
|
28
|
+
"variable": {"in": "spec", "desc": "VariableDescriptionTotal as published, case-insensitive, one or a list: \"Net farm income\", \"Net cash income\", \"Cash receipts value, all commodities , all\" (sic), \"Value of government payments, total\", \"Dec. 31 value of farm equity, all, excl. operator dwelling\" ..."},
|
|
29
|
+
"key": {"in": "spec", "desc": "artificialKey, one or a list: FIAUSNTFI--P (U.S. net farm income), FIAUSNTCI--P (U.S. net cash income); the 3rd-4th letters are the state"},
|
|
30
|
+
"search": {"in": "spec", "desc": "case-insensitive text that VariableDescriptionTotal must contain (to discover variables: e.g. \"government payments\")"},
|
|
31
|
+
"state": {"in": "spec", "desc": "US or a two-letter state code, one or a list (default: all)"},
|
|
32
|
+
"year": {"in": "spec", "desc": "one calendar year"},
|
|
33
|
+
"start_year": {"in": "spec", "desc": "first calendar year"},
|
|
34
|
+
"end_year": {"in": "spec", "desc": "last calendar year"}
|
|
35
|
+
},
|
|
36
|
+
"records": "$zip:*.csv",
|
|
37
|
+
"paging": {"type": "none"}
|
|
38
|
+
},
|
|
39
|
+
"farm_income_summary": {
|
|
40
|
+
"path": "/data-products/farm-income-and-wealth-statistics/data-files-us-and-state-level-farm-income-and-wealth-statistics",
|
|
41
|
+
"description": "The 'U.S. farm sector financial indicators' table of the latest release (one small .xlsx, billion dollars, last eight years with the forecast year marked F, e.g. 2026F, plus percent changes): cash income statement, farm income statement, balance sheet, debt by lender, debt-to-equity and debt-to-asset ratios. One row per line item with section and unit.",
|
|
42
|
+
"params": {},
|
|
43
|
+
"records": "$xlsx",
|
|
44
|
+
"paging": {"type": "none"}
|
|
45
|
+
},
|
|
46
|
+
"farm_income_archive": {
|
|
47
|
+
"path": "/data-products/farm-income-and-wealth-statistics/data-files-us-and-state-level-farm-income-and-wealth-statistics",
|
|
48
|
+
"description": "ERS archive of past forecasts and estimates (U.S. only): every release's value of net farm income (nfi), net cash income (nci) and cash receipts (cr_all) for each year, first 15 releases per year, February 1977 release on. For forecast accuracy and revision paths.",
|
|
49
|
+
"params": {
|
|
50
|
+
"item": {"in": "spec", "enum": ["nfi", "nci", "cr_all"], "desc": "nfi = net farm income, nci = net cash income, cr_all = cash receipts, all commodities (default: all three)"},
|
|
51
|
+
"year": {"in": "spec", "desc": "one calendar year being forecast or estimated"},
|
|
52
|
+
"start_year": {"in": "spec", "desc": "first year"},
|
|
53
|
+
"end_year": {"in": "spec", "desc": "last year"}
|
|
54
|
+
},
|
|
55
|
+
"records": "$zip:archive.csv",
|
|
56
|
+
"paging": {"type": "none"}
|
|
57
|
+
},
|
|
58
|
+
"baseline": {
|
|
59
|
+
"path": "/data-products/agricultural-baseline-database",
|
|
60
|
+
"description": "USDA Agricultural Projections (the 10-year baseline of the Interagency Agricultural Projections Committee), one edition's ZIP: by default its machine-readable Projections<year>.csv (one row per commodity, attribute and year: supply and use, area, yield, prices for crops; production, use and prices for livestock and dairy), or one of its .xlsx tables (farm income, trade, macro assumptions ...).",
|
|
61
|
+
"params": {
|
|
62
|
+
"edition": {"in": "spec", "desc": "\"latest\" (default: the most recent full release), \"early\" (the most recent early release, before the report), or the last projection year, e.g. 2035 or 2034 (projections to that year; full release)"},
|
|
63
|
+
"member": {"in": "spec", "desc": "file in the ZIP, a glob (case-insensitive): default \"Projections*.csv\"; e.g. \"*Farm receipts*\" for Table 26 (farm income), \"*Feed Grains*\", \"*Macroeoconomic*\" (sic, as published)"},
|
|
64
|
+
"sheet": {"in": "spec", "desc": ".xlsx member: sheet name or 1-based number (default 1)"},
|
|
65
|
+
"header_row": {"in": "spec", "desc": ".xlsx member: 1-based row holding the column names (default: the first row with three or more filled cells)"},
|
|
66
|
+
"commodity": {"in": "spec", "desc": "CSV member: commodity as published, case-insensitive, one or a list (Corn, Wheat, Soybeans, Upland Cotton, Beef, Pork, Broilers ...)"},
|
|
67
|
+
"attribute": {"in": "spec", "desc": "CSV member: attribute as published (Ending stocks, Planted acres, Farm price ...)"},
|
|
68
|
+
"year": {"in": "spec", "desc": "CSV member: year as published (2030/31 for marketing years, 2030 for calendar years), one or a list"}
|
|
69
|
+
},
|
|
70
|
+
"records": "$zip:Projections*.csv",
|
|
71
|
+
"paging": {"type": "none"}
|
|
72
|
+
}
|
|
73
|
+
},
|
|
74
|
+
"catalog": {
|
|
75
|
+
"wasde": {"id": "wasde", "endpoint": "wasde", "name": "WASDE monthly supply and use projections",
|
|
76
|
+
"description": "World Agricultural Supply and Demand Estimates: U.S. and world supply, use, ending stocks, prices for grains, oilseeds, cotton, rice, sugar, livestock, poultry, dairy; monthly, 2021 on"},
|
|
77
|
+
"farm_income": {"id": "farm_income", "endpoint": "farm_income", "name": "ERS farm income and wealth statistics (U.S. and states)",
|
|
78
|
+
"description": "net farm income, net cash farm income, cash receipts by commodity, government payments, expenses, farm assets, debt, equity; annual 1910 on with the current-year forecast"},
|
|
79
|
+
"farm_income_summary": {"id": "farm_income_summary", "endpoint": "farm_income_summary", "name": "U.S. farm sector financial indicators (latest forecast table)",
|
|
80
|
+
"description": "one-page summary of the latest farm income forecast in billion dollars, with the forecast year marked F"},
|
|
81
|
+
"farm_income_archive": {"id": "farm_income_archive", "endpoint": "farm_income_archive", "name": "Archive of past farm income forecasts",
|
|
82
|
+
"description": "net farm income, net cash income and cash receipts as forecast and estimated in each release since 1977: forecast accuracy, revisions"},
|
|
83
|
+
"baseline": {"id": "baseline", "endpoint": "baseline", "name": "USDA Agricultural Projections (10-year baseline)",
|
|
84
|
+
"description": "long-term projections of U.S. crop and livestock supply, use, prices, farm income and trade, ten years ahead, under current law"}
|
|
85
|
+
}
|
|
86
|
+
}
|
|
@@ -1,109 +1,109 @@
|
|
|
1
|
-
{
|
|
2
|
-
"id": "usda-outlook",
|
|
3
|
-
"title": "USDA forecasts and projections (WASDE, ERS farm income forecasts, USDA Agricultural Baseline)",
|
|
4
|
-
"agency": "U.S. Department of Agriculture: World Agricultural Outlook Board (WAOB, Office of the Chief Economist) and Economic Research Service (ERS)",
|
|
5
|
-
"depth": "standard",
|
|
6
|
-
"domains": [
|
|
7
|
-
"agriculture",
|
|
8
|
-
"food",
|
|
9
|
-
"economy"
|
|
10
|
-
],
|
|
11
|
-
"keywords": [
|
|
12
|
-
"wasde",
|
|
13
|
-
"world agricultural supply and demand estimates",
|
|
14
|
-
"supply and use",
|
|
15
|
-
"ending stocks",
|
|
16
|
-
"stocks-to-use",
|
|
17
|
-
"season-average farm price",
|
|
18
|
-
"marketing year",
|
|
19
|
-
"crop forecast",
|
|
20
|
-
"usda projection",
|
|
21
|
-
"farm income",
|
|
22
|
-
"net farm income",
|
|
23
|
-
"net cash farm income",
|
|
24
|
-
"cash receipts",
|
|
25
|
-
"farm sector balance sheet",
|
|
26
|
-
"farm debt",
|
|
27
|
-
"farm equity",
|
|
28
|
-
"government payments to farmers",
|
|
29
|
-
"farm income forecast",
|
|
30
|
-
"agricultural baseline",
|
|
31
|
-
"usda baseline",
|
|
32
|
-
"long-term agricultural projections",
|
|
33
|
-
"ten-year projections",
|
|
34
|
-
"interagency agricultural projections committee",
|
|
35
|
-
"corn",
|
|
36
|
-
"soybeans",
|
|
37
|
-
"wheat",
|
|
38
|
-
"cotton",
|
|
39
|
-
"rice",
|
|
40
|
-
"beef",
|
|
41
|
-
"pork",
|
|
42
|
-
"poultry",
|
|
43
|
-
"dairy"
|
|
44
|
-
],
|
|
45
|
-
"questions": [
|
|
46
|
-
"latest USDA projection of U.S. corn ending stocks for the current marketing year",
|
|
47
|
-
"how the WASDE soybean export forecast changed from month to month",
|
|
48
|
-
"world wheat production forecast by country",
|
|
49
|
-
"USDA's 2026 net farm income forecast, nominal and inflation-adjusted",
|
|
50
|
-
"farm income by state",
|
|
51
|
-
"how accurate were past net farm income forecasts",
|
|
52
|
-
"USDA 10-year baseline projection of corn planted acres and prices"
|
|
53
|
-
],
|
|
54
|
-
"homepage": "https://www.usda.gov/about-usda/general-information/staff-offices/office-chief-economist/commodity-markets/wasde-report",
|
|
55
|
-
"terms_url": "https://www.ers.usda.gov/about-ers/policies-and-standards",
|
|
56
|
-
"auth": {
|
|
57
|
-
"env": null,
|
|
58
|
-
"required": "none",
|
|
59
|
-
"placement": "none",
|
|
60
|
-
"param": null,
|
|
61
|
-
"prefix": "",
|
|
62
|
-
"home": null,
|
|
63
|
-
"signup_url": null,
|
|
64
|
-
"echoes_key": false,
|
|
65
|
-
"key_only": []
|
|
66
|
-
},
|
|
67
|
-
"limits": {
|
|
68
|
-
"rps": 1,
|
|
69
|
-
"burst": 3,
|
|
70
|
-
"max_rows": 50000
|
|
71
|
-
},
|
|
72
|
-
"routes": {
|
|
73
|
-
"api": {
|
|
74
|
-
"base": "https://www.ers.usda.gov",
|
|
75
|
-
"probe": "https://www.ers.usda.gov/data-products/agricultural-baseline-database",
|
|
76
|
-
"hosts": [
|
|
77
|
-
"www.usda.gov",
|
|
78
|
-
"esmis.nal.usda.gov",
|
|
79
|
-
"www.ers.usda.gov"
|
|
80
|
-
]
|
|
81
|
-
},
|
|
82
|
-
"manual": {
|
|
83
|
-
"how": "Download the files in a browser and upload them unchanged. WASDE: the monthly CSV https://www.usda.gov/sites/default/files/documents/oce-wasde-report-data-YYYY-MM.csv (January 2021 on), or for older or missing months the consolidated CSV on the Historical WASDE Report Data page (https://www.usda.gov/oce/commodity-markets/wasde/historical-wasde-report-data). Farm income: the release ZIP ('September 3, 2026 release'), the 'U.S. farm sector financial indicators' .xlsx or the data archive ZIP on https://www.ers.usda.gov/data-products/farm-income-and-wealth-statistics/data-files-us-and-state-level-farm-income-and-wealth-statistics. Baseline: the ZIP under 'File Downloads' on https://www.ers.usda.gov/data-products/agricultural-baseline-database."
|
|
84
|
-
}
|
|
85
|
-
},
|
|
86
|
-
"cache": {
|
|
87
|
-
"mode": "run_only",
|
|
88
|
-
"ttl_hours": null,
|
|
89
|
-
"why": "Each WASDE month and each farm income release is a new vintage that revises the last; data/ is reused per run only."
|
|
90
|
-
},
|
|
91
|
-
"redistribution": {
|
|
92
|
-
"mode": "allowed",
|
|
93
|
-
"why": "WASDE, ERS farm income statistics and the USDA baseline are U.S. government works in the public domain (17 U.S.C. 105); USDA asks for attribution."
|
|
94
|
-
},
|
|
95
|
-
"notices": [],
|
|
96
|
-
"retention": null,
|
|
97
|
-
"citation": "U.S. Department of Agriculture, {dataset}, usda.gov / ers.usda.gov, retrieved {retrieved_long}.",
|
|
98
|
-
"audit_hooks": [],
|
|
99
|
-
"clarify": [
|
|
100
|
-
"Which vintage? WASDE is reissued monthly and ERS farm income forecasts three times a year (February, early September, early December); the default is the latest, and a comparison over time needs one vintage per release.",
|
|
101
|
-
"Nominal or inflation-adjusted dollars? ERS publishes nominal values plus a chain-type GDP price index (latest year = 100); the default is nominal.",
|
|
102
|
-
"Which marketing year (WASDE) or calendar year (farm income)? Marketing years differ by commodity (corn and soybeans September-August, wheat June-May, cotton and rice August-July)."
|
|
103
|
-
],
|
|
104
|
-
"formats": [
|
|
105
|
-
"csv",
|
|
106
|
-
"xlsx",
|
|
107
|
-
"zip"
|
|
108
|
-
]
|
|
109
|
-
}
|
|
1
|
+
{
|
|
2
|
+
"id": "usda-outlook",
|
|
3
|
+
"title": "USDA forecasts and projections (WASDE, ERS farm income forecasts, USDA Agricultural Baseline)",
|
|
4
|
+
"agency": "U.S. Department of Agriculture: World Agricultural Outlook Board (WAOB, Office of the Chief Economist) and Economic Research Service (ERS)",
|
|
5
|
+
"depth": "standard",
|
|
6
|
+
"domains": [
|
|
7
|
+
"agriculture",
|
|
8
|
+
"food",
|
|
9
|
+
"economy"
|
|
10
|
+
],
|
|
11
|
+
"keywords": [
|
|
12
|
+
"wasde",
|
|
13
|
+
"world agricultural supply and demand estimates",
|
|
14
|
+
"supply and use",
|
|
15
|
+
"ending stocks",
|
|
16
|
+
"stocks-to-use",
|
|
17
|
+
"season-average farm price",
|
|
18
|
+
"marketing year",
|
|
19
|
+
"crop forecast",
|
|
20
|
+
"usda projection",
|
|
21
|
+
"farm income",
|
|
22
|
+
"net farm income",
|
|
23
|
+
"net cash farm income",
|
|
24
|
+
"cash receipts",
|
|
25
|
+
"farm sector balance sheet",
|
|
26
|
+
"farm debt",
|
|
27
|
+
"farm equity",
|
|
28
|
+
"government payments to farmers",
|
|
29
|
+
"farm income forecast",
|
|
30
|
+
"agricultural baseline",
|
|
31
|
+
"usda baseline",
|
|
32
|
+
"long-term agricultural projections",
|
|
33
|
+
"ten-year projections",
|
|
34
|
+
"interagency agricultural projections committee",
|
|
35
|
+
"corn",
|
|
36
|
+
"soybeans",
|
|
37
|
+
"wheat",
|
|
38
|
+
"cotton",
|
|
39
|
+
"rice",
|
|
40
|
+
"beef",
|
|
41
|
+
"pork",
|
|
42
|
+
"poultry",
|
|
43
|
+
"dairy"
|
|
44
|
+
],
|
|
45
|
+
"questions": [
|
|
46
|
+
"latest USDA projection of U.S. corn ending stocks for the current marketing year",
|
|
47
|
+
"how the WASDE soybean export forecast changed from month to month",
|
|
48
|
+
"world wheat production forecast by country",
|
|
49
|
+
"USDA's 2026 net farm income forecast, nominal and inflation-adjusted",
|
|
50
|
+
"farm income by state",
|
|
51
|
+
"how accurate were past net farm income forecasts",
|
|
52
|
+
"USDA 10-year baseline projection of corn planted acres and prices"
|
|
53
|
+
],
|
|
54
|
+
"homepage": "https://www.usda.gov/about-usda/general-information/staff-offices/office-chief-economist/commodity-markets/wasde-report",
|
|
55
|
+
"terms_url": "https://www.ers.usda.gov/about-ers/policies-and-standards",
|
|
56
|
+
"auth": {
|
|
57
|
+
"env": null,
|
|
58
|
+
"required": "none",
|
|
59
|
+
"placement": "none",
|
|
60
|
+
"param": null,
|
|
61
|
+
"prefix": "",
|
|
62
|
+
"home": null,
|
|
63
|
+
"signup_url": null,
|
|
64
|
+
"echoes_key": false,
|
|
65
|
+
"key_only": []
|
|
66
|
+
},
|
|
67
|
+
"limits": {
|
|
68
|
+
"rps": 1,
|
|
69
|
+
"burst": 3,
|
|
70
|
+
"max_rows": 50000
|
|
71
|
+
},
|
|
72
|
+
"routes": {
|
|
73
|
+
"api": {
|
|
74
|
+
"base": "https://www.ers.usda.gov",
|
|
75
|
+
"probe": "https://www.ers.usda.gov/data-products/agricultural-baseline-database",
|
|
76
|
+
"hosts": [
|
|
77
|
+
"www.usda.gov",
|
|
78
|
+
"esmis.nal.usda.gov",
|
|
79
|
+
"www.ers.usda.gov"
|
|
80
|
+
]
|
|
81
|
+
},
|
|
82
|
+
"manual": {
|
|
83
|
+
"how": "Download the files in a browser and upload them unchanged. WASDE: the monthly CSV https://www.usda.gov/sites/default/files/documents/oce-wasde-report-data-YYYY-MM.csv (January 2021 on), or for older or missing months the consolidated CSV on the Historical WASDE Report Data page (https://www.usda.gov/oce/commodity-markets/wasde/historical-wasde-report-data). Farm income: the release ZIP ('September 3, 2026 release'), the 'U.S. farm sector financial indicators' .xlsx or the data archive ZIP on https://www.ers.usda.gov/data-products/farm-income-and-wealth-statistics/data-files-us-and-state-level-farm-income-and-wealth-statistics. Baseline: the ZIP under 'File Downloads' on https://www.ers.usda.gov/data-products/agricultural-baseline-database."
|
|
84
|
+
}
|
|
85
|
+
},
|
|
86
|
+
"cache": {
|
|
87
|
+
"mode": "run_only",
|
|
88
|
+
"ttl_hours": null,
|
|
89
|
+
"why": "Each WASDE month and each farm income release is a new vintage that revises the last; data/ is reused per run only."
|
|
90
|
+
},
|
|
91
|
+
"redistribution": {
|
|
92
|
+
"mode": "allowed",
|
|
93
|
+
"why": "WASDE, ERS farm income statistics and the USDA baseline are U.S. government works in the public domain (17 U.S.C. 105); USDA asks for attribution."
|
|
94
|
+
},
|
|
95
|
+
"notices": [],
|
|
96
|
+
"retention": null,
|
|
97
|
+
"citation": "U.S. Department of Agriculture, {dataset}, usda.gov / ers.usda.gov, retrieved {retrieved_long}.",
|
|
98
|
+
"audit_hooks": [],
|
|
99
|
+
"clarify": [
|
|
100
|
+
"Which vintage? WASDE is reissued monthly and ERS farm income forecasts three times a year (February, early September, early December); the default is the latest, and a comparison over time needs one vintage per release.",
|
|
101
|
+
"Nominal or inflation-adjusted dollars? ERS publishes nominal values plus a chain-type GDP price index (latest year = 100); the default is nominal.",
|
|
102
|
+
"Which marketing year (WASDE) or calendar year (farm income)? Marketing years differ by commodity (corn and soybeans September-August, wheat June-May, cotton and rice August-July)."
|
|
103
|
+
],
|
|
104
|
+
"formats": [
|
|
105
|
+
"csv",
|
|
106
|
+
"xlsx",
|
|
107
|
+
"zip"
|
|
108
|
+
]
|
|
109
|
+
}
|