// docs

Casas Bahia: Get product details

Extracts complete product data (PDP) from Casas Bahia, including main offer, secondary sellers, attributes and variations.

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

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

Try this operation in the sandbox

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 '{
  "url": "https://www.casasbahia.com.br/apple-iphone-16-128gb-61-48mp-preto/p/55067621",
  "target": "casasbahia.com.br",
  "type": "pdp"
}'

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

casasbahia_com_br_pdp · tools/call

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "casasbahia_com_br_pdp",
    "arguments": {
      "url": "https://www.casasbahia.com.br/apple-iphone-16-128gb-61-48mp-preto/p/55067621",
      "executionId": "exec_example_123"
    }
  }
}

Supported inputs

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

Field	Type	Requirement	Rule	Default	Example
url URL extraction target. For some PLPs it can be omitted when API assembles URL from other fields.	string (URL)	Required	Required for this operation.	-	https://www.casasbahia.com.br/apple-iphone-16-128gb-61-48mp-preto/p/55067621
target Target source for extraction.	enum	Required	Always mandatory in the payload and must be casasbahia.com.br.	casasbahia.com.br	casasbahia.com.br
type Extraction type: pdp, idp, plp, ilp, quote, review or places.	enum	Required	Always mandatory in the payload and must be pdp.	pdp	pdp

Request examples

PDP by URL

Basic request with the public URL of the product page.

PDP by URL

{
  "url": "https://www.casasbahia.com.br/apple-iphone-16-128gb-61-48mp-preto/p/55067621",
  "target": "casasbahia.com.br",
  "type": "pdp"
}

Response schema

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

responseSchema

{
  "requestId": "string (uuid)",
  "executionId": "string (uuid)",
  "data.extractedAt": "string (ISO 8601)",
  "data.canonicalUrl": "string",
  "data.cashPrice": "number",
  "data.price": "number",
  "data.regularPrice": "number",
  "data.sellerName": "string",
  "data.sellerId": "string",
  "data.currency": "string",
  "data.currencyRaw": "string",
  "data.sku": "string",
  "data.availability": "string",
  "data.name": "string",
  "data.url": "string",
  "data.description": "string",
  "data.images[].url": "string",
  "data.mainImage.url": "string",
  "data.brand.name": "string",
  "data.breadcrumbs[].name": "string",
  "data.additionalProperties[].name": "string",
  "data.additionalProperties[].value": "string | number",
  "data.variants[].sku": "string",
  "data.variants[].name": "string",
  "data.variants[].url": "string",
  "data.variants[].image": "string",
  "data.color": "string",
  "data.otherSellers[].sellerName": "string",
  "data.otherSellers[].price": "number",
  "data.otherSellers[].sellerId": "string",
  "data.mpn": "string",
  "data.features[]": "string",
  "data.ean": "string",
  "data.installmentPrice": "number",
  "data.installmentCount": "integer",
  "data.productId": "string"
}

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": "5cb8cfd2-4cb3-4b90-a058-77bd20f7e9e4",
  "executionId": "0b9c4f3d-96f9-45f7-9f0d-3db4d796d8fb",
  "data": {
    "extractedAt": "2026-04-18T00:00:00.000Z",
    "canonicalUrl": "https://www.casasbahia.com.br/apple-iphone-16-128gb-61-48mp-preto/p/55067621",
    "cashPrice": 4999,
    "price": 5299,
    "regularPrice": 5499,
    "sellerName": "Casas Bahia",
    "sellerId": "0",
    "currency": "BRL",
    "currencyRaw": "R$",
    "sku": "55067621",
    "availability": "InStock",
    "name": "Apple iPhone 16 128GB 6,1 48MP Preto",
    "url": "https://www.casasbahia.com.br/apple-iphone-16-128gb-61-48mp-preto/p/55067621",
    "description": "iPhone 16 com camera Fusion de 48 MP, chip A18 e armazenamento de 128GB.",
    "images": [
      {
        "url": "https://imgs.casasbahia.com.br/55067621/1xg.jpg"
      }
    ],
    "mainImage": {
      "url": "https://imgs.casasbahia.com.br/55067621/1xg.jpg"
    },
    "brand": {
      "name": "Apple"
    },
    "breadcrumbs": [
      {
        "name": "Telefones e Celulares"
      },
      {
        "name": "Smartphones"
      },
      {
        "name": "iPhone"
      }
    ],
    "additionalProperties": [
      {
        "name": "Memoria total",
        "value": "128GB"
      },
      {
        "name": "Cor",
        "value": "Preto"
      }
    ],
    "variants": [
      {
        "sku": "55067622",
        "name": "Apple iPhone 16 128GB 6,1 48MP Rosa",
        "url": "https://www.casasbahia.com.br/apple-iphone-16-128gb-61-48mp-rosa/p/55067622",
        "image": "https://imgs.casasbahia.com.br/55067622/1xg.jpg"
      }
    ],
    "color": "Preto",
    "otherSellers": [
      {
        "sellerName": "Marketplace Parceiro",
        "price": 5359,
        "sellerId": "33013"
      }
    ],
    "mpn": "MYE73BR/A",
    "features": [
      "Tela de 6,1 polegadas",
      "Camera Fusion de 48 MP",
      "Chip A18"
    ],
    "ean": "195949822450",
    "installmentPrice": 529.9,
    "installmentCount": 10,
    "productId": "80872678"
  }
}

