samsung.com.br
Samsung API
Query public Samsung data with GeckoAPI and receive structured JSON. Choose an operation to review its inputs, credit cost and response fields.
Search for Samsung products by keyword or URL, with prices, availability and pagination. Each PLP query costs 1 credit.
GeckoAPI is independent of Samsung. This integration reads public data; it does not grant access to private accounts or account management operations.
Available operations
Search products
samsung.com.br:plp
Search for Samsung products by keyword or URL, with prices, availability and pagination. Each PLP query costs 1 credit.
1 credit per request
Get product details
samsung.com.br:pdp
Extracts Samsung products with current price, reference price, cash payment, installments, images, technical data sheet, EAN and variations. Each PDP query costs 1 credit.
1 credit per request
These are standard credit costs. Account-specific pricing is shown in the dashboard. Each operation has its own supported inputs and regional coverage.
Coverage and limitations
Price and availability reflect the catalog without a CEP. Reviews and shipping are not provided. Fields not published by the source are null; lists may be empty. The example abbreviates the gallery and response attributes. Monetary values use BRL: price is the current price; regularPrice is the reference price; cashPrice is the lowest published one-installment offer, including Pix when specified. installmentPrice and installmentCount describe the largest interest-free credit card installment plan. Prices of unavailable offers are null. Coupons, device trade-ins and club discounts are not calculated.
Search queries the catalog and may include parts and accessories related to the term. The example shows two items from a page of up to 12. Sorting and stock may change between requests. The catalog limits the result window to at most 208 accessible pages. Monetary values use BRL: price is the current price; regularPrice is the reference price; cashPrice is the lowest published one-installment offer, including Pix when specified. installmentPrice and installmentCount describe the largest interest-free credit card installment plan. Prices of unavailable offers are null. Coupons, device trade-ins and club discounts are not calculated.
Make your first request
The example uses search products. Replace YOUR_API_KEY with your server-side API key. Copy supported inputs from the reference for the operation you choose.
curl -X POST https://api.geckoapi.com.br/v1/extract \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"target": "samsung.com.br",
"type": "plp",
"keyword": "geladeira",
"page": 1
}'Example JSON response
Abbreviated example from the same operation. Arrays and nested objects are shortened here; the endpoint reference includes the full documented schema. Source content retains its original language.
{
"requestId": "d68564d2-34bc-47e6-a1a6-796794f8463b",
"executionId": "f7b0f7f6-3363-4958-9f7e-6c0e0d189874",
"data": {
"source": "samsung.com.br",
"type": "plp",
"url": "https://shop.samsung.com/br/geladeira?_q=geladeira&map=ft&page=1",
"requestUrl": "https://shop.samsung.com/br/geladeira?_q=geladeira&map=ft&page=1",
"extractedAt": "2026-10-01T12:17:13.588Z",
"query": "geladeira",
"sort": "relevance",
"totalResults": 100,
"totalPages": 9,
"page": 1,
"resultsPerPage": 12,
"offset": 0,
"nextPage": 2,
"nextPageUrl": "https://shop.samsung.com/br/geladeira?_q=geladeira&map=ft&page=2",
"items": [
{
"url": "https://shop.samsung.com/br/geladeira-samsung-duplex-rt42-inox-bivolt-415l/p?skuId=16004",
"productId": "13208",
"sku": "16004",
"name": "Geladeira Samsung Duplex RT42 Inox Bivolt 415L",
"available": true,
"price": 4525.27,
"regularPrice": 4525.27,
"cashPrice": 4299.01,
"installmentPrice": 251.4,
"installmentCount": 18,
"sellerId": "1",
"sellerName": "SAMSUNG ELETRÔNICA DA AMAZÔNIA LTDA.",
"currency": "BRL",
"currencyRaw": "R$",
"brand": "Samsung",
"thumbnail": "https://samsungbrshop.vteximg.com.br/arquivos/ids/296134/SA365_SMG_RT42C_Galeria_1000x1000_01_20260721.jpg?v=639220673517100000",
"aggregateRating": null,
"sponsored": false
},
{
"url": "https://shop.samsung.com/br/geladeira-samsung-duplex-rt47-inox-bivolt-465l/p?skuId=16005",
"productId": "13209",
"sku": "16005",
"name": "Geladeira Samsung Duplex RT47 Inox Bivolt 465L",
"available": true,
"price": 4899,
"regularPrice": 4899,
"cashPrice": 4899,
"installmentPrice": 272.16,
"installmentCount": 18,
"sellerId": "1",
"sellerName": "SAMSUNG ELETRÔNICA DA AMAZÔNIA LTDA.",
"currency": "BRL",
"currencyRaw": "R$",
"brand": "Samsung",
"thumbnail": "https://samsungbrshop.vteximg.com.br/arquivos/ids/296144/SA365_SMG_RT47C_Galeria_1000x1000_01_20260721.jpg?v=639220673657000000",
"aggregateRating": null,
"sponsored": false
}
]
}
}Integrate with REST or MCP
Call POST /v1/extract from your backend, or use the operation-specific tool on POST /v1/mcp. The API reference includes both request formats. Keep credentials in your backend and handle missing fields, pagination and errors according to that operation's rules.
Ready to test the Samsung API?
Open the documented example in the sandbox and inspect the response before integrating it into your application.