Pepesto Grocery Shopping API

Overview

Pepesto provides a service that allows client apps and agents to enable grocery shopping for their users. To do this, they provide Pepesto with a list of recipes and/or a shopping list. Pepesto processes this information and returns a redirect URL.

The redirect URL can be opened by the end user in a browser, or embedded in an app or website. On that URL, users can modify their shopping cart and purchase the groceries through one of the many supermarkets in Europe supported by Pepesto.

To call the demo, use the following command:

    curl -X POST "https://s.pepesto.com/api/shop" \
     -H "Content-Type: application/json" \
     -d '{
         "content_urls": ["https://www.bbcgoodfood.com/recipes/pizza-margherita-4-easy-steps"],
         "content_text": "also add milk, bananas, and kitchen towel"
     }'

API Documentation

Request

    type ShopRequest struct {
    // List of URLs containing recipes or shopping lists.
    // The content must be accessible via a simple HTTP GET request (no authentication, no client-side JavaScript, etc.).
    // If the content is not accessible, use a scraping service and pass the content as plain text in the field below.
    ContentUrls []string `json:"content_urls"`
    
    // Free-form text describing a recipe or a shopping list.
    ContentText string `json:"content_text"`
    
    // Image of a recipe or a shopping list.
    ContentImageUrl string `json:"content_image"`
    }

Response

    type ShopResponse struct {
    // A URL pointing to "https://s.pepesto.com".
    // Opening the result page allows the user to view the intended products and complete the purchase.
    // The result page can either be opened in an external browser, or embedded as an iframe in a client website, or app.
    RedirectUrl string `json:"redirect_url"`
    }

Embedding the Result Page

To embed the result page, use the following HTML:

    <div id="dockable-iframe-container"></div>
    <script src="https://s.pepesto.com/dockable.js" pepesto-source-url="REDIRECT_URL_RETURNED_BY_THE_SHOPPING_API"></script>

Demo

Output

Result URL: https://app.pepesto.com

    <div id="dockable-iframe-container"></div>
    <script src="https://s.pepesto.com/dockable.js" pepesto-source-url="https://app.pepesto.com"></script>

IFrame Output

🤖 MCP-Compatible Tool Definition

Pepesto’s grocery shopping API is available as a Model Context Protocol (MCP)-compatible tool, enabling structured function-style access for use in AI agents and orchestration frameworks like OpenAI Tools, LangChain, and others.

This MCP-compatible tool accepts inputs such as recipe URLs, free-form shopping list text, or images, and returns a redirect_url pointing to a smart shopping interface. Users can view, modify, and complete their grocery orders through the Pepesto ecosystem.

📄 Tool Definition

{
  "name": "createShoppingCart",
  "description": "Creates a grocery shopping cart from recipes, free text, or image inputs. This tool provides a simple, unified API to convert recipe or shopping list inputs into real-world grocery orders across supported supermarkets in Europe.\n\nInput can include a single recipe, a weekly meal plan, or a free-form shopping list. Pepesto abstracts away the complexity of retailer integration and offers a clean endpoint that generates a smart cart experience for users.\n\n🛍️ Ingredients are automatically mapped to real products available in nearby stores.\n🧾 Users can review their cart, swap items, and mark ingredients they already have.\n🧭 The generated interface can be embedded in apps or accessed via redirect.\n✅ Final checkout requires the user to install or access the Pepesto app.\n\nThe tool returns a `redirect_url` pointing to a smart shopping interface hosted on s.pepesto.com.",
  "type": "http",
  "metadata": {
    "method": "POST",
    "url": "https://s.pepesto.com/api/shop",
    "contentType": "application/json"
  },
  "parameters": {
    "type": "object",
      ...

🔗 View full tool schema