Complete field reference

Path	Type	Description	Example
data.additionalProperties[].name	string	Name of the technical attribute extracted from the information sections.	Memoria total
data.additionalProperties[].value	string \| number	Value of the extracted technical attribute.	128GB
data.availability	string	Normalized availability status of the main offer.	InStock
data.brand.name	string	Standardized brand name.	Apple
data.breadcrumbs[].name	string	Each level of product category navigation.	Telefones e Celulares
data.canonicalUrl	string	URL canonical synthesized for the product page.	https://www.casasbahia.com.br/apple-iphone-16-128gb-61-48mp-preto/p/55067621
data.cashPrice	number	Normalized cash price when the offer includes a payment discount.	4999
data.color	string	Main color inferred from product attributes.	Preto
data.currency	string	Currency code returned by operation.	BRL
data.currencyRaw	string	Textual representation of the currency displayed in the source.	R$
data.description	string	Standard textual description of the product.	iPhone 16 com camera Fusion de 48 MP, chip A18 e armazenamento de 128GB.
data.ean	string	EAN of the product when identified in the description or attributes.	195949822450
data.extractedAt	string (ISO 8601)	Timestamp ISO at which the extraction was completed.	2026-04-18T00:00:00.000Z
data.features[]	string	Summary list of the product's highlighted features.	Tela de 6,1 polegadas
data.images[].url	string	URL of each image in the gallery.	https://imgs.casasbahia.com.br/55067621/1xg.jpg
data.installmentCount	integer	Number of installments for the best installment plan.	10
data.installmentPrice	number	Installment value in the best installment plan found.	529.9
data.mainImage.url	string	URL of the main product image.	https://imgs.casasbahia.com.br/55067621/1xg.jpg
data.mpn	string	Reference code or MPN inferred from the technical attributes.	MYE73BR/A
data.name	string	Product title.	Apple iPhone 16 128GB 6,1 48MP Preto
data.otherSellers[].price	number	Price reported for alternative seller.	5359
data.otherSellers[].sellerId	string	Standardized identifier of the alternative seller.	33013
data.otherSellers[].sellerName	string	Name of an alternative seller returned in the offer payload.	Marketplace Parceiro
data.price	number	Current prime price of the product.	5299
data.productId	string	Internal product identifier at source.	80872678
data.regularPrice	number	Previous reference price or without discount.	5499
data.sellerId	string	Standardized identifier of the main seller.	0
data.sellerName	string	Name of the main seller of the offer.	Casas Bahia
data.sku	string	SKU from main offer resolved from URL.	55067621
data.url	string	URL public used as reference of the extracted entity.	https://www.casasbahia.com.br/apple-iphone-16-128gb-61-48mp-preto/p/55067621
data.variants[].image	string	Main image of the related variation.	https://imgs.casasbahia.com.br/55067622/1xg.jpg
data.variants[].name	string	Displayed name of the related variation.	Apple iPhone 16 128GB 6,1 48MP Rosa
data.variants[].sku	string	SKU of the related variation.	55067622
data.variants[].url	string	URL public summary of the related variation.	https://www.casasbahia.com.br/apple-iphone-16-128gb-61-48mp-rosa/p/55067622
executionId	string (uuid)	Unique identifier of the worker execution for traceability.	0b9c4f3d-96f9-45f7-9f0d-3db4d796d8fb
requestId	string (uuid)	Unique identifier of the request HTTP in GeckoAPI.	5cb8cfd2-4cb3-4b90-a058-77bd20f7e9e4

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 status	Error code	Meaning
400	`INVALID_PAYLOAD`	Invalid JSON or a request that violates the documented validation rules.
401	`UNAUTHORIZED`	Missing authorization or an invalid API key or token.
402	`INSUFFICIENT_CREDITS`	The account has insufficient credits for this operation.
403	`FORBIDDEN`	The account does not have access, or the API is temporarily disabled.
409	`EXECUTION_CONFLICT`	The execution identifier conflicts with an incompatible execution state.
429	`RATE_LIMIT_EXCEEDED / TOO_MANY_INFLIGHT_REQUESTS`	A rate limit or simultaneous request limit was exceeded.
5xx	`UPSTREAM_TIMEOUT / UPSTREAM_HTTP_ERROR / WORKER_FUNCTION_ERROR`	An upstream, worker or gateway failure. Failed requests follow the platform refund policy.

Casas Bahia: Get product details

HTTP request

MCP request

Supported inputs

Request examples

PDP by URL

Response schema

Example response

Complete field reference

Errors and missing data

Other Casas Bahia operations