Skip to content

// docs

Samsung: Get product details

Extracts Samsung products with current price, reference price, cash payment, installments, images, technical data sheet, EAN and variations. Each PDP query costs 1 credit.

samsung.com.br:pdp · 1 credit per request

Standard credit cost. Your account pricing is shown in the sandbox.

Try this operation in the sandbox

Source-specific 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.

HTTP request

cURL
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": "pdp",
  "url": "https://shop.samsung.com/br/galaxy-s25-ultra-512gb/p"
}'

Keep your API key on your server. See the quickstart for authentication and response handling.

MCP request

The hosted MCP tool fixes target and type for this operation. Its remaining arguments use the same input rules as Extract.

POST /v1/mcp · Bearer or X-API-Key authentication

samsung_com_br_pdp · tools/call
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "samsung_com_br_pdp",
    "arguments": {
      "url": "https://shop.samsung.com/br/galaxy-s25-ultra-512gb/p",
      "executionId": "exec_example_123"
    }
  }
}

Supported inputs

Conditional fields depend on the alternatives and constraints in the rule column. Fields marked unsupported are omitted.

FieldTypeRequirementRuleDefaultExample
url
URL extraction target. For some PLPs it can be omitted when API assembles URL from other fields.
string (URL) Required URL from the Samsung Brazil store at shop.samsung.com/br/slug/p (or shop.samsung.com.br/slug/p), optionally with ?skuId=ID. SKU must belong to the product. Google and utm_* tracking parameters are removed. - https://shop.samsung.com/br/galaxy-s25-ultra-512gb/p
target
Target source for extraction.
enum Required Use samsung.com.br. samsung.com.br samsung.com.br
type
Extraction type: pdp, idp, plp, ilp, quote, review or places.
enum Required Use pdp. pdp pdp

Request examples

Product by URL

Each PDP query costs 1 credit. Without skuId, selects the first available variation, or the first if all are unavailable.

Product by URL
{
  "target": "samsung.com.br",
  "type": "pdp",
  "url": "https://shop.samsung.com/br/galaxy-s25-ultra-512gb/p"
}

Select a variation by SKU

Use a URL of variants[].url to check the offer for that variation.

Select a variation by SKU
{
  "target": "samsung.com.br",
  "type": "pdp",
  "url": "https://shop.samsung.com/br/galaxy-s25-ultra-512gb/p?skuId=8454"
}

Response schema

Leaf paths and expected types. Field names and enum values are part of the API contract.

responseSchema
{
  "requestId": "string",
  "executionId": "string",
  "data.extractedAt": "string",
  "data.canonicalUrl": "string",
  "data.url": "string",
  "data.productId": "string",
  "data.sku": "string",
  "data.name": "string",
  "data.price": "number | null",
  "data.regularPrice": "number | null",
  "data.cashPrice": "number | null",
  "data.installmentPrice": "number | null",
  "data.installmentCount": "number | null",
  "data.sellerName": "string | null",
  "data.sellerId": "string | null",
  "data.sellerUrl": "null",
  "data.availability": "string | null",
  "data.currency": "string",
  "data.currencyRaw": "string",
  "data.description": "string | null",
  "data.descriptionHtml": "string | null",
  "data.images[].url": "string",
  "data.mainImage.url": "string",
  "data.brand.name": "string",
  "data.aggregateRating": "null",
  "data.breadcrumbs[].name": "string",
  "data.additionalProperties[].name": "string",
  "data.additionalProperties[].value": "string",
  "data.additionalProperties[].section": "string | null",
  "data.variants[].sku": "string",
  "data.variants[].name": "string",
  "data.variants[].url": "string",
  "data.variants[].image": "string | null",
  "data.variants[].voltage": "string | null",
  "data.variants[].ean": "string | null",
  "data.variants[].available": "boolean | null",
  "data.variants[].price": "number | null",
  "data.variants[].regularPrice": "number | null",
  "data.variants[].cashPrice": "number | null",
  "data.variants[].installmentPrice": "number | null",
  "data.variants[].installmentCount": "number | null",
  "data.variants[].sellerId": "string | null",
  "data.variants[].sellerName": "string | null",
  "data.color": "string | null",
  "data.size": "string | null",
  "data.voltage": "string | null",
  "data.otherSellers": "array",
  "data.mpn": "string | null",
  "data.features[]": "string",
  "data.ean": "string | null",
  "data.shippingDetails": "null",
  "data.variants[].color": "string | null",
  "data.variants[].size": "string | null"
}

