search

USDA / USDA-APIs

Do you have feedback, ideas, or questions for USDA APIs? Use this repository's Issue Tracker to join the discussion.
www.usda.gov/developer
107 stars 16 forks source link

New Food Data Central API Released #92

Open littlebunch opened 4 years ago

littlebunch commented 4 years ago

A new version of the FDC API is now available. This version includes new endpoints for requesting multiple foods in full or abridged formats, "list" endpoints for paged browsing of foods lists, the ability to request one or more nutrients plus much more. General documentation is available on the FDC web site. The OpenAPI v.3 specification is also available in HTML, JSON, and YAML formats.

On a related note, the discontinuation date for the NDB API has been extended to May 31, 2020.

manijcgvak commented 4 years ago

As per the update, We observed there is the change in the Search API and the response get. Can u please describe what is the difference between the foodNutrients in Food Search endpoint and Food Details endpoint. We have updated our application from NDB to FDC recently when the API is changed. But now there is again an update available, when it will finalised So that we can alter our application.

littlebunch commented 4 years ago

@manijcgvak schema and endpoint details are documented here. Basically, the search returns a list of AbridgedFoodNutrients while the detail endpoint returns either a list of FoodNutrient (the default) or a list of AbridgedFoodNutrients if you specify format=abridged.

I believe the current release is feature complete but I believe it won't be officially finalized until April 30. I can ask the program people to respond.

KyleMcKillop-USDA commented 4 years ago

That is correct, this version is now considered feature complete. Changes between now and April 30th are to address any discovered issues with this current release. Any further changes to the API will occur outside of the current feature set with new endpoints.

manijcgvak commented 4 years ago

As mentioned that after 30th Apr, API structure will not change. Please confirm on this so that we start work of top of the api's

KyleMcKillop-USDA commented 4 years ago

@manijcgvak We released an FDC software update this morning and should be our last software update until at least October. Future updates to the API will not change the structure of version 1 endpoints.