matprat.no APImatprat.no ↗
Access Matprat.no recipes, weekly meal plans, popular dishes, and autocomplete suggestions via 5 structured endpoints. Get ingredients, nutrition, ratings, and more.
curl -X GET 'https://api.parse.bot/scraper/3da2a980-e1c7-407d-b676-13e7a80ebbd0/get_recipe?url=%2Foppskrifter%2Frask%2Fpasta-puttanesca%2F' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch full details of a single recipe by its URL path. Returns structured recipe data including name, description, ingredients, instructions, nutrition, ratings, and a related recipe suggestion.
| Param | Type | Description |
|---|---|---|
| urlrequired | string | URL path of the recipe on matprat.no (e.g. /oppskrifter/rask/pasta-puttanesca/). |
{
"type": "object",
"fields": {
"name": "string — recipe title",
"nutrition": "object with calories, carbohydrateContent, proteinContent, fatContent",
"api_rating": "object with detailed rating info from the API",
"description": "string — short recipe description",
"aggregateRating": "object with ratingValue and ratingCount",
"recipeIngredient": "array of ingredient strings",
"recipeInstructions": "array of HowToStep objects with text field",
"api_related_recipes": "object with a related recipe suggestion"
},
"sample": {
"data": {
"name": "Pasta puttanesca",
"nutrition": {
"@type": "NutritionInformation",
"calories": "761 KCAL",
"fatContent": "40 G",
"proteinContent": "21 G",
"carbohydrateContent": "74 G"
},
"api_rating": {
"rating": 5,
"ratingCount": 2,
"ratingPrecise": 5
},
"description": "En klassisk italiensk pastarett! Pasta puttanesca lages med ansjos, oliven og chili, og får en umamirik saus. Enkel vanskelighetsgrad",
"recipeYield": "2 PORSJONER",
"recipeCategory": [
"Pasta"
],
"aggregateRating": {
"@type": "AggregateRating",
"ratingCount": 2,
"ratingValue": 5
},
"recipeIngredient": [
" 200 g spagetti",
" 2 båter hvitløk",
" 0,5 stk. rød chili"
],
"recipeInstructions": [
{
"text": "Kok spagetti i godt saltet vann etter anvisning på pakken.",
"@type": "HowToStep"
}
],
"api_related_recipes": {
"url": "/oppskrifter/familien/pasta-med-kikertboller-og-gulrotpesto/",
"name": "Pasta med kikertboller og gulrotpesto"
}
},
"status": "success"
}
}About the matprat.no API
The Matprat.no API exposes 5 endpoints covering recipe search, full recipe details, weekly meal plans, popular recipes, and autocomplete suggestions from Norway's largest recipe platform. The get_recipe endpoint returns structured data including ingredients, step-by-step instructions, nutrition facts, and aggregate ratings for any recipe on the site. Whether you're building a meal planner or a recipe discovery tool, the API delivers consistently structured JSON across all endpoints.
Recipe Data
The get_recipe endpoint accepts a URL path (e.g. /oppskrifter/rask/pasta-puttanesca/) and returns a detailed object including name, description, recipeIngredient (an array of ingredient strings), recipeInstructions (an array of HowToStep objects each with a text field), and a nutrition object containing calories, carbohydrateContent, proteinContent, and fatContent. Ratings are available both as an aggregateRating object (with ratingValue and ratingCount) and a more detailed api_rating object. A related recipe suggestion is returned in api_related_recipes.
Search and Discovery
The search_recipes endpoint supports keyword queries via the query parameter and accepts multiple filter parameters including origins, commodity, diet_type, prep_time, and categories. Filter ID values can be discovered from the searchFilters array returned in any search response. Results include totalHits, a searchHits array with recipe id and title, and searchGroups for content-type breakdowns. The sort parameter accepts relevant, new, or popular. The get_popular_recipes endpoint follows the same response shape but is pre-sorted by popularity and supports pagination via the page parameter.
Weekly Meal Plans and Autocomplete
The get_weekly_menu endpoint returns Matprat's editorial weekly meal plan for a specified ISO week and year, defaulting to the current week. Each day in the data array includes id, name, day, linkUrl, ingredients, rating, difficulty, and preparationTime. The autocomplete endpoint takes a search query prefix and returns an items array where each suggestion carries a type field (filter or content) alongside its data, plus a totalHits count — useful for building real-time search interfaces.
- Build a Norwegian recipe discovery app using
search_recipeswithdiet_typeandprep_timefilters - Display weekly dinner plans by pulling structured day-by-day recipes from
get_weekly_menu - Populate a nutrition tracker with
calories,proteinContent, andfatContentfromget_recipe - Create a meal-planning tool that surfaces
preparationTimeanddifficultyfrom weekly plan data - Implement real-time recipe search suggestions using the
autocompleteendpoint with a typed prefix - Aggregate ingredient lists from
recipeIngredientarrays to generate automated grocery shopping lists - Rank or curate recipes by
ratingValueandratingCountfromaggregateRatingfields
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Matprat.no have an official public developer API?+
What filters can I pass to `search_recipes`, and where do I get valid filter IDs?+
origins, commodity, diet_type, prep_time, and categories as filter parameters. Valid filter ID values are returned in the searchFilters array of any search response — each filter group includes its available options, so you can discover IDs dynamically by making an initial unfiltered request.Does `get_recipe` return user-submitted reviews or only aggregate ratings?+
aggregateRating (with ratingValue and ratingCount) and a detailed api_rating object. Individual user review text is not currently exposed. The API covers recipe content, nutrition, instructions, and rating summaries. You can fork it on Parse and revise to add the missing endpoint if individual review access becomes a requirement.Can I retrieve meal plans for past or future weeks, or only the current week?+
get_weekly_menu accepts both a week (ISO week number) and year parameter, so you can request plans for specific past or future weeks. If both are omitted, the endpoint defaults to the current week and year.