Skip to content
Scrappa Get API key
Tchibo API 1 credit / request

Tchibo Category Products API Documentation

GET https://scrappa.co/api/tchibo/category?path=%2Fkaffee%2Fkaffees&page=1&site=DE

GET /api/tchibo/category lists public products of a Tchibo category as JSON. A page holds 24 products. Pass path=/ to get the public category tree with path, title and id for every category. That tree is the id source for a real path; it still costs one credit.

What you get

Every product has id, article_id, title, url, price, original_price, discount_percent, currency, on_sale, availability, is_shortage, images and coffee specs. original_price is present only when Tchibo shows a real old price; an old price of 0 is never returned as a price. images are full-size HTTPS URLs. Ids are kept byte-for-byte so they work in the product and reviews endpoints.

Filters and pages

filters takes a facet slug such as coffee_form-gemahlen; repeat it for several facets. Tchibo applies them upstream. An item that visibly breaks a requested facet is removed, and filtered_out counts those items. page is 1-based; paging happens only on the JSON surface. Duplicate ids within one page are removed. A page past the end is empty, never page 1 relabelled. A client facing sort is not offered yet, because no sorting value was confirmed to change the order (gap G-2).

Credits

A successful request costs 1 credit. Mobile egress is free. Errors, blocks and 404 answers cost nothing. The response shows the charge in meta.credits_charged.

Tchibo Category Products API Documentation 1 credit / request

Endpoint

