Rakuten Recipe Scraper - Apify Actor

Scrape Rakuten Recipe data using the official Rakuten API. Extract recipe categories, top-ranked recipes with ingredients, cooking times, costs, and high-resolution images.

Features

• Category Tree: Fetch the complete Rakuten Recipe category hierarchy (large / medium / small).
• Recipe Rankings: Get top-ranked recipes for any category, including ingredients, descriptions, and images.
• Auto-Iteration: When no category is specified, automatically iterates through top-level categories.
• Rate Limited: Built-in 1 req/sec rate limiting to respect API terms.
• Retry Logic: Automatic retries with exponential backoff on transient errors.

Use Cases

• Japanese Cooking Research: Build a database of popular Japanese recipes, ingredients, and cooking methods.
• Food Content Creation: Source recipe data for cooking blogs, meal planning apps, or food media.
• Ingredient Analysis: Analyze common ingredients across recipe categories for market research.
• Recipe Aggregation: Combine Rakuten Recipe data with other sources for comprehensive recipe databases.

Input Parameters

Parameter	Type	Required	Default	Description
application_id	string	Yes	-	Rakuten API Application ID
access_key	string	Yes	-	Rakuten API Access Key
mode	string	No	ranking	categories or ranking
category_id	string	No	-	Category ID for ranking mode
max_results	integer	No	40	Max items to return (1-1000)
log_level	string	No	INFO	DEBUG, INFO, WARNING, ERROR

Output Examples

Categories Mode

{
    "category_id": "30",
    "category_name": "人気メニュー",
    "category_url": "https://recipe.rakuten.co.jp/category/30/",
    "parent_category_id": null,
    "category_type": "large"
}

Ranking Mode

{
    "recipe_id": 1570003792,
    "recipe_title": "簡単☆本格ハンバーグソース",
    "recipe_url": "https://recipe.rakuten.co.jp/recipe/1570003792/",
    "food_image_url": "https://image.space.rakuten.co.jp/...",
    "nickname": "LUKママ",
    "recipe_description": "ハンバーグを焼いた後のフライパンで作ります。",
    "recipe_material": ["ケチャップ", "ソース", "バター", "砂糖"],
    "recipe_indication": "指定なし",
    "recipe_cost": "指定なし",
    "rank": 1,
    "category_id": "30"
}

Getting API Credentials

1. Register at Rakuten Developers.
2. Create an application to get your Application ID and Access Key.
3. The Recipe API is free to use with rate limits.

Technology

Built with Python 3.12, aiohttp, Pydantic v2, and the Apify SDK. Uses the new openapi.rakuten.co.jp API endpoints (migrated Feb 2026).