nutrifyi

README

nutrifyi-go

Go client for the NutriFYI REST API. Nutrition data, food composition. Zero external dependencies beyond stdlib.

Try the interactive tools at nutrifyi.com — explore, search, and discover.

Install

go get github.com/fyipedia/nutrifyi-go

Quick Start

package main

import (
    "fmt"
    nutrifyi "github.com/fyipedia/nutrifyi-go"
)

func main() {
    client := nutrifyi.NewClient()

    // Search across all content
    result, err := client.Search("query")
    if err != nil {
        panic(err)
    }
    fmt.Println(result)
}

API Methods

Method	Description
Categories()	List categories
Comparisons()	List comparisons
Diets()	List diets
Faqs()	List faqs
Foods()	List foods
Glossary()	List glossary
Guides()	List guides
Nutrition()	List nutrition
Series()	List series
Search(query)	Search across all content

Also Available

Platform	Package	Link
Python	pip install nutrifyi	PyPI
npm	npm install nutrifyi	npm
Go	go get github.com/fyipedia/nutrifyi-go	pkg.go.dev
Rust	cargo add nutrifyi	crates.io
Ruby	gem install nutrifyi	rubygems

FYIPedia Developer Tools

Part of the FYIPedia open-source developer tools ecosystem.

Package	PyPI	npm	Go	Description
airlinefyi	PyPI	npm	Go	Airlines, fleets, alliances — airlinefyi.com
airportfyi	PyPI	npm	Go	4,500+ airports, IATA/ICAO — airportfyi.com
alloyfyi	PyPI	npm	Go	Metal alloys, compositions — alloyfyi.com
anatomyfyi	PyPI	npm	Go	14,692 anatomical structures — anatomyfyi.com
barcodefyi	PyPI	npm	Go	Barcode formats, EAN, UPC, ISBN — barcodefyi.com
beerfyi	PyPI	npm	Go	112 beer styles, hops, malts, yeast — beerfyi.com
birdfyi	PyPI	npm	Go	11,251 birds, orders, conservation — birdfyi.com
blefyi	PyPI	npm	Go	Bluetooth Low Energy, GATT, beacons — blefyi.com
boardgamefyi	PyPI	npm	Go	Board games, rules, reviews — boardgamefyi.com
brewfyi	PyPI	npm	Go	72 coffee varieties, roasting, brewing — brewfyi.com
cablefyi	PyPI	npm	Go	Submarine cables, connectors — cablefyi.com
calcfyi	PyPI	npm	Go	200+ calculators — calcfyi.com
chemfyi	PyPI	npm	Go	Periodic table, elements, compounds — chemfyi.com
cocktailfyi	PyPI	npm	Go	636 cocktail recipes, ABV, calories — cocktailfyi.com
colorfyi	PyPI	npm	Go	Color science, WCAG contrast, 16.7M hex colors — colorfyi.com
dinofyi	PyPI	npm	Go	6,142 dinosaurs, paleontology — dinofyi.com
distancefyi	PyPI	npm	Go	Haversine distance & travel times — distancefyi.com
drugfyi	PyPI	npm	Go	Drug interactions, pharmacology — drugfyi.com
emojifyi	PyPI	npm	Go	Emoji metadata & encoding for 3,953 emojis — emojifyi.com
fishfyi	PyPI	npm	Go	Fish species, marine biology — fishfyi.com
fontfyi	PyPI	npm	Go	Google Fonts metadata & CSS — fontfyi.com
gemfyi	PyPI	npm	Go	Gemstones, mineralogy, grading — gemfyi.com
holidayfyi	PyPI	npm	Go	Holiday dates & Easter calculation — holidayfyi.com
ipfyi	PyPI	npm	Go	IP geolocation, ASN lookup — ipfyi.com
mineralfyi	PyPI	npm	Go	6,215 minerals, crystal systems — mineralfyi.com
mountainfyi	PyPI	npm	Go	Mountains, peaks, elevation — mountainfyi.com
namefyi	PyPI	npm	Go	Korean romanization & Five Elements — namefyi.com
nfcfyi	PyPI	npm	Go	NFC chips, tag types, NDEF — nfcfyi.com
nihonshufyi	PyPI	npm	Go	80 sake, rice varieties, breweries — nihonshufyi.com
nutrifyi	PyPI	npm	Go	Nutrition data, food composition — nutrifyi.com
pillfyi	PyPI	npm	Go	Pill identification, FDA database — pillfyi.com
planefyi	PyPI	npm	Go	Aircraft models, specifications — planefyi.com
plantfyi	PyPI	npm	Go	379,774 plants, taxonomy — plantfyi.com
qrcodefyi	PyPI	npm	Go	QR code types, versions, encoding — qrcodefyi.com
quakefyi	PyPI	npm	Go	Earthquakes, seismic data — quakefyi.com
rfidfyi	PyPI	npm	Go	RFID tags, frequency bands, standards — rfidfyi.com
salaryfyi	PyPI	npm	Go	Salary comparison, tax calculators — salaryfyi.com
smartcardfyi	PyPI	npm	Go	Smart cards, EMV, APDU, Java Card — smartcardfyi.com
speciesfyi	PyPI	npm	Go	Species taxonomy, classification — speciesfyi.com
starfyi	PyPI	npm	Go	Stars, constellations, exoplanets — starfyi.com
statuscodefyi	PyPI	npm	Go	HTTP status codes, protocols — statuscodefyi.com
symbolfyi	PyPI	npm	Go	Symbol encoding in 11 formats — symbolfyi.com
teafyi	PyPI	npm	Go	60 tea varieties, teaware, brewing — teafyi.com
timefyi	PyPI	npm	Go	Timezone ops & business hours — timefyi.com
tldfyi	PyPI	npm	Go	TLD registry, domain extensions — tldfyi.com
trainfyi	PyPI	npm	Go	Railway stations, routes, networks — trainfyi.com
unicodefyi	PyPI	npm	Go	Unicode lookup with 17 encodings — unicodefyi.com
unitfyi	PyPI	npm	Go	Unit conversion, 220 units — unitfyi.com
univfyi	PyPI	npm	Go	University rankings, programs — univfyi.com
vinofyi	PyPI	npm	Go	Wines, grapes, regions, wineries — vinofyi.com
whiskeyfyi	PyPI	npm	Go	80 whiskey expressions, distilleries — whiskeyfyi.com
zipfyi	PyPI	npm	Go	ZIP/postal codes, geocoding — zipfyi.com

