# Social Fetch API - Klarna endpoints # Base URL: https://api.socialfetch.dev # Auth: x-api-key header (sfk_...) # Full catalog: https://www.socialfetch.dev/llms-endpoints.txt | JSON: https://www.socialfetch.dev/llms.json # Docs hub: https://www.socialfetch.dev/docs/api | OpenAPI: https://www.socialfetch.dev/openapi.json 17 documented Klarna operations. Do not invent paths - only the routes below (and their linked markdown pages) are supported. ## GET /v1/klarna/product Get Klarna product Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/klarna/product/get.mdx SDK: client.klarna.getProduct({ productId: "3211644574" }) Parameters: - productId (required, string) - Klarna product id (`3211644574`) or product page URL (`https://www.klarna.com/us/shopping/pl/cl52/3211644574/Game-Consoles/Sony-PlayStation-5-Slim-Digital-Edition-1TB/`). Ids are the same in every country. A URL's country is used when `country` is not given. - country (optional, string) - 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. - language (optional, string) - Two-letter language code for the product text, e.g. `en` or `de`. Default: the site's own language. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/klarna/product?productId=3211644574" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/klarna/product/offers List Klarna product offers Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/klarna/product/offers/get.mdx SDK: client.klarna.getProductOffers({ productId: "3211644574" }) Parameters: - productId (required, string) - Klarna product id (`3211644574`) or product page URL (`https://www.klarna.com/us/shopping/pl/cl52/3211644574/Game-Consoles/Sony-PlayStation-5-Slim-Digital-Edition-1TB/`). Ids are the same in every country. A URL's country is used when `country` is not given. - country (optional, string) - 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. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/klarna/product/offers?productId=3211644574" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/klarna/product/price-history Get Klarna product price history Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/klarna/product/price-history/get.mdx SDK: client.klarna.getProductPriceHistory({ productId: "3211644574" }) Parameters: - productId (required, string) - Klarna product id (`3211644574`) or product page URL (`https://www.klarna.com/us/shopping/pl/cl52/3211644574/Game-Consoles/Sony-PlayStation-5-Slim-Digital-Edition-1TB/`). Ids are the same in every country. A URL's country is used when `country` is not given. - country (optional, string) - 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. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/klarna/product/price-history?productId=3211644574" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/klarna/product/similar List Klarna similar products Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/klarna/product/similar/get.mdx SDK: client.klarna.getSimilarProducts({ productId: "3211644574", limit: 10 }) Parameters: - productId (required, string) - Klarna product id (`3211644574`) or product page URL (`https://www.klarna.com/us/shopping/pl/cl52/3211644574/Game-Consoles/Sony-PlayStation-5-Slim-Digital-Edition-1TB/`). Ids are the same in every country. A URL's country is used when `country` is not given. - country (optional, string) - 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. - limit (optional, integer) - Products to return, 1 to 30. Default: 10. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/klarna/product/similar?productId=3211644574" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/klarna/product/reviews List Klarna product reviews Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/klarna/product/reviews/get.mdx SDK: client.klarna.getProductReviews({ productId: "3607137046", type: "user" }) Parameters: - productId (required, string) - Klarna product id (`3211644574`) or product page URL (`https://www.klarna.com/us/shopping/pl/cl52/3211644574/Game-Consoles/Sony-PlayStation-5-Slim-Digital-Edition-1TB/`). Ids are the same in every country. A URL's country is used when `country` is not given. - country (optional, string) - 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. - type (optional, string, enum: user | pro) - `user` (default): shoppers' reviews from stores. `pro`: professional reviews from magazines and review sites. - language (optional, string) - Two-letter language code, e.g. `en` or `de`: only reviews written in that language. Default: reviews in every language the country's site shows, which is the set `totalResults` and the review summary count. - limit (optional, integer) - Reviews per page, 1 to 30. Default: 20. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. It only works with the same filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/klarna/product/reviews?productId=3211644574" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/klarna/product/reviews/summary Get Klarna product review summary Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/klarna/product/reviews/summary/get.mdx SDK: client.klarna.getProductReviewSummary({ productId: "3607137046" }) Parameters: - productId (required, string) - Klarna product id (`3211644574`) or product page URL (`https://www.klarna.com/us/shopping/pl/cl52/3211644574/Game-Consoles/Sony-PlayStation-5-Slim-Digital-Edition-1TB/`). Ids are the same in every country. A URL's country is used when `country` is not given. - country (optional, string) - 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. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/klarna/product/reviews/summary?productId=3211644574" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/klarna/search Search Klarna products Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/klarna/search/get.mdx SDK: client.klarna.searchProducts({ query: "toaster", country: "US" }) Parameters: - query (required, string) - What to search for, e.g. `toaster` or `sony wh-1000xm5`. - country (optional, string) - 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. - exact (optional, string, enum: true | false) - `true` searches the words as typed. Default `false`, as on the site: Klarna may read a category, brand or feature in the words as a filter (`toaster` lists the Toasters category); `interpretedAs` says what it read. - limit (optional, integer) - Products per page, 1 to 48. Default: 24. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. It only works with the same filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/klarna/search?query=toaster" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/klarna/search/suggestions List Klarna search suggestions Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/klarna/search/suggestions/get.mdx SDK: client.klarna.getSearchSuggestions({ query: "iphone" }) Parameters: - query (required, string) - What a shopper has typed so far, e.g. `iphone` or `air fryer`. - country (optional, string) - 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. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/klarna/search/suggestions?query=iphone" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/klarna/deals List Klarna deals Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/klarna/deals/get.mdx SDK: client.klarna.listDeals({ category: "cl52", limit: 30 }) Parameters: - country (optional, string) - 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. - minDiscount (optional, string, enum: 5 | 10 | 25 | 50) - Only prices that dropped at least this much, in percent: `5`, `10` (default), `25` or `50`. - category (optional, string) - Klarna category id, e.g. `cl52` (Game Consoles). Products and deals carry it as `category.id`. - brandId (optional, string) - Klarna brand id, e.g. `310` (ASUS). `/v1/klarna/deals/filters` lists them. - storeId (optional, string) - Klarna store id, e.g. `252237` (Best Buy in the US). `/v1/klarna/stores` lists them. - sort (optional, string, enum: popular | price_low_to_high | price_high_to_low | biggest_drop | name) - Order: `popular` (default), `price_low_to_high`, `price_high_to_low`, `biggest_drop` or `name`. - limit (optional, integer) - Deals per page, 1 to 60. Default: 30. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. It only works with the same filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/klarna/deals?category=cl52&limit=30" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/klarna/deals/filters Get Klarna deal filters Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/klarna/deals/filters/get.mdx SDK: client.klarna.getDealFilters({ storeId: "252237" }) Parameters: - country (optional, string) - 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. - minDiscount (optional, string, enum: 5 | 10 | 25 | 50) - Only prices that dropped at least this much, in percent: `5`, `10` (default), `25` or `50`. - category (optional, string) - Klarna category id, e.g. `cl52` (Game Consoles). Products and deals carry it as `category.id`. - brandId (optional, string) - Klarna brand id, e.g. `310` (ASUS). `/v1/klarna/deals/filters` lists them. - storeId (optional, string) - Klarna store id, e.g. `252237` (Best Buy in the US). `/v1/klarna/stores` lists them. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/klarna/deals/filters?storeId=252237" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/klarna/stores List Klarna stores Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/klarna/stores/get.mdx SDK: client.klarna.listStores({ query: "best" }) Parameters: - country (optional, string) - 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. - query (optional, string) - Only stores whose name contains this text, e.g. `best`. - limit (optional, integer) - Stores per page, 1 to 500. Default: 100. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. It only works with the same filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/klarna/stores?query=best" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/klarna/store/products List Klarna store products Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/klarna/store/products/get.mdx SDK: client.klarna.getStoreProducts({ storeId: "252237", limit: 30 }) Parameters: - storeId (required, string) - Klarna store id, e.g. `252237` (Best Buy in the US). `/v1/klarna/stores` lists them. - country (optional, string) - 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. - minDiscount (optional, string, enum: 5 | 10 | 25 | 50) - Only prices that dropped at least this much, in percent: `5`, `10` (default), `25` or `50`. - category (optional, string) - Klarna category id, e.g. `cl52` (Game Consoles). Products and deals carry it as `category.id`. - brandId (optional, string) - Klarna brand id, e.g. `310` (ASUS). `/v1/klarna/deals/filters` lists them. - sort (optional, string, enum: popular | price_low_to_high | price_high_to_low | biggest_drop | name) - Order: `popular` (default), `price_low_to_high`, `price_high_to_low`, `biggest_drop` or `name`. - limit (optional, integer) - Deals per page, 1 to 60. Default: 30. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. It only works with the same filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/klarna/store/products?storeId=252237" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/klarna/category List Klarna category products Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/klarna/category/get.mdx SDK: client.klarna.listCategoryProducts({ category: "cl52" }) Parameters: - category (required, string) - Klarna product-list category: `cl52` (Game Consoles) or its page URL (`https://www.klarna.com/us/shopping/cl/cl52/Game-Consoles/`). A URL's country is used when `country` is not given. - country (optional, string) - 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. - subcategory (optional, string) - Sub-category id from `/v1/klarna/categories/children`, e.g. `100003492-100014243` (Gamepads in `cl165`, Game Controllers). - brandId (optional, string) - Klarna brand id, e.g. `310` (ASUS). `/v1/klarna/deals/filters` lists them. - filters (optional, string) - Filters from `/v1/klarna/category/filters`, comma-separated `filterId:value` pairs, the `value` an option gives: an option id, `min_max` for a range or an interval such as `-90_-10`, e.g. `59491809:60530148,PRICE:100_500` (PlayStation 5 consoles from 100 to 500). - sort (optional, string, enum: popular | price_low_to_high | price_high_to_low | biggest_drop | rating | trending | name) - Order: `popular` (default), `price_low_to_high`, `price_high_to_low`, `biggest_drop`, `rating`, `trending` or `name`. - limit (optional, integer) - Products per page, 1 to 48. Default: 24. - cursor (optional, string) - Pass `page.nextCursor` from the previous response to get the next page. It only works with the same filters. Pagination: send query `cursor` from prior `data.page.nextCursor`; stop when `data.page.hasMore` is false. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/klarna/category?category=cl52" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/klarna/category/filters Get Klarna category filters Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/klarna/category/filters/get.mdx SDK: client.klarna.getCategoryFilters({ category: "cl52" }) Parameters: - category (required, string) - Klarna product-list category: `cl52` (Game Consoles) or its page URL (`https://www.klarna.com/us/shopping/cl/cl52/Game-Consoles/`). A URL's country is used when `country` is not given. - country (optional, string) - 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. - filterId (optional, string) - A filter id from this endpoint's `filters`, e.g. `BRAND` or `59491809` (Platform in Game Consoles): lists that filter's options with counts. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/klarna/category/filters?category=cl52" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/klarna/category/guide Get Klarna category guide Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/klarna/category/guide/get.mdx SDK: client.klarna.getCategoryGuide({ category: "cl52" }) Parameters: - category (required, string) - Klarna product-list category: `cl52` (Game Consoles) or its page URL (`https://www.klarna.com/us/shopping/cl/cl52/Game-Consoles/`). A URL's country is used when `country` is not given. - country (optional, string) - 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. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/klarna/category/guide?category=cl52" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/klarna/categories/children List Klarna sub-categories Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/klarna/categories/children/get.mdx SDK: client.klarna.listCategoryChildren({ category: "t19" }) Parameters: - category (optional, string) - Klarna category whose sub-categories to list: a tree such as `t19` (Gaming & Entertainment), a product list such as `cl165` (Game Controllers), or either's page URL. Leave it out for the top-level categories. - country (optional, string) - 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. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/klarna/categories/children?category=t19" \ -H "x-api-key: YOUR_API_KEY" ## GET /v1/klarna/category/keywords List Klarna category keywords Credit cost: 1 credit. Failed requests are free. Found, empty and not-found answers are all charged. Auth: API key or x402 payment (no key needed for payment) Docs: https://www.socialfetch.dev/docs/api/v1/klarna/category/keywords/get.mdx SDK: client.klarna.listCategoryKeywords({ category: "cl52" }) Parameters: - category (required, string) - Klarna category: a product list such as `cl52` (Game Consoles) or its page URL (`https://www.klarna.com/us/shopping/cl/cl52/Game-Consoles/`). A URL's country is used when `country` is not given. Or a tree category such as `t19` (Gaming & Entertainment). - country (optional, string) - 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. Outcome field: `data.lookupStatus` in `found`, `not_found` curl "https://api.socialfetch.dev/v1/klarna/category/keywords?category=cl52" \ -H "x-api-key: YOUR_API_KEY"