Install Jentic One Beta

Connect the CalorieKing Food API to your agent

Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the CalorieKing Food API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.

Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.

Step 1: Jentic One Host machine

# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fcalorieking.com%2Fcalorieking" | sh

Step 2: Agent machine

# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fcalorieking.com%2Fcalorieking" | sh
jentic register       # connects your agent to your Jentic One instance

Jentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.

Capabilities

What an agent can do with CalorieKing Food API.

Search the food catalog by keyword and filter results by brand, category, or tag

Retrieve a single food record with serving sizes and nutrient values via /foods/{foodId}

List and look up branded foods to attach packaged-product context to a meal log

Browse the category tree to constrain searches to specific food groups

GET STARTED

Start building with CalorieKing Food API

Explore with Jentic One

View OpenAPI Document

Use Cases

Patterns agents use CalorieKing Food API for, with concrete tasks.

★ Meal Logging and Calorie Tracking

Power a calorie-tracking app or agent that lets users log meals by searching the CalorieKing catalog. The /foods endpoint returns matching items with calorie and macronutrient data, and /foods/{foodId} retrieves a full nutrition record once the user picks an entry. Partial-response parameters keep mobile payloads small.

Search /foods for 'grilled chicken breast', present the top three matches to the user, then call /foods/{foodId} for the chosen item and return calories, protein, and fat per serving.

Branded Product Lookup for Recipe Apps

Recipe and pantry apps often need to attach branded product data to ingredient entries. The /brands and /brands/{brandId} endpoints let an agent confirm a brand exists in the catalog, then narrow a /foods search by brand to retrieve matching SKUs with packaged nutrition information.

Look up the brand 'Kelloggs' via /brands, then call /foods filtered by that brand to list cereal products with calories per serving.

Dietary Filtering for Meal Planners

Meal-planning agents need to surface foods that match dietary constraints. The /tags endpoint returns the catalog's dietary tags such as vegetarian or gluten-free, which can then be passed as a filter on /foods to retrieve only compliant items.

Fetch the tag list via /tags, find the 'gluten-free' tag ID, and call /foods filtered by that tag to return 20 gluten-free options with calorie counts.

AI Agent Nutrition Workflows via Jentic

Through Jentic, an AI agent discovers CalorieKing operations by intent, loads the input schema for /foods, and executes a search without browsing docs or handling Basic Auth tokens directly. Jentic's vault holds the access token used as the Basic Auth username, so the agent only sees scoped tool results.

Use the Jentic SDK to search for 'find food nutrition', load the /foods operation schema, and execute it with a query for 'oatmeal' to return the top result's calorie value.

Key Endpoints

8 endpoints — jentic publishes the only available openapi specification for calorieking food api, keeping it validated and agent-ready.

METHOD

PATH

DESCRIPTION

GET

/foods

Search and list foods with filters

GET

/foods/{foodId}

Retrieve a specific food's nutrition record

GET

/brands

List food brands

GET

/categories

List food categories

GET

/tags

List dietary tags

GET

/foods

Search and list foods with filters

GET

/foods/{foodId}

Retrieve a specific food's nutrition record

GET

/brands

List food brands

GET

/categories

List food categories

GET

/tags

List dietary tags

Why Jentic?

What agents get from Jentic-routed access to this vendor.

Setup

Wiring the CalorieKing Food API by hand means encoding your token into HTTP Basic auth and paging through its food, brand, category, and tag routes yourself. Through Jentic you install once, import CalorieKing from the API Directory, store the credential once, and your agent calls it.

Permission scoping

CalorieKing exposes read-only lookups, so scope the agent to the operations it needs, such as food and brand searches. You choose the operations it may call, so the agent is limited to the read routes you enable and nothing beyond them.

Credential isolation

Your CalorieKing token is stored once, encrypted, by your own Jentic One instance and placed into the Basic auth username at execution time. It never enters the agent's prompt, logs, or context.

Intent-based discovery

Agents search Jentic by intent such as 'find nutrition for a food' or 'look up a brand', and Jentic returns the matching CalorieKing operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

FAQs

Specific to using CalorieKing Food API through Jentic.

Why is there no official OpenAPI spec for CalorieKing Food API?

CalorieKing does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call CalorieKing Food API via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

What authentication does the CalorieKing Food API use?

The API uses HTTP Basic authentication. The access token issued by CalorieKing is used as the username and the password is left blank. When called through Jentic, the access token is stored in your Jentic One instance and injected into the Basic Auth header at execution time, so it never enters the agent's prompt context.

Can I retrieve the full nutrition profile for a specific food?

Yes. Call GET /foods/{foodId} with the ID returned from a /foods search to retrieve the full record, which includes serving sizes and nutrient values. Use partial-response query parameters if you only need a subset of fields.

How do I filter foods by dietary tag through Jentic?

First call GET /tags to retrieve the list of dietary tags and find the ID for the tag you need (for example, gluten-free). Then call GET /foods with the tag filter applied. Through Jentic, search 'find food by dietary tag', load the /foods schema, and execute with the tag ID parameter.

What are the rate limits for the CalorieKing Food API?

The OpenAPI specification does not document rate limits. CalorieKing applies limits at the access-token level based on your developer plan, so check the agreement attached to your token. Jentic surfaces 429 responses unchanged so your agent can back off and retry.

Does the API return branded product nutrition data?

Yes. Use GET /brands to discover available manufacturers, then filter GET /foods by brand to return that brand's products with calorie and macronutrient values per serving.

Can I limit what my agent is allowed to do with the CalorieKing Food API?

Yes. Because Jentic One is self-hosted, you decide which CalorieKing operations your agent may call, and your own rules govern the credentials it can use. Since this API is read-only, you can scope the agent to just the lookups it needs, such as the /foods search and /foods/{foodId} record retrieval, while leaving /brands, /categories, or /tags disabled. The agent is limited to the read routes you enable and can reach nothing beyond them.

CalorieKing Food API

Name: CalorieKing Food API
Brand: CalorieKing Food API
Availability: InStock

Agent-ready OpenAPI document · curated by JenticData EnrichmentData Transformationbasic8 EndpointsREST

Know of an official OpenAPI document? Contribute it →

For Agents

Search a curated nutrition database for foods, brands, categories, and tags, and retrieve detailed nutrient records by ID.

Use for: Search for a food by name in the CalorieKing database, Get the calorie and macronutrient values for a specific food ID, List all brands available in the food catalog, Find all foods tagged as gluten-free

Not supported: Does not handle recipe generation, meal-plan creation, or barcode scanning - use for structured food, brand, category, and tag lookups only.

Jentic publishes the only available OpenAPI specification for CalorieKing Food API, keeping it validated and agent-ready. The CalorieKing Food API exposes a curated database of foods, brands, food categories, and dietary tags drawn from the long-running CalorieKing nutrition catalog. Agents can search foods by name, narrow results by brand or category, and retrieve a single food record with macronutrient and serving-size details. Filtering, paging, and partial-response query parameters keep payloads small for nutrition-tracking, meal-planning, and recipe-analysis workloads.

Jentic One on Github View OpenAPI Document