All API requests should be made to:

https://api.hfresh.info

The API uses Bearer token authentication. Include your API token in the Authorization header of every request.

Authorization: Bearer YOUR_API_TOKEN

Sign in to create and manage your API tokens.

Most endpoints require a locale and country prefix in the URL path. This determines the language and region for the response data.

GET https://api.hfresh.info/{locale}-{country}/recipes

Example: de-DE for German (Germany), en-GB for English (Great Britain).

Use the Countries endpoint to get a list of available countries.

API requests are limited to 60 requests per minute per user. If you exceed this limit, you will receive a 429 Too Many Requests response.

Rate limit headers are included in every response:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59

Note: The rate limit may be adjusted in the future. Always check the X-RateLimit-Limit header for the current limit.

List endpoints return paginated results. Use the per_page query parameter to control the number of results (10-200, default 50).

GET https://api.hfresh.info/de-DE/recipes?per_page=25&page=2

Paginated responses include a meta object with pagination information:

{
    "data": [...],
    "meta": {
        "current_page": 2,
        "from": 26,
        "last_page": 10,
        "per_page": 25,
        "to": 50,
        "total": 250
    }
}

All responses are returned in JSON format. Include the Accept: application/json header in your requests.

Successful responses return HTTP status 200 OK. Error responses include a message explaining what went wrong:

{
    "message": "Unauthenticated."
}

curl -X GET "https://api.hfresh.info/de-DE/recipes?per_page=10" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Accept: application/json"

Download the API specification files to import into your favorite API client.