# Scrape Sandbox API: Get first catalog products

> Lists the 20 products on the first Books to Scrape catalog page, with each product's detail page link, full title, displayed price and stock status.

Unofficial. Not affiliated with or endorsed by Scrape Sandbox.

- Page: https://fous.com/methods/books.toscrape.com/get-first-catalog-products
- Method: `books.toscrape.com/get_first_catalog_products`, version 1
- Website: books.toscrape.com
- Returns: products: name, product_url, published_price, availability
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

No inputs.

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{}
```

Its output:

```json
{
  "products": [
    {
      "name": "A Light in the Attic",
      "product_url": "https://books.toscrape.com/catalogue/a-light-in-the-attic_1000/index.html",
      "availability": "In stock",
      "published_price": "£51.77"
    },
    {
      "name": "Tipping the Velvet",
      "product_url": "https://books.toscrape.com/catalogue/tipping-the-velvet_999/index.html",
      "availability": "In stock",
      "published_price": "£53.74"
    },
    {
      "name": "Soumission",
      "product_url": "https://books.toscrape.com/catalogue/soumission_998/index.html",
      "availability": "In stock",
      "published_price": "£50.10"
    }
  ]
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"method":"books.toscrape.com/get_first_catalog_products","input":{}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## Ask your agent

- Can you pull up the first page of books from the Books to Scrape catalog with each title, price, and whether it's in stock?
- I need a list of the 20 books on page one: full names, their detail page URLs, listed prices, and availability.
- Show me the opening batch of books on toscrape.com with their product links and whether each one is available.
- What are the first twenty titles in the book catalog, and how much does each one cost right now?
- Grab the initial listing of books, including each product URL and its stock status, so I can compare prices.

## Input schema

```json
{
  "type": "object",
  "required": [],
  "properties": {}
}
```

## Output schema

```json
{
  "type": "object",
  "required": [
    "products"
  ],
  "properties": {
    "products": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "product_url",
          "name",
          "published_price",
          "availability"
        ],
        "properties": {
          "name": {
            "type": "string",
            "description": "Complete product title from its catalog listing."
          },
          "product_url": {
            "type": "string",
            "description": "Absolute URL of the book's detail page."
          },
          "availability": {
            "type": "string",
            "description": "Displayed stock status without extra whitespace."
          },
          "published_price": {
            "type": "string",
            "description": "Price exactly as displayed, including currency symbol."
          }
        },
        "additionalProperties": false
      },
      "description": "The 20 products displayed on the first catalog page, in page order."
    }
  },
  "additionalProperties": false
}
```

## See more

- [Shop API: List store products](https://fous.com/methods/shop.app/list-store-products.md): Lists publicly published products from a Shopify store in catalogue or collection order, with variant prices and availability, optionally filtered by name words or an exact collection name.
- [Amazon API: Search products](https://fous.com/methods/amazon.com/search-products.md): Searches Amazon products in a chosen country store, with price range, sort, Prime and page options. Returns the listings and prices shown to an anonymous shopper in the store's currency.
- [Shop API: Get Shopify store product](https://fous.com/methods/shop.app/get-store-product.md): Gets a public Shopify product by its product page link, or by the closest name match within a store. Stores that restrict public product access cannot be read.
- [Amazon API: Get product](https://fous.com/methods/amazon.com/get-product.md): Gets details for an Amazon product, found by name or by link, in a chosen country store. Offer prices, delivery and variants may be missing when Amazon does not show them publicly.
- [Alibaba API: Get product offer](https://fous.com/methods/alibaba.com/get-product.md): Gets one Alibaba wholesale offer from a product link, or from a product name plus supplier name.
- [Argos API: Search products](https://fous.com/methods/argos.co.uk/search-products.md): Searches Argos UK products by keyword in the selected sort order, returning prices, ratings and links. Delivery and collection availability appear only when shown on the site.
- [Apple API: Get Apple Store product prices](https://fous.com/methods/apple.com/get-product-prices.md): Gets current Apple Store prices and the configurations on sale for a product in one country. It includes only models sold on that country's public store.
- [Open Library API: Get book details](https://fous.com/methods/openlibrary.org/get-book.md): Gets a book's catalog details from Open Library by its title, with an optional author or ISBN to identify the right book. Reading availability reflects listed editions; details may be missing when the catalog has none.