// docs

Centauro: Search products

Extracts searches Centauro with price, Pix, seller name, color preview, available SKUs, ordering and pagination. Each page costs 1 credit.

centauro.com.br:plp · 1 credit per request

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

Try this operation in the sandbox

Source-specific limitations

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.

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": "centauro.com.br",
  "type": "plp",
  "url": "https://www.centauro.com.br/busca/tenis-nike"
}'

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

centauro_com_br_plp · tools/call

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "centauro_com_br_plp",
    "arguments": {
      "url": "https://www.centauro.com.br/busca/tenis-nike",
      "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)	Optional	URL HTTPS search in centauro.com.br or www.centauro.com.br with path /busca/TERMO. Accepts page, sorting and filters repeated fields. /nav/ URLs are not yet supported.	-	https://www.centauro.com.br/busca/tenis-nike
keyword Keyword for PLP searches. In Google Search it represents the query sent to Google; in Booking PLP is mandatory; in other PLPs it can replace URL.	string	Optional	Mandatory when url is not provided; 1 to 200 characters. When both are sent, it must match the term of URL.	-	tenis nike
sort Ordering for VivaReal, Chaves na Mão, OLX and Webmotors PLP, Booking Review and Hotels Review. VivaReal: relevance/date/price/biggest_price/biggest_area. Webmotors: relevance/price/biggest_price/year_desc/mileage_asc. OLX: relevance/date/price/biggest_price/price_relevance. Booking/Hotels Review: most_relevant/newest_first/oldest_first/score_desc/score_asc.	"relevance" \| "date" \| "price" \| "biggest_price" \| "biggest_area" \| "price_relevance" \| "most_relevant" \| "newest_first" \| "oldest_first" \| "score_desc" \| "score_asc" \| "year_desc" \| "mileage_asc"	Optional	relevance, price, biggest_price or biggest_discount. Without sort, preserves sorting of URL; by default it uses relevance.	-	price
target Target source for extraction.	enum	Required	Use centauro.com.br.	centauro.com.br	centauro.com.br
type Extraction type: pdp, idp, plp, ilp, quote, review or places.	enum	Required	Use plp.	plp	plp
page Pagination. In PLP, including Trivago, and in Reclame AQUI ILP starts in 1; in review (MercadoLivre, Booking and Hotels) starts in 0. The Reclame AQUI ILP even accepts the page 100.	integer	Optional	Integer number from 1 to 500. Overlays the page present in the URL.	1	2

Request examples

Search for URL

Preserves the fields filters and sorting order present in URL.

Search for URL

{
  "target": "centauro.com.br",
  "type": "plp",
  "url": "https://www.centauro.com.br/busca/tenis-nike"
}

Keyword search

URL optional; page controls the page and sort the ordering.

Keyword search

{
  "target": "centauro.com.br",
  "type": "plp",
  "keyword": "tenis nike",
  "page": 2,
  "sort": "price"
}

Continue to next URL

Use nextPageUrl returned by the previous extraction.

Continue to next URL

{
  "target": "centauro.com.br",
  "type": "plp",
  "url": "https://www.centauro.com.br/busca/tenis-nike?page=2"
}

Response schema

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

responseSchema

{
  "requestId": "string",
  "executionId": "string",
  "data.source": "string",
  "data.type": "string",
  "data.extractedAt": "string",
  "data.url": "string",
  "data.requestUrl": "string",
  "data.query": "string",
  "data.page": "number",
  "data.totalResults": "number",
  "data.resultsPerPage": "number",
  "data.offset": "number",
  "data.nextPage": "number | null",
  "data.nextPageUrl": "string | null",
  "data.items[].url": "string",
  "data.items[].sku": "string",
  "data.items[].productId": "string | null",
  "data.items[].name": "string | null",
  "data.items[].price": "number | null",
  "data.items[].regularPrice": "number | null",
  "data.items[].cashPrice": "number | null",
  "data.items[].discountPercentage": "number | null",
  "data.items[].installmentPrice": "number | null",
  "data.items[].installmentCount": "number | null",
  "data.items[].currency": "string",
  "data.items[].currencyRaw": "string",
  "data.items[].availability": "string | null",
  "data.items[].imageUrl": "string | null",
  "data.items[].brand": "string | null",
  "data.items[].sellerName": "string | null",
  "data.items[].sellerId": "null",
  "data.items[].sellerUrl": "null",
  "data.items[].aggregateRating.ratingValue": "number | null",
  "data.items[].aggregateRating.reviewCount": "number | null",
  "data.items[].aggregateRating.bestRating": "number | null",
  "data.items[].skus[]": "string",
  "data.items[].colorId": "string | null",
  "data.items[].colorsQuantity": "number | null",
  "data.items[].sizeQuantity": "number | null",
  "data.items[].variants[].productId": "string | null",
  "data.items[].variants[].color": "string | null",
  "data.items[].variants[].url": "string",
  "data.items[].variants[].imageUrl": "string | null",
  "data.items[].variants[].price": "number | null",
  "data.items[].variants[].regularPrice": "number | null",
  "data.items[].variants[].cashPrice": "number | null",
  "data.items[].aggregateRating": "object | 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": "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,
        "aggregateRating": {
          "ratingValue": 4.7,
          "reviewCount": 533,
          "bestRating": 5
        },
        "skus": [
          "995996310441",
          "995996310434",
          "995996310427",
          "995996310403",
          "M16Z23310384",
          "M16Z23310377",
          "995996310410",
          "995996310397"
        ],
        "colorId": "31",
        "colorsQuantity": 14,
        "sizeQuantity": 8,
        "variants": [
          {
            "productId": "99599612",
            "color": "BEGE",
            "url": "https://www.centauro.com.br/tenis-masculino-nike-revolution-8-995996.html?cor=12",
            "imageUrl": "https://imgcentauro-a.akamaihd.net/230x230/99599612A2.jpg",
            "price": 315.78,
            "regularPrice": 399.99,
            "cashPrice": 299.99
          },
          {
            "productId": "99599619",
            "color": "PRETO/VERMELHO",
            "url": "https://www.centauro.com.br/tenis-masculino-nike-revolution-8-995996.html?cor=19",
            "imageUrl": "https://imgcentauro-a.akamaihd.net/230x230/99599619A2.jpg",
            "price": 315.78,
            "regularPrice": 399.99,
            "cashPrice": 299.99
          }
        ]
      },
      {
        "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,
        "aggregateRating": {
          "ratingValue": 4.7,
          "reviewCount": 316,
          "bestRating": 5
        },
        "skus": [
          "995997310372",
          "995997310365",
          "995997310358",
          "995997310341",
          "M19C1P311534",
          "995997310396",
          "M19C1P310384"
        ],
        "colorId": "31",
        "colorsQuantity": 20,
        "sizeQuantity": 7,
        "variants": [
          {
            "productId": "99599711",
            "color": "LARANJA",
            "url": "https://www.centauro.com.br/tenis-feminino-nike-revolution-8-995997.html?cor=11",
            "imageUrl": "https://imgcentauro-a.akamaihd.net/230x230/995997NSA2.jpg",
            "price": 315.78,
            "regularPrice": 399.99,
            "cashPrice": 299.99
          },
          {
            "productId": "99599737",
            "color": "BRANCO/ROSA",
            "url": "https://www.centauro.com.br/tenis-feminino-nike-revolution-8-995997.html?cor=37",
            "imageUrl": "https://imgcentauro-a.akamaihd.net/230x230/9959972LA2.jpg",
            "price": 315.78,
            "regularPrice": 399.99,
            "cashPrice": 299.99
          }
        ]
      }
    ]
  }
}

