centauro.com.br
Centauro API
Query public Centauro data with GeckoAPI and receive structured JSON. Choose an operation to review its inputs, credit cost and response fields.
Extracts searches Centauro with price, Pix, seller name, color preview, available SKUs, ordering and pagination. Each page costs 1 credit.
GeckoAPI is independent of Centauro. This integration reads public data; it does not grant access to private accounts or account management operations.
Available operations
Search products
centauro.com.br:plp
Extracts searches Centauro with price, Pix, seller name, color preview, available SKUs, ordering and pagination. Each page costs 1 credit.
1 credit per request
Get product details
centauro.com.br:pdp
Extracts product Centauro with prices, Pix, seller by SKU, colors, sizes, stock, images, attributes and reviews. Each consultation 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
variants includes all sizes of the selected color, including out-of-stock options. colorVariants and variantOptions link to all published colors; query each URL to obtain its sizes and sellers. sellers groups sellers observed across sizes, and otherSellers is empty because the catalog has no competing offers for the same SKU. Price and availability do not use a CEP. The example abbreviates images, attributes and options; prices reflect the capture on 05/10/2026.
Supports /busca/ URLs and keyword searches. Each page returns up to 36 products. Cards publish the seller name without an ID or URL and a limited color preview; use PDP for the sellers and stock of each size. The card SKU identifies the model/color; skus lists the published available sizes. Price and stock reflect the catalog without a CEP. The example contains two of the 36 items captured on 05/10/2026.
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": "centauro.com.br",
"type": "plp",
"url": "https://www.centauro.com.br/busca/tenis-nike"
}'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": "726aa41c-d0e5-4924-99bd-77d221de5040",
"executionId": "b4dfc268-183e-4b98-8568-af4729eed6b9",
"data": {
"source": "centauro.com.br",
"type": "plp",
"extractedAt": "2026-10-05T22:14:39.851Z",
"url": "https://www.centauro.com.br/busca/tenis-nike",
"requestUrl": "https://www.centauro.com.br/busca/tenis-nike",
"query": "tenis nike",
"page": 1,
"totalResults": 1693,
"resultsPerPage": 36,
"offset": 0,
"nextPage": 2,
"nextPageUrl": "https://www.centauro.com.br/busca/tenis-nike?page=2",
"items": [
{
"url": "https://www.centauro.com.br/tenis-masculino-nike-revolution-8-995996.html?cor=31",
"sku": "99599631",
"productId": "995996",
"name": "Tênis Masculino Nike Revolution 8",
"price": 315.78,
"regularPrice": 399.99,
"cashPrice": 299.99,
"discountPercentage": 25,
"installmentPrice": 105.26,
"installmentCount": 3,
"currency": "BRL",
"currencyRaw": "R$",
"availability": "InStock",
"imageUrl": "https://imgcentauro-a.akamaihd.net/230x230/99599631A20.jpg",
"brand": "Nike",
"sellerName": "Centauro",
"sellerId": null,
"sellerUrl": null
},
{
"url": "https://www.centauro.com.br/tenis-feminino-nike-revolution-8-995997.html?cor=31",
"sku": "99599731",
"productId": "995997",
"name": "Tênis Feminino Nike Revolution 8",
"price": 315.78,
"regularPrice": 399.99,
"cashPrice": 299.99,
"discountPercentage": 25,
"installmentPrice": 105.26,
"installmentCount": 3,
"currency": "BRL",
"currencyRaw": "R$",
"availability": "InStock",
"imageUrl": "https://imgcentauro-a.akamaihd.net/230x230/99599731A4.jpg",
"brand": "Nike",
"sellerName": "Centauro",
"sellerId": null,
"sellerUrl": null
}
]
}
}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 Centauro API?
Open the documented example in the sandbox and inspect the response before integrating it into your application.