Quickstart

The TL;DR version

Step 1: Get a Bearer Token

Exchange your Nutrition AI key for a Bearer token. Tokens last ~24 hours.

cURL

curl -X POST "https://api.passiolife.com/v2/token-cache/unified/oauth/token/YOUR_NUTRITION_AI_KEY"

Python

import requests

url = "https://api.passiolife.com/v2/token-cache/unified/oauth/token/YOUR_NUTRITION_AI_KEY"

r = requests.post(url)
r.raise_for_status()
data = r.json()
print(data)

The response contains the access_token and customer_id you need for all subsequent requests:

{
    "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCIsImupZCI6InNab1FMT...",
    "scope": "read:search read:products",
    "expires_in": 86155,
    "token_type": "Bearer",
    "customer_id": "0d8bb889-36e1-11ee-b9e9-92e504c243a4"
}

Step 2: Make Your First API Call

Use the access_token and customer_id from Step 1 as headers on every request.

API Service Documentation

cURL

curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Passio-ID: YOUR_CUSTOMER_ID" \
     "https://api.passiolife.com/v2/products/napi/food/search/semantic?term=pepperoni%20pizza"

Python

import requests

headers = {
    "Authorization": "Bearer YOUR_ACCESS_TOKEN",
    "Passio-ID": "YOUR_CUSTOMER_ID"
}

url = "https://api.passiolife.com/v2/products/napi/food/search/semantic?term=pepperoni%20pizza"

r = requests.get(url, headers=headers)
print(r.json())