Example response

Illustrative response. Product names, reviews and other source content retain their original language. Missing and null values do not imply zero stock, free shipping or zero reviews.

responseExample
{
  "requestId": "d68564d2-34bc-47e6-a1a6-796794f8463b",
  "executionId": "f7b0f7f6-3363-4958-9f7e-6c0e0d189874",
  "data": {
    "extractedAt": "2026-10-01T12:17:16.267Z",
    "canonicalUrl": "https://shop.samsung.com/br/galaxy-s25-ultra-512gb/p",
    "url": "https://shop.samsung.com/br/galaxy-s25-ultra-512gb/p?skuId=8453",
    "productId": "6368",
    "sku": "8453",
    "name": "Celular Samsung Galaxy S25 Ultra 5G, 512GB, 12GB RAM, Câmera Quádrupla de 200+50+10+50, Tela Grande de 6.9\"",
    "price": 6899,
    "regularPrice": 12099,
    "cashPrice": 6209.1,
    "installmentPrice": 383.27,
    "installmentCount": 18,
    "sellerName": "SAMSUNG ELETRÔNICA DA AMAZÔNIA LTDA.",
    "sellerId": "1",
    "sellerUrl": null,
    "availability": "InStock",
    "currency": "BRL",
    "currencyRaw": "R$",
    "description": "Celular Samsung Galaxy S25 Ultra 5G, 512GB, 12GB RAM, Galaxy AI, inteligencia artificial, comando e tradução de voz, Câmera Quádrupla de 200+50+10+50, Tela Grande de 6.9\" Bateria 5000mAh, Dual Chip, eSim; A Samsung apresenta o mais novo lançamento da linha S. Seu verdadeiro aliado AI, o Galaxy S25 é o novo celular com o poder da nova geração da inteligência artificial. Tenha em suas mãos uma nova experiência com Galaxy AI com seus novos recursos. Eleve o seu dia a dia, com assistência rápida e completa com os novos recursos de IA mais avançados, como traduções em tempo real, geração de texto e imagens, tudo isso com maior rapidez e privacidade, graças à execução de tarefas diretamente no dispositivo. Novas formas de realizar suas tarefas, se divertir, criar e cuidar da sua saúde. Um celular AI totalmente novo que auxilia sua vida diária com conversas em linguagem natural. Celular AI semelhante ao humano alimentado por agentes de IA e com diversos recursos ao seu alcance, com o Gemini Live, conclua instantaneamente várias tarefas de uma só vez com uma conversa natural tendo uma ação entre aplicativos. Conclua várias ações de uma só vez, falando naturalmente com a série Galaxy S25, que entende seus comandos de voz. Sincronize suas mensagens, calendários, texto apenas ativando um único comando. Obtenha facilmente informações, ações e soluções de que você precisa com base no contexto da sua tela. Encontre intuitivamente as informações de que você precisa com pesquisa na tela ou circule para pesquisar. A nova função Now Bar & Now Brief, ainda permite que você verifique as notificações para tarefas em andamento e receba um resumo diário de suas atividades. O Gravador de chamada é mais uma novidade no Galaxy S25, permite que você faça gravação de chamadas com transcrição e resumo no dispositivo. O Novo Galaxy S25 ainda conta com o processador mais poderoso da linha S. O Snapdragon 8 Elite for Galaxy (3nm) tem seu desempenho aprimorado de forma abrangente, oferecendo uma experiência móvel poderosa. O processamento de IA mais rápido em um Galaxy, fornecendo resultados de IA mais confiáveis do que nunca. Falando de câmera o novo Galaxy S25, permite que você tenha novas experiências de filmar e fotografar surpreendente com detalhes e cores mais vibrantes. Tenha o maior nível de detalhes em suas fotos e vídeos, independentemente da lente que você estiver usando. Vídeos Nightography destacam inúmeros detalhes. Imagens vibrantes e realistas, Reconhecimento perfeito do tom de pele com o Object-Aware Engine. O Assistente de fotografia dentro do novo Galaxy S25 ainda conta com novas funcionalidades. O eliminador de áudio ajuda a remover ruídos indesejados em seus vídeos e a uma nova função para você reproduzir a magia do cinema no Studio combinando fotos e vídeos da galeria em novos projetos de filmes. A linha Galaxy S25 ainda conta com a sua identidade de design única da série S, ultra elegante, molduras mais finas e uniformes para visualização mais ampla e usabilidade mais confortável. Sua durabilidade excepcional possui materiais meticulosamente selecionados para um design premium e durável. Seu acabamento em alumínio forte com dureza incrível para o S25 e S25+. E para a versão Ultra acabamento em Titânio. O metal mais resistente já usado na série Galaxy. Vidro resistente “Corning Gorilla Armor” para maior durabilidade (Resistência a arranhões e choques). Brilho adaptável garantindo uma visualização suave e confortável. O novo Galaxy ainda conta com um mix de Cores luminosas inspiradas na natureza, sendo elas: Azul, Verde, Prata e Azul Marinho para a versão básica e Plus. Já nas versões do modelo Ultra, as cores são Titânio Preto, Titânio Cinza, Titânio Prata, Titânio Azul. Com o aplicativo Smart Switch você transfere de forma fácil e prática o conteúdo do seu celular anterior (fotos, contatos, eventos do calendário, notas, configurações do dispositivo e muito mais) para o novo Galaxy S25. Para sua melhor segurança não deixe de conferir as ativações do Cadeado Galaxy, tenha seus dados e seu celular seguro e protegido.",
    "descriptionHtml": null,
    "images": [
      {
        "url": "https://samsungbrshop.vteximg.com.br/arquivos/ids/249973/S25_1000x1000__0003_S25-ultra_titanio_black.jpg.jpg?v=638793927257870000"
      },
      {
        "url": "https://samsungbrshop.vteximg.com.br/arquivos/ids/249974/03-Galaxy_S25_Ultra_Now_Brief.jpg?v=638793925734830000"
      }
    ],
    "mainImage": {
      "url": "https://samsungbrshop.vteximg.com.br/arquivos/ids/249973/S25_1000x1000__0003_S25-ultra_titanio_black.jpg.jpg?v=638793927257870000"
    },
    "brand": {
      "name": "Samsung"
    },
    "aggregateRating": null,
    "breadcrumbs": [
      {
        "name": "Mobile"
      },
      {
        "name": "Smartphone"
      },
      {
        "name": "Galaxy S"
      }
    ],
    "additionalProperties": [
      {
        "name": "BRAND",
        "value": "Samsung",
        "section": "Samsung.com"
      },
      {
        "name": "MODEL",
        "value": "SM-S938B/DS",
        "section": "Samsung.com"
      },
      {
        "name": "RAM",
        "value": "12GB",
        "section": "Samsung.com"
      },
      {
        "name": "Linha",
        "value": "Galaxy S",
        "section": "Samsung.com"
      },
      {
        "name": "Tamanho da tela",
        "value": "6.9\"",
        "section": "Samsung.com"
      },
      {
        "name": "Tecnologia da Tela",
        "value": "Dynamic AMOLED 2X",
        "section": "Samsung.com"
      },
      {
        "name": "Resolução da tela",
        "value": "3120 x 1440 (QHD+)",
        "section": "Samsung.com"
      },
      {
        "name": "Com leitor de impressão digital",
        "value": "Sim",
        "section": "Samsung.com"
      }
    ],
    "variants": [
      {
        "sku": "8453",
        "name": "Titânio Preto",
        "url": "https://shop.samsung.com/br/galaxy-s25-ultra-512gb/p?skuId=8453",
        "image": "https://samsungbrshop.vteximg.com.br/arquivos/ids/249973/S25_1000x1000__0003_S25-ultra_titanio_black.jpg.jpg?v=638793927257870000",
        "voltage": null,
        "ean": "7892509139724",
        "color": "Titânio Preto",
        "size": "512 GB",
        "available": true,
        "price": 6899,
        "regularPrice": 12099,
        "cashPrice": 6209.1,
        "installmentPrice": 383.27,
        "installmentCount": 18,
        "sellerId": "1",
        "sellerName": "SAMSUNG ELETRÔNICA DA AMAZÔNIA LTDA."
      },
      {
        "sku": "8454",
        "name": "Titânio Cinza",
        "url": "https://shop.samsung.com/br/galaxy-s25-ultra-512gb/p?skuId=8454",
        "image": "https://samsungbrshop.vteximg.com.br/arquivos/ids/249979/S25_1000x1000__0002_S25-ultra_titanio_cinza.jpg.jpg?v=638793927258030000",
        "voltage": null,
        "ean": "7892509139694",
        "color": "Titânio Cinza",
        "size": "512 GB",
        "available": true,
        "price": 6899,
        "regularPrice": 12099,
        "cashPrice": 6209.1,
        "installmentPrice": 383.27,
        "installmentCount": 18,
        "sellerId": "1",
        "sellerName": "SAMSUNG ELETRÔNICA DA AMAZÔNIA LTDA."
      }
    ],
    "color": "Titânio Preto",
    "size": "512 GB",
    "voltage": null,
    "otherSellers": [],
    "mpn": "SM-S938BZKKZTO",
    "features": [
      "Galaxy S25 Series. Seu verdadeiro aliado AI. Galaxy AI",
      "A melhor experiência em fotografia e edição",
      "O processador mais poderoso feito sob medida para o Galaxy"
    ],
    "ean": "7892509139724",
    "shippingDetails": null
  }
}

