// docs

Electrolux: Search products

Search for Electrolux products by keyword or URL, with prices, availability and pagination. Each PLP query costs 1 credit.

loja.electrolux.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

Search queries the catalog and may include parts and accessories related to the term. The example shows two items from a page of up to 12. Sorting and stock may change between requests. The catalog limits the result window to at most 208 accessible pages.

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": "loja.electrolux.com.br",
  "type": "plp",
  "keyword": "geladeira frost free",
  "page": 1
}'

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

loja_electrolux_com_br_plp · tools/call

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "loja_electrolux_com_br_plp",
    "arguments": {
      "keyword": "geladeira frost free",
      "page": 1,
      "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)	Conditional	URL search /termo?_q=term&map=ft in loja.electrolux.com.br. Mandatory when keyword is not sent. Categories and category filters are not supported.	-	https://loja.electrolux.com.br/geladeira?_q=geladeira&map=ft
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	Conditional	Mandatory without URL; from 1 to 200 characters, without control characters or backslash. If shipped with URL, must match the term of URL.	-	geladeira frost free
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, date or biggest_discount. In URL, accept order=OrderByScoreDESC, OrderByPriceASC, OrderByPriceDESC, OrderByReleaseDateDESC or OrderByBestDiscountDESC.	relevance	price
target Target source for extraction.	enum	Required	Use loja.electrolux.com.br.	loja.electrolux.com.br	loja.electrolux.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 from 1 to 208. Up to 12 products per page; omit to use the page in URL, or 1. Use nextPageUrl to continue.	1	1

Request examples

Keyword search

Each page consulted costs 1 credit and returns up to 12 products.

Keyword search

{
  "target": "loja.electrolux.com.br",
  "type": "plp",
  "keyword": "geladeira frost free",
  "page": 1
}

Search for URL and lowest price

page and sort sent in the payload have priority over the values of URL.

Search for URL and lowest price

{
  "target": "loja.electrolux.com.br",
  "type": "plp",
  "url": "https://loja.electrolux.com.br/geladeira?_q=geladeira&map=ft",
  "page": 2,
  "sort": "price"
}

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.url": "string",
  "data.requestUrl": "string",
  "data.extractedAt": "string",
  "data.query": "string",
  "data.sort": "string",
  "data.totalResults": "number",
  "data.totalPages": "number",
  "data.page": "number",
  "data.resultsPerPage": "number",
  "data.offset": "number",
  "data.nextPage": "number | null",
  "data.nextPageUrl": "string | null",
  "data.items[].url": "string",
  "data.items[].productId": "string",
  "data.items[].sku": "string",
  "data.items[].name": "string",
  "data.items[].available": "boolean | null",
  "data.items[].price": "number | null",
  "data.items[].regularPrice": "number | null",
  "data.items[].cashPrice": "number | null",
  "data.items[].installmentPrice": "number | null",
  "data.items[].installmentCount": "number | null",
  "data.items[].sellerId": "string | null",
  "data.items[].sellerName": "string | null",
  "data.items[].currency": "string",
  "data.items[].currencyRaw": "string",
  "data.items[].brand": "string | null",
  "data.items[].thumbnail": "string | null",
  "data.items[].aggregateRating": "null",
  "data.items[].sponsored": "boolean"
}

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": {
    "source": "loja.electrolux.com.br",
    "type": "plp",
    "url": "https://loja.electrolux.com.br/geladeira%20frost%20free?_q=geladeira%20frost%20free&map=ft&page=1",
    "requestUrl": "https://loja.electrolux.com.br/geladeira%20frost%20free?_q=geladeira%20frost%20free&map=ft&page=1",
    "extractedAt": "2026-09-30T18:03:13.245Z",
    "query": "geladeira frost free",
    "sort": "relevance",
    "totalResults": 145,
    "totalPages": 13,
    "page": 1,
    "resultsPerPage": 12,
    "offset": 0,
    "nextPage": 2,
    "nextPageUrl": "https://loja.electrolux.com.br/geladeira%20frost%20free?_q=geladeira+frost+free&map=ft&page=2",
    "items": [
      {
        "url": "https://loja.electrolux.com.br/geladeira-electrolux-frost-free-320l-duplex-branca-tf38/p?skuId=310128356",
        "productId": "2011348",
        "sku": "310128356",
        "name": "Geladeira Electrolux Frost Free 320L Duplex Branca (TF38)",
        "available": true,
        "price": 2599,
        "regularPrice": 3189,
        "cashPrice": 2599,
        "installmentPrice": 236.27,
        "installmentCount": 11,
        "sellerId": "1",
        "sellerName": "Electrolux",
        "currency": "BRL",
        "currencyRaw": "R$",
        "brand": "Electrolux",
        "thumbnail": "https://electrolux.vteximg.com.br/arquivos/ids/292138/Refrigerator_TF38_Front_Electrolux_Portuguese-1000x1000.raw.jpg?v=639102192178870000",
        "aggregateRating": null,
        "sponsored": false
      },
      {
        "url": "https://loja.electrolux.com.br/geladeira-electrolux-frost-free-320l-duplex-inox-look-tf38s/p?skuId=310128358",
        "productId": "2011349",
        "sku": "310128358",
        "name": "Geladeira Electrolux Frost Free 320L Duplex Inox Look (TF38S)",
        "available": true,
        "price": 2699,
        "regularPrice": 3389,
        "cashPrice": 2699,
        "installmentPrice": 245.36,
        "installmentCount": 11,
        "sellerId": "1",
        "sellerName": "Electrolux",
        "currency": "BRL",
        "currencyRaw": "R$",
        "brand": "Electrolux",
        "thumbnail": "https://electrolux.vteximg.com.br/arquivos/ids/292160/Refrigerator_TF38S_Front_Electrolux_Portuguese-1000x1000.raw.jpg?v=639102193677100000",
        "aggregateRating": null,
        "sponsored": false
      }
    ]
  }
}