Links

• Site: nutrifyi.com
• API Docs: nutrifyi.com/api/v1/
• OpenAPI: nutrifyi.com/api/v1/schema/

License

MIT

Documentation

Overview

Package nutrifyi provides a Go client for the NutriFYI API (nutrifyi.com).

NutriFYI — zero dependencies, no authentication required.

Usage:

client := nutrifyi.NewClient()
result, err := client.Search("query")

Index

• Constants
• type Client
  • func NewClient() *Client
  • func (c *Client) Categories() (map[string]interface{}, error)
  • func (c *Client) Category(slug string) (map[string]interface{}, error)
  • func (c *Client) Comparison(slug string) (map[string]interface{}, error)
  • func (c *Client) Comparisons() (map[string]interface{}, error)
  • func (c *Client) Diet(slug string) (map[string]interface{}, error)
  • func (c *Client) Diets() (map[string]interface{}, error)
  • func (c *Client) Faq(slug string) (map[string]interface{}, error)
  • func (c *Client) Faqs() (map[string]interface{}, error)
  • func (c *Client) Food(slug string) (map[string]interface{}, error)
  • func (c *Client) Foods() (map[string]interface{}, error)
  • func (c *Client) Glossary() (map[string]interface{}, error)
  • func (c *Client) Guide(slug string) (map[string]interface{}, error)
  • func (c *Client) Guides() (map[string]interface{}, error)
  • func (c *Client) Nutrition() (map[string]interface{}, error)
  • func (c *Client) Search(query string) (map[string]interface{}, error)
  • func (c *Client) Series() (map[string]interface{}, error)
  • func (c *Client) Sery(slug string) (map[string]interface{}, error)
  • func (c *Client) Term(slug string) (map[string]interface{}, error)

Constants

const DefaultBaseURL = "https://nutrifyi.com"

DefaultBaseURL is the default API base URL.

Types

type Client

type Client struct {
	BaseURL    string
	HTTPClient *http.Client
}

Client is a NutriFYI API client.

func NewClient

func NewClient() *Client

NewClient creates a new NutriFYI API client.

func (*Client) Categories

func (c *Client) Categories() (map[string]interface{}, error)

Categories returns a list of categories.

func (*Client) Category

func (c *Client) Category(slug string) (map[string]interface{}, error)

Category returns details for a category by slug.

func (*Client) Comparison

func (c *Client) Comparison(slug string) (map[string]interface{}, error)

Comparison returns details for a comparison by slug.

func (*Client) Comparisons

func (c *Client) Comparisons() (map[string]interface{}, error)

Comparisons returns a list of comparisons.

func (*Client) Diet

func (c *Client) Diet(slug string) (map[string]interface{}, error)

Diet returns details for a diet by slug.

func (*Client) Diets

func (c *Client) Diets() (map[string]interface{}, error)

Diets returns a list of diets.

func (*Client) Faq

func (c *Client) Faq(slug string) (map[string]interface{}, error)

Faq returns details for a FAQ by slug.

func (*Client) Faqs

func (c *Client) Faqs() (map[string]interface{}, error)

Faqs returns a list of faqs.

func (*Client) Food

func (c *Client) Food(slug string) (map[string]interface{}, error)

Food returns details for a food by slug.

func (*Client) Foods

func (c *Client) Foods() (map[string]interface{}, error)

Foods returns a list of foods.

func (*Client) Glossary

func (c *Client) Glossary() (map[string]interface{}, error)

Glossary returns a list of glossary.

func (*Client) Guide

func (c *Client) Guide(slug string) (map[string]interface{}, error)

Guide returns details for a guide by slug.

func (*Client) Guides

func (c *Client) Guides() (map[string]interface{}, error)

Guides returns a list of guides.

func (*Client) Nutrition

func (c *Client) Nutrition() (map[string]interface{}, error)

Nutrition returns a list of nutrition.

func (*Client) Search

func (c *Client) Search(query string) (map[string]interface{}, error)

Search searches across all content.

func (*Client) Series

func (c *Client) Series() (map[string]interface{}, error)

Series returns a list of series.

func (*Client) Sery

func (c *Client) Sery(slug string) (map[string]interface{}, error)

Sery returns details for a sery by slug.

func (*Client) Term

func (c *Client) Term(slug string) (map[string]interface{}, error)

Term returns details for a Term by slug.