Request preview
GET
https://scrappa.co/api/tchibo/category?path=%2Fkaffee%2Fkaffees&page=1&site=DE
Auth header
x-api-key
Cost
1 credit / request
path = /kaffee/kaffees
Response preview
200 OK
{
    "success": true,
    "page": 1,
    "page_size": 24,
    "products": [
        {
            "id": "206154754124",
            "article_id": "155323594832",
            "price": 12.5,
            "original_price": 19.99,
            "discount_percent": 37,
            "currency": "EUR"
        }
    ],
...

Parameters

Start with the required fields, then add optional filters only when your use case needs them.

Runnable path

1 required parameter needed before sending a request.

3 optional filters available.

path string Required

Public category path, for example /kaffee/kaffees. Use / for the public category tree.

Example value /kaffee/kaffees
page integer Optional

1-based result page of 24 products.

Example value 1
filters array Optional

Facet slug such as coffee_form-gemahlen. Repeatable.

Example value ["example"]
site string Optional

Storefront: DE, AT or CH. Default DE.

Example value DE

Request Examples

PHP
<?php

$curl = curl_init();

curl_setopt_array($curl, [
    CURLOPT_URL => "https://scrappa.co/api/tchibo/category?path=%2Fkaffee%2Fkaffees&page=1&site=DE",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_ENCODING => "",
    CURLOPT_MAXREDIRS => 10,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
    CURLOPT_CUSTOMREQUEST => "GET",
    CURLOPT_HTTPHEADER => [
        "x-api-key: YOUR_API_KEY_HERE"
    ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
    echo "cURL Error #:" . $err;
} else {
    echo $response;
}
PHP
<?php

use Illuminate\Support\Facades\Http;

$response = Http::timeout(30)
    ->withHeaders(['x-api-key' => 'YOUR_API_KEY_HERE'])
    ->get('https://scrappa.co/api/tchibo/category?path=%2Fkaffee%2Fkaffees&page=1&site=DE');

if ($response->successful()) {
    echo $response->body();
} else {
    echo "Error: " . $response->status();
}
JavaScript
const options = {
    method: 'GET',
    headers: {
        'x-api-key': 'YOUR_API_KEY_HERE'
    }
};

fetch('https://scrappa.co/api/tchibo/category?path=%2Fkaffee%2Fkaffees&page=1&site=DE', options)
    .then(response => {
        if (!response.ok) {
            throw new Error(`HTTP error! status: ${response.status}`);
        }
        return response.text();
    })
    .then(data => console.log(data))
    .catch(error => console.error('Error:', error));
JavaScript
const axios = require('axios');

const options = {
    method: 'GET',
    url: 'https://scrappa.co/api/tchibo/category?path=%2Fkaffee%2Fkaffees&page=1&site=DE',
    headers: {
        x-api-key: 'YOUR_API_KEY_HERE',
    }
};

try {
    const response = await axios(options);
    console.log(response.data);
} catch (error) {
    console.error('Error:', error.message);
}
Ruby
require 'net/http'
require 'uri'

uri = URI.parse("https://scrappa.co/api/tchibo/category?path=%2Fkaffee%2Fkaffees&page=1&site=DE")
http = Net::HTTP.new(uri.host, uri.port)
http.use_ssl = uri.scheme == 'https'

request = Net::HTTP::Get.new(uri.request_uri)
request['x-api-key'] = 'YOUR_API_KEY_HERE'

begin
    response = http.request(request)
    puts response.body
rescue => e
    puts "Error: #{e.message}"
end
Python
import http.client
import json

conn = http.client.HTTPSConnection("scrappa.co")

headers = {
    'x-api-key': 'YOUR_API_KEY_HERE',
}

try:
    conn.request("GET", "/api/tchibo/category?path=%2Fkaffee%2Fkaffees&page=1&site=DE", headers=headers)
    res = conn.getresponse()
    data = res.read()
    print(data.decode("utf-8"))
except Exception as e:
    print(f"Error: {e}")
finally:
    conn.close()
Python
import requests

headers = {
    'x-api-key': 'YOUR_API_KEY_HERE',
}

try:
    response = requests.get('https://scrappa.co/api/tchibo/category?path=%2Fkaffee%2Fkaffees&page=1&site=DE', headers=headers)
    response.raise_for_status()
    print(response.text)
except requests.exceptions.RequestException as e:
    print(f"Error: {e}")
Java
import okhttp3.OkHttpClient;
import okhttp3.Request;
import okhttp3.Response;
import java.io.IOException;

public class ApiExample {
    public static void main(String[] args) {
        OkHttpClient client = new OkHttpClient();

        Request request = new Request.Builder()
            .url("https://scrappa.co/api/tchibo/category?path=%2Fkaffee%2Fkaffees&page=1&site=DE")
        .addHeader("x-api-key", "YOUR_API_KEY_HERE")
            .build();

        try (Response response = client.newCall(request).execute()) {
            if (response.isSuccessful()) {
                System.out.println(response.body().string());
            } else {
                System.out.println("Error: " + response.code());
            }
        } catch (IOException e) {
            System.out.println("Error: " + e.getMessage());
        }
    }
}
Go
package main

import (
    "fmt"
    "net/http"
    "io/ioutil"
)

func main() {
    client := &http.Client{}
    req, err := http.NewRequest("GET", "https://scrappa.co/api/tchibo/category?path=%2Fkaffee%2Fkaffees&page=1&site=DE", nil)
    if err != nil {
        fmt.Println("Error creating request:", err)
        return
    }
    req.Header.Set("x-api-key", "YOUR_API_KEY_HERE")

    resp, err := client.Do(req)
    if err != nil {
        fmt.Println("Error making request:", err)
        return
    }
    defer resp.Body.Close()

    body, err := ioutil.ReadAll(resp.Body)
    if err != nil {
        fmt.Println("Error reading response:", err)
        return
    }

    fmt.Println(string(body))
}
Terminal
#!/bin/bash

curl -X GET \
    -H "x-api-key: YOUR_API_KEY_HERE" \
    "https://scrappa.co/api/tchibo/category?path=%2Fkaffee%2Fkaffees&page=1&site=DE"
C#
using System;
using System.Net.Http;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        using var client = new HttpClient();
        client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY_HERE");

        try
        {
            var response = await client.SendAsync(new HttpRequestMessage(HttpMethod.Get, "https://scrappa.co/api/tchibo/category?path=%2Fkaffee%2Fkaffees&page=1&site=DE"));
            var content = await response.Content.ReadAsStringAsync();
            Console.WriteLine(content);
        }
        catch (Exception ex)
        {
            Console.WriteLine($"Error: {ex.Message}");
        }
    }
}
TypeScript
import axios from 'axios';

async function run(): Promise<void> {
    try {
        const response = await axios({
            method: 'GET',
            url: 'https://scrappa.co/api/tchibo/category?path=%2Fkaffee%2Fkaffees&page=1&site=DE',
            headers: {
        'x-api-key': 'YOUR_API_KEY_HERE',
            },
        });

        console.log(response.data);
    } catch (error) {
        console.error('Error:', error);
    }
}

void run();
RUST
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error>> {
    let client = Client::new();

    let response = client
        .get("https://scrappa.co/api/tchibo/category?path=%2Fkaffee%2Fkaffees&page=1&site=DE")
        .header("x-api-key", "YOUR_API_KEY_HERE")
        .send()
        .await?;

    println!("{}", response.text().await?);

    Ok(())
}

Response Schema

Example response fields are illustrative; inspect the JSON before integrating.

Example response fields

Scan these fields before integrating.

success page page_size products metadata has_more meta

Common products fields

id article_id price original_price
JSON Response
200 OK
{
    "success": true,
    "page": 1,
    "page_size": 24,
    "products": [
        {
            "id": "206154754124",
            "article_id": "155323594832",
            "price": 12.5,
            "original_price": 19.99,
            "discount_percent": 37,
            "currency": "EUR"
        }
    ],
    "metadata": {
        "num_found_available": 24,
        "filters": []
    },
    "has_more": false,
    "meta": {
        "endpoint_family": "tchibo-category",
        "billable": true,
        "attempts": 1,
        "credits_charged": 1
    }
}

Errors

Handle these documented responses before retrying or showing customer-facing failures.

422

Validation Error

A query parameter is missing, unknown or unusable. Unknown parameters are rejected, never ignored. Non-billable.

{
    "errors": {
        "path": [
            "The path field is required."
        ]
    },
    "message": "The request validation failed."
}
503

Upstream Unavailable

Tchibo could not be reached in time or answered with a block or unexpected data (`upstream_unavailable`, `upstream_blocked`, `parser_drift`). Retryable and never billed. Clients are never rate limited.

{
    "meta": {
        "attempts": 1,
        "billable": false,
        "endpoint_family": "tchibo-category"
    },
    "error": {
        "code": "upstream_unavailable",
        "message": "Tchibo is temporarily unavailable. Please retry."
    },
    "success": false
}

Generate Code with AI

Copy a ready-made prompt with all the endpoint details, parameters, and example responses. Paste it into ChatGPT, Claude, or any AI assistant to instantly generate working code.

Try It Live

Test this endpoint in our interactive playground with real data.