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

Check24 Gas Tariffs API Documentation

GET https://scrappa.co/api/check24/energy

Returns the public logged-out gas comparison for a German postal code and a yearly consumption in kWh. Each tariff carries the provider, logo, tariff name, shown monthly price and its basis, the later monthly price, the working and base price, the bonus, green and dynamic flags, the minimum term, the price guarantee, rating, score and badges. Annual and first year costs are derived without bonuses so tariffs stay comparable. Send green_only or exclude_dynamic to filter rows, sortField and sortOrder to sort, and limit to cap the list. Prices are numbers in EUR; ids and links pass through unchanged. total counts tariffs after filters and before limit; returned is the number in this answer. Price sorting uses the shown monthly price.

Check24 Gas Tariffs API Documentation 1 credit / request

Endpoint

Request preview
GET
https://scrappa.co/api/check24/energy
Auth header
x-api-key
Cost
1 credit / request
productId = 2 zipCode = 10178 totalConsumption = 20000
Response preview
200 OK
{
    "city": "Berlin",
    "meta": {
        "duration_ms": 1200,
        "upstream_calls": 2
    },
    "total": 148,
    "product": "gas",
    "success": true,
    "summary": "148 Tarife ab 110,00 \u20ac pro Monat",
    "tariffs": [
        {
            "green": true,
            "score": 8.1,
...

Parameters

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

Runnable path

3 required parameters needed before sending a request.

5 optional filters available.

productId integer Required

1 for electricity, 2 for gas.

Example value 2
zipCode string Required

Five digit German postal code.

Example value 10178
totalConsumption integer Required

Yearly consumption in kWh, 100 to 100000. 3500 for electricity and 20000 for gas are typical.

Example value 20000
sortField string Optional

price or popularity. Defaults to price.

Example value example
sortOrder string Optional

asc or desc. Defaults to asc.

Example value example
green_only boolean Optional

Set true to keep only tariffs flagged as green.

Example value true
exclude_dynamic boolean Optional

Set true to drop dynamic tariffs.

Example value true
limit integer Optional

Maximum number of tariffs, 1 to 25. All tariffs are returned by default.

Example value 10

Response Schema

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

Example response fields

Scan these fields before integrating.

city meta total product success summary tariffs currency +7 more

Common tariffs fields

green score badges rating
JSON Response
200 OK
{
    "city": "Berlin",
    "meta": {
        "duration_ms": 1200,
        "upstream_calls": 2
    },
    "total": 148,
    "product": "gas",
    "success": true,
    "summary": "148 Tarife ab 110,00 \u20ac pro Monat",
    "tariffs": [
        {
            "green": true,
            "score": 8.1,
            "badges": [
                "Sofortbonus: 366 \u20ac"
            ],
            "rating": 4.6,
            "tariff": "Example Strom L",
            "dynamic": false,
            "min_term": "18 Monate",
            "position": 1,
            "provider": "Example Provider",
            "bonus_eur": 366,
            "later_from": "ab 13. Monat",
            "shown_basis": "\u00d8 pro Monat",
            "rating_count": 3329,
            "provider_logo": "https://cdn.example.de/logo/provider.png",
            "annual_cost_eur": 1510.9,
            "price_guarantee": "12 Monate",
            "renewable_share": "100 % erneuerbar",
            "later_monthly_eur": 125.89,
            "shown_monthly_eur": 95.39,
            "first_year_cost_eur": 1144.9,
            "base_price_eur_month": 10.35,
            "working_price_ct_kwh": 39.62
        }
    ],
    "currency": "EUR",
    "returned": 1,
    "zip_code": "10178",
    "product_id": 2,
    "results_url": "",
    "calculation_id": "d30647a6fce65abaaa0238ae17ba9de0",
    "consumption_kwh": 20000,
    "local_default_tariff": []
}

Errors

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

Validation Error

Returned when a required parameter is missing, a postal code is unknown or a value is out of range. No credits are charged.

Not Found

Returned when Check24 does not know the requested comparison. No credits are charged.

Unexpected Response

Returned when Check24 answers with a page this API cannot read. Failed requests are not charged.

Service Unavailable

Returned when Check24 could not be read. Failed requests are not charged. Try again.

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.