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.
Run this endpoint
Endpoint
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.
string
Required
Public category path, for example /kaffee/kaffees. Use / for the public category tree.
/kaffee/kaffees
integer
Optional
1-based result page of 24 products.
1
array
Optional
Facet slug such as coffee_form-gemahlen. Repeatable.
["example"]
string
Optional
Storefront: DE, AT or CH. Default DE.
DE
Request Examples
<?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
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();
}
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));
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);
}
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
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()
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}")
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());
}
}
}
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))
}
#!/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"
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}");
}
}
}
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();
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
{
"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.
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."
}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.