Complete field reference

Path	Type	Description	Example
data.extractedAt	string	Date and time of extraction in ISO 8601.	2026-10-05T22:14:39.851Z
data.items[].aggregateRating	object \| null	Published Aggregate Valuation, or null.	{"ratingValue":4.7,"reviewCount":533,"bestRating":5}
data.items[].aggregateRating.bestRating	number \| null	Maximum grade on the published scale.	5
data.items[].aggregateRating.ratingValue	number \| null	Average published rating.	4.7
data.items[].aggregateRating.reviewCount	number \| null	Number of reviews published.	533
data.items[].availability	string \| null	InStock or OutOfStock; null when the origin does not inform.	InStock
data.items[].brand	string \| null	Brand published by origin.	Nike
data.items[].cashPrice	number \| null	Published price Pix, in reais; null when not informed.	299.99
data.items[].colorId	string \| null	Color code in the catalogue.	31
data.items[].colorsQuantity	number \| null	Total number of colors published on the card; may exceed preview in variants.	14
data.items[].currency	string	Currency code: BRL.	BRL
data.items[].currencyRaw	string	Monetary symbol: R$.	R$
data.items[].discountPercentage	number \| null	Published discount percentage; can vary between PLP and PDP and is not recalculated.	25
data.items[].imageUrl	string \| null	URL public image.	https://imgcentauro-a.akamaihd.net/230x230/99599631A20.jpg
data.items[].installmentCount	number \| null	Number of installments published.	3
data.items[].installmentPrice	number \| null	Value of each card installment, in reais.	105.26
data.items[].name	string \| null	Name published by source.	Tênis Masculino Nike Revolution 8
data.items[].price	number \| null	Current published price for card payment, in reais; can exist even without stock.	315.78
data.items[].productId	string \| null	Product identifier published by the catalog.	995996
data.items[].regularPrice	number \| null	Published reference price, in reais.	399.99
data.items[].sellerId	null	null: PLP publishes only the name of the seller; see PDP for ID and URL.	null
data.items[].sellerName	string \| null	Seller name published for the offer.	Centauro
data.items[].sellerUrl	null	null: PLP publishes only the name of the seller; see PDP for ID and URL.	null
data.items[].sizeQuantity	number \| null	Number of available sizes published on the card.	8
data.items[].sku	string	Identifier of the card model/color, distinct from the full SKUs in skus[].	99599631
data.items[].skus[]	string	SKU complete of an available size published on the card.	995996310441
data.items[].url	string	URL.	https://www.centauro.com.br/tenis-masculino-nike-revolution-8-995996.html?cor=31
data.items[].variants[].cashPrice	number \| null	Published price Pix, in reais; null when not informed.	299.99
data.items[].variants[].color	string \| null	Color name published by source.	BEGE
data.items[].variants[].imageUrl	string \| null	URL public image.	https://imgcentauro-a.akamaihd.net/230x230/99599612A2.jpg
data.items[].variants[].price	number \| null	Current published price for card payment, in reais; can exist even without stock.	315.78
data.items[].variants[].productId	string \| null	Model/color identifier in color options, or full SKU in size options.	99599612
data.items[].variants[].regularPrice	number \| null	Published reference price, in reais.	399.99
data.items[].variants[].url	string	URL.	https://www.centauro.com.br/tenis-masculino-nike-revolution-8-995996.html?cor=12
data.nextPage	number \| null	Number of the next page, or null when there is no continuation.	2
data.nextPageUrl	string \| null	URL to continue the search preserving sorting and filters, or null.	https://www.centauro.com.br/busca/tenis-nike?page=2
data.offset	number	Starting page position: (page - 1) × resultsPerPage.	0
data.page	number	Current page, starting at 1.	1
data.query	string	Term used in the search.	tenis nike
data.requestUrl	string	URL public search with page, sorting and filters applied.	https://www.centauro.com.br/busca/tenis-nike
data.resultsPerPage	number	Quantity configured per page: 36; the last page may contain fewer items.	36
data.source	string	Source domain: centauro.com.br.	centauro.com.br
data.totalResults	number	Total number of results reported by the catalog.	1693
data.type	string	Extraction type.	plp
data.url	string	URL.	https://www.centauro.com.br/busca/tenis-nike
executionId	string	Identifier of the worker execution.	b4dfc268-183e-4b98-8568-af4729eed6b9
requestId	string	Request identifier HTTP in GeckoAPI.	726aa41c-d0e5-4924-99bd-77d221de5040

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 Centauro operations

Get product details (PDP)