Complete field reference

Path	Type	Description	Example
data.extractedAt	string	Date and time of extraction in ISO 8601.	2026-09-30T18:03:13.245Z
data.items[].aggregateRating	null	Aggregate evaluation; null because the catalog consulted does not provide evaluations.	null
data.items[].available	boolean \| null	Availability of the selected SKU; null when the origin does not inform.	true
data.items[].brand	string \| null	Product brand.	Electrolux
data.items[].cashPrice	number \| null	Lowest value in one installment published in the offer; does not imply discount on Pix.	2599
data.items[].currency	string	Offer currency: BRL.	BRL
data.items[].currencyRaw	string	Currency symbol: R$.	R$
data.items[].installmentCount	number \| null	Number of interest-free installments on credit cards for this option.	11
data.items[].installmentPrice	number \| null	Value of the option installment with more interest-free installments on credit cards, when available.	236.27
data.items[].name	string	Name published by source.	Geladeira Electrolux Frost Free 320L Duplex Branca (TF38)
data.items[].price	number \| null	Current price in reais; null when the offer is unavailable or unpriced.	2599
data.items[].productId	string	Product identifier in catalog Electrolux.	2011348
data.items[].regularPrice	number \| null	Reference price in reais, when informed.	3189
data.items[].sellerId	string \| null	Offer seller identifier.	1
data.items[].sellerName	string \| null	Name of the seller of the offer.	Electrolux
data.items[].sku	string	Variation identifier (SKU); Different voltages may have different SKUs.	310128356
data.items[].sponsored	boolean	false: Catalog search does not mark these results as sponsored.	false
data.items[].thumbnail	string \| null	URL from SKU main image.	https://electrolux.vteximg.com.br/arquivos/ids/292138/Refrigerator_TF38_Front_Electrolux_Portuguese-1000x1000.raw.jpg?v=639102192178870000
data.items[].url	string	URL; in the product, skuId identifies the selected variation.	https://loja.electrolux.com.br/geladeira-electrolux-frost-free-320l-duplex-branca-tf38/p?skuId=310128356
data.nextPage	number \| null	Next page, or null at the end of pagination.	2
data.nextPageUrl	string \| null	URL public next page, preserving search and sorting; null at the end.	https://loja.electrolux.com.br/geladeira%20frost%20free?_q=geladeira+frost+free&map=ft&page=2
data.offset	number	Starting position of the page in the catalog.	0
data.page	number	Page consulted, starting at 1.	1
data.query	string	Search keyword.	geladeira frost free
data.requestUrl	string	URL public normalized search, same as url.	https://loja.electrolux.com.br/geladeira%20frost%20free?_q=geladeira%20frost%20free&map=ft&page=1
data.resultsPerPage	number	Page size: up to 12 products.	12
data.sort	string	Standard ordering: relevance, price, biggest_price, date or biggest_discount.	relevance
data.source	string	Source domain.	loja.electrolux.com.br
data.totalPages	number	Number of accessible pages, limited to 208.	13
data.totalResults	number	Total informed by the catalog for the search.	145
data.type	string	Extraction type.	plp
data.url	string	URL; in the product, skuId identifies the selected variation.	https://loja.electrolux.com.br/geladeira%20frost%20free?_q=geladeira%20frost%20free&map=ft&page=1
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 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 Electrolux operations

Get product details (PDP)