Quickstart

Get up and running with the Journey Foods API in under 5 minutes.

Create an API key

First, Loading... in your dashboard. Keep this key secure and never expose it in client-side code.

Set your API key as an environment variable:

export JOURNEYFOODS_API_KEY="sk-jf-your-api-key-here"

Install the SDK

Coming SoonIn Development

Official SDKs for JavaScript, Python, and Ruby are currently in development. In the meantime, you can use the REST API directly.

Make your first API call

Fetch ingredient data with a simple API call:

curl https://api.journeyfoods.com/v1/ingredients/ing_tomato_001 \
  -H "Authorization: Bearer $JOURNEYFOODS_API_KEY" \
  -H "Content-Type: application/json"

curl https://api.journeyfoods.com/v1/ingredients/ing_tomato_001 \
  -H "Authorization: Bearer $JOURNEYFOODS_API_KEY" \
  -H "Content-Type: application/json"

Response

Response200 OK

{
  "id": "ing_tomato_001",
  "name": "Tomato, raw",
  "category": "vegetables",
  "nutrients": {
    "calories": 18,
    "protein": 0.9,
    "carbohydrates": 3.9,
    "fiber": 1.2,
    "sugar": 2.6,
    "fat": 0.2,
    "vitamin_c": 13.7,
    "vitamin_a": 42,
    "potassium": 237
  },
  "allergens": [],
  "sustainability_score": 8.5,
  "unit": "per 100g"
}

{
  "id": "ing_tomato_001",
  "name": "Tomato, raw",
  "category": "vegetables",
  "nutrients": {
    "calories": 18,
    "protein": 0.9,
    "carbohydrates": 3.9,
    "fiber": 1.2,
    "sugar": 2.6,
    "fat": 0.2,
    "vitamin_c": 13.7,
    "vitamin_a": 42,
    "potassium": 237
  },
  "allergens": [],
  "sustainability_score": 8.5,
  "unit": "per 100g"
}

Field	Type	Description
id	string	Unique identifier for the ingredient
name	string	Human-readable name
category	string	Food category classification
nutrients	object	Nutritional information per serving
allergens	array	List of allergen identifiers
sustainability_score	number	Environmental impact score (0-10)

Next steps

Explore Ingredients

Search and filter our database of 100,000+ ingredients.

AI Formulations

Create optimized food formulations with AI assistance.

Sustainability Data

Access environmental impact metrics for ingredients.

View Examples

Browse real-world projects built with our API.

Congratulations!

You've made your first API call. Explore the full API reference to discover all available endpoints and features.