ipfyi

README

ipfyi-go

Go client for the IPFYI REST API. IP geolocation, ASN lookup. Zero external dependencies beyond stdlib.

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

Install

go get github.com/fyipedia/ipfyi-go

Quick Start

package main

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

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

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

API Methods

Method	Description
Asns()	List asns
Cities()	List cities
Faqs()	List faqs
GlossaryCategories()	List glossary categories
GlossaryTerms()	List glossary terms
IpRanges()	List ip ranges
Isps()	List isps
Threats()	List threats
Search(query)	Search across all content

Also Available

Platform	Package	Link
Python	pip install ipfyi	PyPI
npm	npm install ipfyi	npm
Go	go get github.com/fyipedia/ipfyi-go	pkg.go.dev
Rust	cargo add ipfyi	crates.io
Ruby	gem install ipfyi	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: ipfyi.com
• API Docs: ipfyi.com/api/v1/
• OpenAPI: ipfyi.com/api/v1/schema/

License

MIT

Documentation

Overview

Package ipfyi provides a Go client for the IPFYI API (ipfyi.com).

IPFYI — zero dependencies, no authentication required.

Usage:

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

Index

• Constants
• type Client
  • func NewClient() *Client
  • func (c *Client) Asn(slug string) (map[string]interface{}, error)
  • func (c *Client) Asns() (map[string]interface{}, error)
  • func (c *Client) Cities() (map[string]interface{}, error)
  • func (c *Client) City(slug string) (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) GlossaryCategories() (map[string]interface{}, error)
  • func (c *Client) GlossaryCategory(slug string) (map[string]interface{}, error)
  • func (c *Client) GlossaryTerm(slug string) (map[string]interface{}, error)
  • func (c *Client) GlossaryTerms() (map[string]interface{}, error)
  • func (c *Client) IpRange(slug string) (map[string]interface{}, error)
  • func (c *Client) IpRanges() (map[string]interface{}, error)
  • func (c *Client) Isp(slug string) (map[string]interface{}, error)
  • func (c *Client) Isps() (map[string]interface{}, error)
  • func (c *Client) Search(query string) (map[string]interface{}, error)
  • func (c *Client) Threat(slug string) (map[string]interface{}, error)
  • func (c *Client) Threats() (map[string]interface{}, error)

Constants

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

DefaultBaseURL is the default API base URL.

Types

type Client

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

Client is a IPFYI API client.

func NewClient

func NewClient() *Client

NewClient creates a new IPFYI API client.

func (*Client) Asn

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

Asn returns details for a asn by slug.

func (*Client) Asns

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

Asns returns a list of asns.

func (*Client) Cities

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

Cities returns a list of cities.

func (*Client) City

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

City returns details for a city by slug.

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) GlossaryCategories

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

GlossaryCategories returns a list of glossary categories.

func (*Client) GlossaryCategory

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

GlossaryCategory returns details for a glossary category by slug.

func (*Client) GlossaryTerm

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

GlossaryTerm returns details for a glossary term by slug.

func (*Client) GlossaryTerms

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

GlossaryTerms returns a list of glossary terms.

func (*Client) IpRange

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

IpRange returns details for a ip range by slug.

func (*Client) IpRanges

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

IpRanges returns a list of ip ranges.

func (*Client) Isp

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

Isp returns details for a isp by slug.

func (*Client) Isps

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

Isps returns a list of isps.

func (*Client) Search

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

Search searches across all content.

func (*Client) Threat

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

Threat returns details for a threat by slug.

func (*Client) Threats

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

Threats returns a list of threats.