Macrofy Documentation

Nutrition data is messy. Macrofy gives you a nunified api for nutrition intelligence: with over 3M verified food items, image analysis, and secure developer-scoped authentication.

You keep ownership of your end-user identities. Macrofy verifies your signatures, issues scoped sessions, and powers your nutrition product with API + SDK primitives designed for production.

Quickstart Explore SDK

Your first 5 minutes

Create an application in the dashboard and copy your appId and appSecret.
Generate an HMAC signature on your server for a user identifier.
Connect the SDK with { appId, userId, signature }.
Start requesting food search, barcode, and scan workflows immediately.

If this is your first integration, start with Authentication, then move to Quickstart.

Implement the handshake

Guides

Authentication

Learn how to authenticate your API requests.

Errors

Read about the different types of errors returned by the API.

Resources

Food

Learn about the food model and how to search the nutrition database or resolve barcodes.

Scan

Learn about the image scanning API, how to create processing jobs, upload images, and stream AI analysis results in real-time.

Diary

Learn about the diary model and how to manage user nutrition entries and retrieve daily totals.

Profile

Learn about the user profile model, demographic settings, and computed daily macro goals.