Complete field reference

PathTypeDescriptionExample
data.additionalProperties[].name string Name of published specification. BRAND
data.additionalProperties[].section string | null Specification group, when provided. Samsung.com
data.additionalProperties[].value string Textual value of the specification. Samsung
data.aggregateRating null Aggregate evaluation; null because the catalog consulted does not provide evaluations. null
data.availability string | null InStock or OutOfStock; null when the origin does not inform. InStock
data.brand.name string Product brand name. Samsung
data.breadcrumbs[].name string Name of a category in the product path. Mobile
data.canonicalUrl string URL canonical product without SKU selection. https://shop.samsung.com/br/galaxy-s25-ultra-512gb/p
data.cashPrice number | null Lowest value in one installment published in the offer; does not imply discount on Pix. 6209.1
data.color string | null Color stated in the catalogue. Titânio Preto
data.currency string Offer currency: BRL. BRL
data.currencyRaw string Currency symbol: R$. R$
data.description string | null Textual description of the product, with HTML tags removed. Celular Samsung Galaxy S25 Ultra 5G, 512GB, 12GB RAM, Galaxy AI, inteligencia artificial, comando e tradução de voz, Câmera Quádrupla de 200+50+10+50, Tela Grande de 6.9" Bateria 5000mAh, Dual Chip, eSim; A Samsung apresenta o mais novo lançamento da linha S. Seu verdadeiro aliado AI, o Galaxy S25 é o novo celular com o poder da nova geração da inteligência artificial. Tenha em suas mãos uma nova experiência com Galaxy AI com seus novos recursos. Eleve o seu dia a dia, com assistência rápida e completa com os novos recursos de IA mais avançados, como traduções em tempo real, geração de texto e imagens, tudo isso com maior rapidez e privacidade, graças à execução de tarefas diretamente no dispositivo. Novas formas de realizar suas tarefas, se divertir, criar e cuidar da sua saúde. Um celular AI totalmente novo que auxilia sua vida diária com conversas em linguagem natural. Celular AI semelhante ao humano alimentado por agentes de IA e com diversos recursos ao seu alcance, com o Gemini Live, conclua instantaneamente várias tarefas de uma só vez com uma conversa natural tendo uma ação entre aplicativos. Conclua várias ações de uma só vez, falando naturalmente com a série Galaxy S25, que entende seus comandos de voz. Sincronize suas mensagens, calendários, texto apenas ativando um único comando. Obtenha facilmente informações, ações e soluções de que você precisa com base no contexto da sua tela. Encontre intuitivamente as informações de que você precisa com pesquisa na tela ou circule para pesquisar. A nova função Now Bar & Now Brief, ainda permite que você verifique as notificações para tarefas em andamento e receba um resumo diário de suas atividades. O Gravador de chamada é mais uma novidade no Galaxy S25, permite que você faça gravação de chamadas com transcrição e resumo no dispositivo. O Novo Galaxy S25 ainda conta com o processador mais poderoso da linha S. O Snapdragon 8 Elite for Galaxy (3nm) tem seu desempenho aprimorado de forma abrangente, oferecendo uma experiência móvel poderosa. O processamento de IA mais rápido em um Galaxy, fornecendo resultados de IA mais confiáveis do que nunca. Falando de câmera o novo Galaxy S25, permite que você tenha novas experiências de filmar e fotografar surpreendente com detalhes e cores mais vibrantes. Tenha o maior nível de detalhes em suas fotos e vídeos, independentemente da lente que você estiver usando. Vídeos Nightography destacam inúmeros detalhes. Imagens vibrantes e realistas, Reconhecimento perfeito do tom de pele com o Object-Aware Engine. O Assistente de fotografia dentro do novo Galaxy S25 ainda conta com novas funcionalidades. O eliminador de áudio ajuda a remover ruídos indesejados em seus vídeos e a uma nova função para você reproduzir a magia do cinema no Studio combinando fotos e vídeos da galeria em novos projetos de filmes. A linha Galaxy S25 ainda conta com a sua identidade de design única da série S, ultra elegante, molduras mais finas e uniformes para visualização mais ampla e usabilidade mais confortável. Sua durabilidade excepcional possui materiais meticulosamente selecionados para um design premium e durável. Seu acabamento em alumínio forte com dureza incrível para o S25 e S25+. E para a versão Ultra acabamento em Titânio. O metal mais resistente já usado na série Galaxy. Vidro resistente “Corning Gorilla Armor” para maior durabilidade (Resistência a arranhões e choques). Brilho adaptável garantindo uma visualização suave e confortável. O novo Galaxy ainda conta com um mix de Cores luminosas inspiradas na natureza, sendo elas: Azul, Verde, Prata e Azul Marinho para a versão básica e Plus. Já nas versões do modelo Ultra, as cores são Titânio Preto, Titânio Cinza, Titânio Prata, Titânio Azul. Com o aplicativo Smart Switch você transfere de forma fácil e prática o conteúdo do seu celular anterior (fotos, contatos, eventos do calendário, notas, configurações do dispositivo e muito mais) para o novo Galaxy S25. Para sua melhor segurança não deixe de conferir as ativações do Cadeado Galaxy, tenha seus dados e seu celular seguro e protegido.
data.descriptionHtml string | null Description HTML published by source; sanitize before displaying as HTML. null
data.ean string | null EAN of the variation, when informed. 7892509139724
data.extractedAt string Date and time of extraction in ISO 8601. 2026-10-01T12:17:16.267Z
data.features[] string Highlights published in the catalogue. Galaxy S25 Series. Seu verdadeiro aliado AI. Galaxy AI
data.images[].url string URL from the image of the selected SKU. https://samsungbrshop.vteximg.com.br/arquivos/ids/249973/S25_1000x1000__0003_S25-ultra_titanio_black.jpg.jpg?v=638793927257870000
data.installmentCount number | null Number of interest-free installments on credit cards for this option. 18
data.installmentPrice number | null Value of the option installment with more interest-free installments on credit cards, when available. 383.27
data.mainImage.url string URL from the image of the selected SKU. https://samsungbrshop.vteximg.com.br/arquivos/ids/249973/S25_1000x1000__0003_S25-ultra_titanio_black.jpg.jpg?v=638793927257870000
data.mpn string | null Manufacturer's reference for the variation; Use the product reference as an alternative. SM-S938BZKKZTO
data.name string Name published by source. Celular Samsung Galaxy S25 Ultra 5G, 512GB, 12GB RAM, Câmera Quádrupla de 200+50+10+50, Tela Grande de 6.9"
data.otherSellers array Other sellers of the same variation, when present. []
data.price number | null Current price in reais; null when the offer is unavailable or unpriced. 6899
data.productId string Product identifier in the Samsung catalog. 6368
data.regularPrice number | null Reference price in reais, when informed. 12099
data.sellerId string | null Offer seller identifier. 1
data.sellerName string | null Name of the seller of the offer. SAMSUNG ELETRÔNICA DA AMAZÔNIA LTDA.
data.sellerUrl null URL from seller when available; currently null in this source. null
data.shippingDetails null null: This API does not calculate shipping or availability per CEP. null
data.size string | null Memory or size of the selected SKU, when provided. 512 GB
data.sku string Variation identifier (SKU); Different voltages may have different SKUs. 8453
data.url string URL; in the product, skuId identifies the selected variation. https://shop.samsung.com/br/galaxy-s25-ultra-512gb/p?skuId=8453
data.variants[].available boolean | null Availability of the selected SKU; null when the origin does not inform. true
data.variants[].cashPrice number | null Lowest value in one installment published in the offer; does not imply discount on Pix. 6209.1
data.variants[].color string | null Published color for the variation, when reported. Titânio Preto
data.variants[].ean string | null EAN of the variation, when informed. 7892509139724
data.variants[].image string | null Variation main image. https://samsungbrshop.vteximg.com.br/arquivos/ids/249973/S25_1000x1000__0003_S25-ultra_titanio_black.jpg.jpg?v=638793927257870000
data.variants[].installmentCount number | null Number of interest-free installments on credit cards for this option. 18
data.variants[].installmentPrice number | null Value of the option installment with more interest-free installments on credit cards, when available. 383.27
data.variants[].name string Variation name, including color or voltage when provided. Titânio Preto
data.variants[].price number | null Current price in reais; null when the offer is unavailable or unpriced. 6899
data.variants[].regularPrice number | null Reference price in reais, when informed. 12099
data.variants[].sellerId string | null Offer seller identifier. 1
data.variants[].sellerName string | null Name of the seller of the offer. SAMSUNG ELETRÔNICA DA AMAZÔNIA LTDA.
data.variants[].size string | null Memory or published size for the variation, when provided. 512 GB
data.variants[].sku string Variation identifier (SKU); Different voltages may have different SKUs. 8453
data.variants[].url string Public URL with skuId to query this variation in PDP. https://shop.samsung.com/br/galaxy-s25-ultra-512gb/p?skuId=8453
data.variants[].voltage string | null Variation voltage, such as 110V, 220V or Bivolt, when informed. null
data.voltage string | null Variation voltage, such as 110V, 220V or Bivolt, when informed. null
executionId string Identifier of the worker execution. f7b0f7f6-3363-4958-9f7e-6c0e0d189874
requestId string Request identifier HTTP in GeckoAPI. d68564d2-34bc-47e6-a1a6-796794f8463b

Errors and missing data

When supported by this operation, an entity not found upstream can return HTTP 200 with data: null and notFound: true. Check the documented response fields before interpreting an empty result. Source-specific behavior and exceptions are described above.

HTTP statusError codeMeaning
400INVALID_PAYLOADInvalid JSON or a request that violates the documented validation rules.
401UNAUTHORIZEDMissing authorization or an invalid API key or token.
402INSUFFICIENT_CREDITSThe account has insufficient credits for this operation.
403FORBIDDENThe account does not have access, or the API is temporarily disabled.
409EXECUTION_CONFLICTThe execution identifier conflicts with an incompatible execution state.
429RATE_LIMIT_EXCEEDED / TOO_MANY_INFLIGHT_REQUESTSA rate limit or simultaneous request limit was exceeded.
5xxUPSTREAM_TIMEOUT / UPSTREAM_HTTP_ERROR / WORKER_FUNCTION_ERRORAn upstream, worker or gateway failure. Failed requests follow the platform refund policy.

Other Samsung operations