Klarna

List Klarna stores

List the stores with products on sale on Klarna in a country, with their ids and deal counts.

GET/v1/klarna/stores
x-api-keystringheader

API key (`sfk_...`)

Parameters
4
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.

querystringquery

Only stores whose name contains this text, e.g. `best`.

min 1 chars · max 100 chars

limitintegerquery

Stores per page, 1 to 500. Default: 100.

≥ 1 · ≤ 500

cursorstringquery

Pass `page.nextCursor` from the previous response to get the next page. It only works with the same filters.

min 1 chars · max 1024 chars

Response fields
20

Endpoint-specific response payload.

datalookupStatus
string

Always `found`; a query no store matches gives an empty list.

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/`.

datatotalResults
integer

Stores matching, across every page.

Stores, by name.

datastores[]id
string

Store id; pass it as `storeId`.

datastores[]name
string

Store name.

datastores[]dealCount
integer

Products on sale at the store right now.

Pagination state for the current page.

datapagehasMore
boolean

Whether another page is available.

datapagenextCursor
stringnullable

Cursor for the next page; null on the last page.

datapagetruncated
boolean

True when more rows exist than this list can reach: the list stops here before its end.

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/stores?query=best" \
  -H "x-api-key: YOUR_API_KEY"

Responses

Stores with products on sale on Klarna.