// docs

Netshoes: Get product details

Extracts detailed product data (PDP) from Netshoes from raw unrendered HTML, including size grid, review recommendation, attributes and dimensions.

netshoes.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.netshoes.com.br/p/tenis-adidas-breaknet-FB9-9335-205",
  "target": "netshoes.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

netshoes_com_br_pdp · tools/call

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "netshoes_com_br_pdp",
    "arguments": {
      "url": "https://www.netshoes.com.br/p/tenis-adidas-breaknet-FB9-9335-205",
      "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.netshoes.com.br/p/tenis-adidas-breaknet-FB9-9335-205
target Target source for extraction.	enum	Required	Always mandatory in the payload and must be netshoes.com.br.	-	netshoes.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

Request examples

PDP by URL

Basic request with URL product canonical of Netshoes.

PDP by URL

{
  "url": "https://www.netshoes.com.br/p/tenis-adidas-breaknet-FB9-9335-205",
  "target": "netshoes.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)",
  "notFound": "boolean (optional; true when the upstream entity was not found and data is null)",
  "data.canonicalUrl": "string",
  "data.url": "string",
  "data.name": "string",
  "data.sku": "string",
  "data.parentSku": "string",
  "data.brand.name": "string",
  "data.department": "string",
  "data.productType": "string",
  "data.genders[]": "string",
  "data.sizeType": "string",
  "data.color": "string",
  "data.size": "string",
  "data.ean": "string",
  "data.price": "number",
  "data.cashPrice": "number",
  "data.regularPrice": "number",
  "data.discountAmount": "number",
  "data.discountPercent": "number",
  "data.installmentPrice": "number",
  "data.installmentCount": "number",
  "data.sellerName": "string",
  "data.sellerId": "string",
  "data.availability": "\"InStock\" | \"OutOfStock\"",
  "data.freeShipping": "boolean",
  "data.netshoesDelivery": "boolean",
  "data.sizeBayEligible": "boolean",
  "data.aggregateRating.ratingValue": "number",
  "data.aggregateRating.reviewCount": "number",
  "data.percentRecommended": "number",
  "data.reviewHistogram[].starNumber": "number",
  "data.reviewHistogram[].numberOfVotes": "number",
  "data.images[].url": "string",
  "data.mainImage.url": "string",
  "data.breadcrumbs[].name": "string",
  "data.breadcrumbs[].url": "string",
  "data.additionalProperties[].name": "string",
  "data.additionalProperties[].value": "string | number | boolean",
  "data.mainTraits[].name": "string",
  "data.mainTraits[].value": "string",
  "data.features[]": "string",
  "data.searchUrls[].name": "string",
  "data.searchUrls[].url": "string",
  "data.variants[].sku": "string",
  "data.variants[].size": "string",
  "data.variants[].availability": "\"InStock\" | \"OutOfStock\"",
  "data.variants[].price": "number",
  "data.variants[].regularPrice": "number",
  "data.variants[].sellerName": "string",
  "data.stamps[]": "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": "req_netshoes_pdp_demo",
  "executionId": "exec_netshoes_pdp_demo",
  "data": {
    "canonicalUrl": "https://www.netshoes.com.br/p/tenis-adidas-breaknet-FB9-9335-205",
    "url": "https://www.netshoes.com.br/p/tenis-adidas-breaknet-FB9-9335-205",
    "name": "Tênis Adidas Breaknet",
    "sku": "FB9-9335-205-40",
    "parentSku": "FB9-9335",
    "brand": {
      "id": "3",
      "name": "Adidas",
      "slug": "adidas"
    },
    "department": "Casual",
    "productType": "Tênis",
    "genders": [
      "Masculino"
    ],
    "sizeType": "BR",
    "color": "Branco",
    "size": "40",
    "ean": "4067890000000",
    "description": "Tênis casual da Adidas com cabedal sintético e visual clássico.",
    "longDescription": "Tênis casual da Adidas com construção versátil, conforto para o uso diário e visual inspirado em quadra.",
    "origin": "Nacional",
    "weightInGrams": 900,
    "heightInCm": 12,
    "widthInCm": 10,
    "depthInCm": 30,
    "currency": "BRL",
    "currencyRaw": "R$",
    "price": 229.99,
    "cashPrice": 219.99,
    "regularPrice": 349.99,
    "discountAmount": 120,
    "discountPercent": 34,
    "installmentPrice": 23,
    "installmentCount": 10,
    "sellerName": "Adidas",
    "sellerId": "9702",
    "availability": "InStock",
    "freeShipping": true,
    "nearExpirationDate": false,
    "netshoesDelivery": true,
    "sizeBayEligible": true,
    "breadcrumbs": [
      {
        "name": "Casual",
        "url": "https://www.netshoes.com.br/casual"
      }
    ],
    "images": [
      {
        "url": "https://static.netshoes.com.br/produtos/tenis-adidas-breaknet/05/FB9-9335-205/FB9-9335-205_zoom1.jpg"
      }
    ],
    "mainImage": {
      "url": "https://static.netshoes.com.br/produtos/tenis-adidas-breaknet/05/FB9-9335-205/FB9-9335-205_zoom1.jpg"
    },
    "videos": [
      {
        "url": "https://videos.netshoes.com.br/demo.mp4",
        "thumbnailUrl": "https://videos.netshoes.com.br/demo-thumb.jpg"
      }
    ],
    "aggregateRating": {
      "ratingValue": 4.71,
      "reviewCount": 9552,
      "bestRating": 5
    },
    "percentRecommended": 96,
    "reviewHistogram": [
      {
        "starNumber": 5,
        "numberOfVotes": 231,
        "percentOfVotes": 89
      }
    ],
    "additionalProperties": [
      {
        "name": "Marca",
        "value": "Adidas"
      },
      {
        "name": "Gênero",
        "value": "Masculino"
      },
      {
        "name": "Origem",
        "value": "Nacional"
      }
    ],
    "mainTraits": [
      {
        "name": "Marca",
        "value": "Adidas"
      },
      {
        "name": "Gênero",
        "value": "Masculino"
      }
    ],
    "features": [
      "Marca: Adidas",
      "Gênero: Masculino"
    ],
    "searchUrls": [
      {
        "name": "Tênis Adidas",
        "url": "https://www.netshoes.com.br/busca/tenis-adidas"
      }
    ],
    "variants": [
      {
        "sku": "FB9-9335-205-39",
        "size": "39",
        "ean": "4067890000001",
        "availability": "InStock",
        "price": 229.99,
        "regularPrice": 349.99,
        "sellerId": "9702",
        "sellerName": "Adidas",
        "freeShipping": true,
        "nearExpirationDate": false,
        "netshoesDelivery": true,
        "stamps": [
          "NetsGO"
        ]
      }
    ],
    "stamps": [
      "NetsGO"
    ]
  }
}

Complete field reference

Path	Type	Description	Example
data.additionalProperties[].name	string	Structured attribute name.	Marca
data.additionalProperties[].value	string \| number \| boolean	Structured attribute value.	Adidas
data.aggregateRating.ratingValue	number	Aggregated average product rating.	4.71
data.aggregateRating.reviewCount	number	Total number of aggregated reviews.	9552
data.availability	"InStock" \| "OutOfStock"	Standard product availability status.	InStock
data.brand.name	string	Product brand name.	Adidas
data.breadcrumbs[].name	string	Name of the breadcrumb level.	Casual
data.breadcrumbs[].url	string	URL publishes from the breadcrumb level.	https://www.netshoes.com.br/casual
data.canonicalUrl	string	URL canonical published by Netshoes for the product.	https://www.netshoes.com.br/p/tenis-adidas-breaknet-FB9-9335-205
data.cashPrice	number	Final price without additional payment method discount.	219.99
data.color	string	Color of the selected variation.	Branco
data.department	string	Main department reported by Netshoes.	Casual
data.discountAmount	number	Absolute value of the discount in reais.	120
data.discountPercent	number	Percentage discount on the list price.	34
data.ean	string	EAN of the selected variation when available.	4067890000000
data.features[]	string	Summary textual representation of the main attributes.	Marca: Adidas
data.freeShipping	boolean	Indicates whether the main offer includes free shipping.	true
data.genders[]	string	List of genres associated with the product.	Masculino
data.images[].url	string	Product image URL.	https://static.netshoes.com.br/produtos/tenis-adidas-breaknet/05/FB9-9335-205/FB9-9335-205_zoom1.jpg
data.installmentCount	number	Number of installments informed by Netshoes.	10
data.installmentPrice	number	Installment amount informed by Netshoes.	23
data.mainImage.url	string	URL of the main product image.	https://static.netshoes.com.br/produtos/tenis-adidas-breaknet/05/FB9-9335-205/FB9-9335-205_zoom1.jpg
data.mainTraits[].name	string	Name of the main line displayed in PDP.	Marca
data.mainTraits[].value	string	Main trace value displayed in PDP.	Adidas
data.name	string	Product name.	Tênis Adidas Breaknet
data.netshoesDelivery	boolean	Indicates whether the delivery is operated by Netshoes.	true
data.parentSku	string	Product/grade parent code.	FB9-9335
data.percentRecommended	number	Percentage of users who recommend the product.	96
data.price	number	Sales price displayed.	229.99
data.productType	string	Product type reported by Netshoes.	Tênis
data.regularPrice	number	List price/before discount.	349.99
data.reviewHistogram[].numberOfVotes	number	Number of votes in that star range.	231
data.reviewHistogram[].starNumber	number	Number of stars in the evaluated range.	5
data.searchUrls[].name	string	Related search label published by Netshoes.	Tênis Adidas
data.searchUrls[].url	string	URL absolute search related.	https://www.netshoes.com.br/busca/tenis-adidas
data.sellerId	string	Identifier of the seller associated with the main offer.	9702
data.sellerName	string	Name of the seller associated with the main offer.	Adidas
data.size	string	Size of the selected variation.	40
data.sizeBayEligible	boolean	SizeBay eligibility flag when present upstream.	true
data.sizeType	string	Size chart/grid type.	BR
data.sku	string	SKU of the selected variation.	FB9-9335-205-40
data.stamps[]	string	Commercial seals or badges associated with the main offer.	NetsGO
data.url	string	URL returned in the scraper payload.	https://www.netshoes.com.br/p/tenis-adidas-breaknet-FB9-9335-205
data.variants[].availability	"InStock" \| "OutOfStock"	Standard variant availability.	InStock
data.variants[].price	number	Sales price of the variant.	229.99
data.variants[].regularPrice	number	Variant list price.	349.99
data.variants[].sellerName	string	Seller associated with variant.	Adidas
data.variants[].size	string	Variant size.	39
data.variants[].sku	string	SKU of one variant/size within the grid.	FB9-9335-205-39
executionId	string (uuid)	Unique identifier of the worker execution.	exec_netshoes_pdp_demo
notFound	boolean (optional; true when the upstream entity was not found and data is null)	Optional indicator for responses where the entity does not exist upstream.	N/A
requestId	string (uuid)	Unique identifier of the request served by the gateway.	req_netshoes_pdp_demo

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.

Other Netshoes operations

Search products (PLP)