Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/nekkuzuria/cookpad-api
API to scrape and fetch random Cookpad recipes using provided ingredients
https://github.com/nekkuzuria/cookpad-api
api cheerio fastify nodejs web-scraping
Last synced: 3 months ago
JSON representation
API to scrape and fetch random Cookpad recipes using provided ingredients
- Host: GitHub
- URL: https://github.com/nekkuzuria/cookpad-api
- Owner: nekkuzuria
- Created: 2024-08-06T07:29:36.000Z (5 months ago)
- Default Branch: main
- Last Pushed: 2024-08-06T14:46:13.000Z (5 months ago)
- Last Synced: 2024-09-28T11:22:38.576Z (3 months ago)
- Topics: api, cheerio, fastify, nodejs, web-scraping
- Language: JavaScript
- Homepage:
- Size: 2.72 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
## Cookpad Recipe Scraper API
This project is a simple API to scrape recipes from Cookpad based on provided ingredients. It uses Fastify, Axios, and Cheerio for web scraping.
**Prerequisites**
- Node.js (version 14 or higher)
- npm or yarn
- API Key from [AbstractAPI](https://www.abstractapi.com/)
**Getting Started**
1. Clone the repository:
```bash
git clone https://github.com/yourusername/cookpad-api
cd cookpad-api
```
2. Install dependencies:
```bash
npm install
# or
yarn install
```
3. Create Environment Configuration:
- Copy the .env.example file to .env:
```bash
cp .env.example .env
```
- Open the .env file and add your AbstractAPI key:
```bash
API_KEY=your_abstractapi_key_here
```
You need to generate an API key from [AbstractAPI](https://www.abstractapi.com/)
4. Start the server:
```bash
node server.js
```
The server will start on http://localhost:3000.
**API Endpoint**
To search for recipes using specific ingredients, send a GET request to:
```bash
http://localhost:3000/recipes?ingredients=your_ingredients
```
Replace your_ingredients with the ingredients you want to search for.
**Functionality**
- The API fetches a list of recipes from Cookpad based on the provided ingredients.
- It randomly selects a recipe from the list and returns the recipe details.
- The returned data includes the recipe title, image URL, ingredients, and the Cookpad recipe URL.
**Example Request and Response**
Request:
```bash
http://localhost:3000/api/search?ingredients=tepung%20telur
```
Response:
```json
{
"title": "Telur Dadar Buncis Kentang Tepung Beras",
"image": "https://img-global.cpcdn.com/recipes/96d390d8744a5391/160x176cq30/telur-dadar-buncis-kentang-tepung-beras-foto-resep-utama.jpg",
"ingredients": "telur ayam,\n buncis,\n kentang,\n Tepung beras,\n Bahan lainya :,\n cabe giling,\n garam,\n kaldu bubuk,\n lada bubuk,\n air putih,\n minyak goreng",
"url": "https://cookpad.com/id/resep/17196667-telur-dadar-buncis-kentang-tepung-beras"
}
```