foodtales 0.1.0

Official Python SDK for the Food Tales Knowledge API

foodtales

Official Python SDK for the Food Tales Knowledge API.

Zero runtime dependencies (stdlib urllib only).

Install

pip install foodtales
# or
uv pip install foodtales
# or
poetry add foodtales

Quickstart

import os
from foodtales import FoodTalesClient, FoodTalesError

ft = FoodTalesClient(api_key=os.environ["FOODTALES_API_KEY"])

try:
    page = ft.search(q="biryani", limit=5, mode="lexical")
    print(page.data)
    print(page.credits)  # used / remaining / reset_at
except FoodTalesError as err:
    print(err.status, err.code, err.message)

Methods

Method	Endpoint
search	GET /v1/search
get_dish	GET /v1/dishes/{ref}
dish_relationships	GET /v1/dishes/{ref}/relationships
dish_ingredients	GET /v1/dishes/{ref}/ingredients
dish_recipes	GET /v1/dishes/{ref}/recipes
similar_dishes	GET /v1/similar/dishes/{ref}
similar_recipes	GET /v1/similar/recipes/{ref}
search_ingredients	GET /v1/ingredients
get_ingredient	GET /v1/ingredients/{id}
ingredient_recipes	GET /v1/ingredients/{id}/recipes
coverage	GET /v1/coverage/dishes
trust / browse / siblings	public demo endpoints (no key)

Auth header: X-Api-Key.

Docs

• Website: foodtales.ai/docs/sdks
• Knowledge API: knowledge.foodtales.ai
• OpenAPI: knowledge.foodtales.ai/openapi.json

Develop (contributors)

pip install ./sdk/python
python -m unittest discover -s sdk/python/tests -v