Klarna

Get Klarna deal filters

Get the categories, brands, stores and discount bands Klarna offers on its deals, with deal counts.

GET/v1/klarna/deals/filters
x-api-keystringheader

API key (`sfk_...`)

Parameters
5
countrystringquery

Two-letter country code of the Klarna shopping site, e.g. `US`, `GB`, `DE` or `SE`. Default: `US`. Prices are in that country's currency.

minDiscountstringquery

Only prices that dropped at least this much, in percent: `5`, `10` (default), `25` or `50`.

one of: 5, 10, 25, 50

categorystringquery

Klarna category id, e.g. `cl52` (Game Consoles). Products and deals carry it as `category.id`.

brandIdstringquery

Klarna brand id, e.g. `310` (ASUS). `/v1/klarna/deals/filters` lists them.

pattern: ^\d{1,12}$

storeIdstringquery

Klarna store id, e.g. `252237` (Best Buy in the US). `/v1/klarna/stores` lists them.

pattern: ^\d{1,12}$

Response fields
26

Endpoint-specific response payload.

datalookupStatus
string

Always `found`; filters nothing matches give empty lists.

one of: found, not_found

The Klarna shopping site the answer is from.

datamarketcountry
string

Two-letter country code, e.g. `US`.

datamarketsiteUrl
string

The country's Klarna shopping site, e.g. `https://www.klarna.com/us/shopping/`.

Categories with deals; pass `id` as `category`.

datacategories[]id
string

Option id: pass it as the matching parameter.

datacategories[]name
string

Option name.

datacategories[]count
integer

Deals with this option.

Brands with deals; pass `id` as `brandId`.

databrands[]id
string

Option id: pass it as the matching parameter.

databrands[]name
string

Option name.

databrands[]count
integer

Deals with this option.

Stores with deals; pass `id` as `storeId`.

datastores[]id
string

Option id: pass it as the matching parameter.

datastores[]name
string

Option name.

datastores[]count
integer

Deals with this option.

Deal counts by size of the price drop.

datadiscounts[]minDiscount
string

Pass it as `minDiscount`, e.g. `25`.

datadiscounts[]count
integer

Deals that dropped at least this much.

Metadata describing the request and billing outcome.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.

one of: true

metafetchedAt
stringoptional

When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.

Code example

curl "https://api.socialfetch.dev/v1/klarna/deals/filters?storeId=252237" \
  -H "x-api-key: YOUR_API_KEY"

Responses

The filters Klarna offers on its deals.