GeckoAPI

https://geckoapi.com.br/docs
Admin
GeckoAPI provides APIs and automated workflows for extracting structured data from e-commerce, real...
Tokens:428,970
Snippets:1,440
Trust Score:2.7
Update:1 month ago
Show doc for...
Tokens:
Raw
### Reviews por URL - Request Example

Source: https://geckoapi.com.br/docs/mercadolivre-com-br-review

Example request body for extracting reviews from a Mercado Livre Brazil product URL. Set the 'url' to the product page and 'page' to 0 to start from the first page of reviews.

```json
{
  "url": "https://www.mercadolivre.com.br/p/MLB4997536398",
  "target": "mercadolivre.com.br",
  "type": "review",
  "page": 0
}
```

--------------------------------

### Example Response

Source: https://geckoapi.com.br/docs/chavesnamao-com-br-plp

Shows a complete example of the API response for a property listing page, including filters, locations, and items. Use this to understand the expected data structure and values.

```json
{
  "source": "chavesnamao.com.br",
  "type": "plp",
  "parser": "1.0.0",
  "url": "https://www.chavesnamao.com.br/apartamentos-a-venda/pr-curitiba/?latitude=-25.4284&longitude=-49.2733",
  "requestUrl": "https://www.chavesnamao.com.br/apartamentos-a-venda/pr-curitiba/?latitude=-25.4284&longitude=-49.2733",
  "apiUrl": "https://www.chavesnamao.com.br/api/realestate/listing/items/?viewport=desktop&level1=apartamentos-a-venda&level2=pr-curitiba&pg=1",
  "extractedAt": "2026-04-14T14:25:00.000Z",
  "title": "Apartamentos à venda em Curitiba, PR",
  "description": "Busca de apartamentos à venda em Curitiba.",
  "headingTitle": "Apartamentos à venda em Curitiba",
  "businessType": "sale",
  "page": 1,
  "totalPages": 2206,
  "totalResults": 33083,
  "primaryResults": 12,
  "nextPage": 2,
  "nextPageUrl": "https://www.chavesnamao.com.br/apartamentos-a-venda/pr-curitiba/?latitude=-25.4284&longitude=-49.2733&pg=2",
  "includeLaunches": false,
  "launchesFilteredOut": 2,
  "latitude": -25.4284,
  "longitude": -49.2733,
  "coordinateRadiusKm": 2,
  "coordinateFilteredOut": 1,
  "filters": {
    "state": "PR",
    "city": "Curitiba",
    "neighborhood": "Centro",
    "propertyTypes": [
      {
        "id": 1,
        "key": "apartamentos",
        "label": "Apartamento",
        "saleSegment": "apartamentos-a-venda",
        "rentSegment": "apartamentos-para-alugar"
      }
    ],
    "amenities": [
      {
        "id": 5,
        "key": "pool",
        "label": "Piscina"
      },
      {
        "id": 13,
        "key": "balcony",
        "label": "Varanda"
      }
    ],
    "bedrooms": 3,
    "bathrooms": 2,
    "parkingSpots": 1,
    "priceMin": 500000,
    "priceMax": 900000,
    "areaMin": 80,
    "areaMax": 180,
    "sort": "price",
    "directOwner": true,
    "condominium": false,
    "raw": {
      "realtyTypeTransaction": "sell"
    }
  },
  "locations": [
    {
      "id": 6015,
      "name": "Curitiba",
      "slug": "pr-curitiba",
      "category": "city",
      "suffixLocation": "PR"
    }
  ],
  "items": [
    {
      "position": 1,
      "id": "31728852",
      "url": "https://www.chavesnamao.com.br/imovel/apartamento-a-venda-1-quarto-pr-curitiba-cajuru-38m2-RS250000/id-31728852/",
      "title": "Apartamento com 1 quarto à venda no Cajuru, Curitiba",
      "description": "Apartamento compacto à venda em Curitiba.",
      "reference": "V021",
      "category": "residential",
      "businessType": "sale",
      "transaction": "SELL",
      "realtyType": {
        "id": 1,
        "name": "Apartamento",
        "pluralName": "Apartamentos",
        "slug": "apartamentos",
        "prefix": "deste"
      },
      "prices": {
        "main": "R$ 250.000",
        "rawPrice": 250000,
        "maxPrice": 250000,
        "condominiumFee": 0,
        "iptuValue": 0
      },
      "area": {
        "useful": 38,
        "usefulMax": 38,
        "total": 38,
        "totalMax": 38
      },
      "counts": {
        "bedrooms": {
          "count": 1,
          "max": 1
        },
        "bathrooms": {
          "count": 1,
          "max": 1
        },
        "suites": {
          "count": 0,
          "max": 0
        },
        "garages": {
          "count": 0,
          "max": 0
        },
        "commercialRooms": {
          "count": 0,
          "max": 0
        }
      },
      "address": {
        "street": "Rua Exemplo, 123",
        "neighborhood": "Cajuru",
        "city": "Curitiba",
        "state": "PR",
        "zipCode": "82900-000",
        "addressComplement": "",
        "publicAddress": false,
        "latitude": -25.4493,
        "longitude": -49.2306
      },
      "advertiser": {
        "id": "13039",
        "name": "Prime Soho",
        "url": "https://www.chavesnamao.com.br/imobiliaria/prime-soho/id-13039/",
        "type": "PJ",
        "category": 0,
        "contractDate": "2024-07-30T03:00:00.000Z",
        "creci": "J-4321",
        "stockCount": 120
      }
    }
  ]
}
```

--------------------------------

### Response Example

Source: https://geckoapi.com.br/docs/chavesnamao-com-br-plp

An example of a typical response from the PLP API, showing the structure and sample data for a property search.

```APIDOC
## Response Example

### Description
An example of a typical response from the PLP API, showing the structure and sample data for a property search.

### Response Example
```json
{
  "source": "chavesnamao.com.br",
  "type": "plp",
  "parser": "1.0.0",
  "url": "https://www.chavesnamao.com.br/apartamentos-a-venda/pr-curitiba/?latitude=-25.4284&longitude=-49.2733",
  "requestUrl": "https://www.chavesnamao.com.br/apartamentos-a-venda/pr-curitiba/?latitude=-25.4284&longitude=-49.2733",
  "apiUrl": "https://www.chavesnamao.com.br/api/realestate/listing/items/?viewport=desktop&level1=apartamentos-a-venda&level2=pr-curitiba&pg=1",
  "extractedAt": "2026-04-14T14:25:00.000Z",
  "title": "Apartamentos à venda em Curitiba, PR",
  "description": "Busca de apartamentos à venda em Curitiba.",
  "headingTitle": "Apartamentos à venda em Curitiba",
  "businessType": "sale",
  "page": 1,
  "totalPages": 2206,
  "totalResults": 33083,
  "primaryResults": 12,
  "nextPage": 2,
  "nextPageUrl": "https://www.chavesnamao.com.br/apartamentos-a-venda/pr-curitiba/?latitude=-25.4284&longitude=-49.2733&pg=2",
  "includeLaunches": false,
  "launchesFilteredOut": 2,
  "latitude": -25.4284,
  "longitude": -49.2733,
  "coordinateRadiusKm": 2,
  "coordinateFilteredOut": 1,
  "filters": {
    "state": "PR",
    "city": "Curitiba",
    "neighborhood": "Centro",
    "propertyTypes": [
      {
        "id": 1,
        "key": "apartamentos",
        "label": "Apartamento",
        "saleSegment": "apartamentos-a-venda",
        "rentSegment": "apartamentos-para-alugar"
      }
    ],
    "amenities": [
      {
        "id": 5,
        "key": "pool",
        "label": "Piscina"
      },
      {
        "id": 13,
        "key": "balcony",
        "label": "Varanda"
      }
    ],
    "bedrooms": 3,
    "bathrooms": 2,
    "parkingSpots": 1,
    "priceMin": 500000,
    "priceMax": 900000,
    "areaMin": 80,
    "areaMax": 180,
    "sort": "price",
    "directOwner": true,
    "condominium": false,
    "raw": {
      "realtyTypeTransaction": "sell"
    }
  },
  "locations": [
    {
      "id": 6015,
      "name": "Curitiba",
      "slug": "pr-curitiba",
      "category": "city",
      "suffixLocation": "PR"
    }
  ],
  "items": [
    {
      "position": 1,
      "id": "31728852",
      "url": "https://www.chavesnamao.com.br/imovel/apartamento-a-venda-1-quarto-pr-curitiba-cajuru-38m2-RS250000/id-31728852/",
      "title": "Apartamento com 1 quarto à venda no Cajuru, Curitiba",
      "description": "Apartamento compacto à venda em Curitiba.",
      "reference": "V021",
      "category": "residential",
      "businessType": "sale",
      "transaction": "SELL",
      "realtyType": {
        "id": 1,
        "name": "Apartamento",
        "pluralName": "Apartamentos",
        "slug": "apartamentos",
        "prefix": "deste"
      },
      "prices": {
        "main": "R$ 250.000",
        "rawPrice": 250000,
        "maxPrice": 250000,
        "condominiumFee": 0,
        "iptuValue": 0
      },
      "area": {
        "useful": 38,
        "usefulMax": 38,
        "total": 38,
        "totalMax": 38
      },
      "counts": {
        "bedrooms": {
          "count": 1,
          "max": 1
        },
        "bathrooms": {
          "count": 1,
          "max": 1
        },
        "suites": {
          "count": 0,
          "max": 0
        },
        "garages": {
          "count": 0,
          "max": 0
        },
        "commercialRooms": {
          "count": 0,
          "max": 0
        }
      },
      "address": {
        "street": "Rua Exemplo, 123",
        "neighborhood": "Cajuru",
        "city": "Curitiba",
        "state": "PR",
        "zipCode": "82900-000",
        "addressComplement": "",
        "publicAddress": false,
        "latitude": -25.4493,
        "longitude": -49.2306
      },
      "advertiser": {
        "id": "13039",
        "name": "Prime Soho",
        "url": "https://www.chavesnamao.com.br/imobiliaria/prime-soho/id-13039/",
        "type": "PJ",
        "category": 0,
        "contractDate": "2024-07-30T03:00:00.000Z",
        "creci": "J-4321",
        "stockCount": 120
      }
    }
  ]
}
```
```

--------------------------------

### PDP by URL Request Example

Source: https://geckoapi.com.br/docs/airbnb-com-br-pdp

Example request body for the PDP by URL endpoint. It specifies the accommodation URL, target domain 'airbnb.com.br', and type 'pdp'.

```json
{
  "url": "https://www.airbnb.com.br/rooms/1501379416546185177?adults=2&check_in=2026-02-20&check_out=2026-02-22",
  "target": "airbnb.com.br",
  "type": "pdp"
}
```

--------------------------------

### Netshoes PLP API Response Example

Source: https://geckoapi.com.br/docs/netshoes-com-br-plp

Example JSON response from the Netshoes PLP API for a product listing page. Shows request metadata, pagination info, and a product item with pricing, ratings, and availability.

```json
{
  "requestId": "req_netshoes_plp_demo",
  "executionId": "exec_netshoes_plp_demo",
  "data": {
    "source": "netshoes.com.br",
    "type": "plp",
    "url": "https://www.netshoes.com.br/busca/tenis-adidas?page=2&sort=lowest-first",
    "requestUrl": "https://www.netshoes.com.br/busca/tenis-adidas?page=2&sort=lowest-first",
    "extractedAt": "2026-04-17T12:00:00.000Z",
    "query": "tenis adidas",
    "totalResults": 2370,
    "page": 2,
    "totalPages": 24,
    "resultsPerPage": 100,
    "offset": 100,
    "nextPage": 3,
    "nextPageUrl": "https://www.netshoes.com.br/busca/tenis-adidas?page=3&sort=lowest-first",
    "items": [
      {
        "url": "https://www.netshoes.com.br/p/tenis-adidas-breaknet-FB9-9335-205",
        "sku": "FB9-9335-205",
        "productCode": "FB9-9335",
        "name": "Tênis Adidas Breaknet",
        "currency": "BRL",
        "currencyRaw": "R$",
        "price": 229.99,
        "regularPrice": 349.99,
        "discountAmount": 120,
        "discountPercent": 34,
        "installmentCount": 5,
        "sellerName": "L_NETSHOES",
        "sellerId": "L_NETSHOES",
        "brand": "Adidas",
        "department": "Casual",
        "productType": "Tênis",
        "sizes": [
          "39",
          "40",
          "41"
        ],
        "available": true,
        "aggregateRating": {
          "rating": 4.71,
          "reviewCount": 9552
        },
        "thumbnail": "https://static.netshoes.com.br/produtos/tenis-adidas-breaknet/05/FB9-9335-205/FB9-9335-205_zoom1.jpg",
        "familyParentCodes": [
          "FB9-9335-006"
        ],
        "stamps": [
          "NetsGO"
        ]
      }
    ]
  }
}
```

--------------------------------

### Example Response

Source: https://geckoapi.com.br/docs/magazineluiza-com-br-quote

Shows a complete example response from the Magazine Luiza quote API, including request metadata, product offer details, and shipping options. The response includes a delivery option and a store pickup option.

```json
{
  "requestId": "4c5e18d7-5b1d-41c0-9b9a-f9ab45d42c8b",
  "executionId": "a4360f20-c423-4c21-8fc8-8c9b72158498",
  "data": {
    "source": "magazineluiza.com.br",
    "type": "quote",
    "parser": "1.0.0",
    "url": "https://www.magazineluiza.com.br/apple-iphone-15-128gb-azul-61-48mp-ios-5g/p/238034800/te/ip15/",
    "requestUrl": "https://www.magazineluiza.com.br/apple-iphone-15-128gb-azul-61-48mp-ios-5g/p/238034800/te/ip15/",
    "extractedAt": "2026-06-03T00:00:00.000Z",
    "sku": "238034800",
    "zipCode": "01001000",
    "responseZipCode": "01001000",
    "sellerId": "magazineluiza",
    "sellerName": "Magalu",
    "offerAvailable": true,
    "offerPrice": 3999,
    "offerRegularPrice": 4599,
    "currency": "BRL",
    "shippingId": "ship-1",
    "disclaimers": [
      "Os prazos contam apos a confirmacao do pagamento."
    ],
    "totalOptions": 2,
    "options": [
      {
        "name": "Entrega padrao",
        "id": "conventional",
        "type": "conventional",
        "priceText": "0.00",
        "price": 0,
        "currency": "BRL",
        "deadlineText": "Receba ate segunda-feira",
        "deadlineDays": 3,
        "deliveryDate": "2026-06-08",
        "available": true,
        "message": "Para pagamentos confirmados hoje",
        "iconUrl": "https://a-static.mlcdn.com.br/icon.png",
        "distributionCenter": 1
      },
      {
        "name": "Retira Loja",
        "id": "store_pickup",
        "type": "store_pickup",
        "priceText": "0.00",
        "price": 0,
        "currency": "BRL",
        "deadlineText": "Retire a partir de hoje",
        "deadlineDays": 0,
        "deliveryDate": "2026-06-03",
        "available": true,
        "message": "Os prazos contam apos a confirmacao do pagamento.",
        "iconUrl": "https://a-static.mlcdn.com.br/pickup.png",
        "distributionCenter": 2
      }
    ]
  }
}
```

--------------------------------

### Amazon.com.br PDP API Response Example

Source: https://geckoapi.com.br/docs/amazon-com-br-pdp

Example JSON response from the Amazon.com.br product detail page API. Contains product information including price, availability, seller details, and ratings. Useful for understanding the structure of the API response.

```json
{
  "requestId": "44444444-1111-4111-8111-444444444444",
  "executionId": "44444444-2222-4222-8222-444444444444",
  "data": {
    "isInternational": false,
    "variants": [
      {
        "asin": "B09B8QFYZ2",
        "url": "https://www.amazon.com.br/dp/B09B8QFYZ2"
      }
    ],
    "shippingFee": {
      "shippingFee": "R$ 12,90",
      "zipCode": "80000-000"
    },
    "taxFreePrice": 359,
    "cashPrice": 359,
    "canonicalUrl": "https://www.amazon.com.br/dp/B09B8QFYZ2",
    "price": 379,
    "additionalProperties": [
      {
        "name": "Marca",
        "value": "Amazon"
      }
    ],
    "regularPrice": 429,
    "sellerName": "Amazon.com.br",
    "itemCondition": "new",
    "images": [
      {
        "url": "https://m.media-amazon.com/images/I/echo-dot-main.jpg"
      }
    ],
    "brand": {
      "name": "Amazon"
    },
    "aggregateRating": {
      "ratingValue": 4.8,
      "bestRating": 5,
      "reviewCount": 10234
    },
    "currency": "BRL",
    "currencyRaw": "R$",
    "breadcrumbs": [
      {
        "name": "Eletronicos",
        "url": "https://www.amazon.com.br/eletronicos"
      }
    ],
    "description": "Smart speaker com Alexa integrada.",
    "mainImage": {
      "url": "https://m.media-amazon.com/images/I/echo-dot-main.jpg"
    },
    "sku": "B09B8QFYZ2",
    "availability": "InStock",
    "name": "Echo Dot 4a geracao",
    "url": "https://www.amazon.com.br/dp/B09B8QFYZ2",
    "otherSellers": [
      {
        "sellerName": "Loja Parceira Prime",
        "price": 389,
        "sellerUrl": "https://www.amazon.com.br/sp?seller=A1SELLER123",
        "sellerId": "A1SELLER123"
      }
    ],
    "sellerId": "A1AMAZONBR",
    "sellerUrl": "https://www.amazon.com.br/sp?seller=A1AMAZONBR",
    "coupon": "R$20 off",
    "couponCode": "COMPRANOAPP",
    "couponDescription": "Insira o codigo COMPRANOAPP na finalizacao da compra. Valido na sua primeira compra na Amazon, pelo App",
    "installmentPrice": "31.58",
    "installmentCount": 12,
    "mpn": "ECHODOT4",
    "size": "Padrao",
    "color": "Azul",
    "style": "Com relogio",
    "sellerSocialReason": "Amazon Servicos de Varejo do Brasil Ltda",
    "sellerCnpj": "15.436.940/0001-03",
    "sellerAddress": "Av. Juscelino Kubitschek, 2041",
    "sellerCity": "Sao Paulo",
    "sellerState": "SP",
    "sellerCountry": "Brasil"
  }
}
```

--------------------------------

### Exemplo de response (responseExample)

Source: https://geckoapi.com.br/docs/portalzuk-com-br-plp

Exemplo completo de response da API PLP do Portal Zuk, com um item de leilão de apartamento. Inclui dados de consulta, paginação, endereço, áreas, rodadas de leilão e metadados do imóvel.

```json
{
  "source": "portalzuk.com.br",
  "type": "plp",
  "parser": "1.0.0",
  "url": "https://www.portalzuk.com.br/leilao-de-imoveis/u/residenciais/sp?order=menor_valor",
  "requestUrl": "https://www.portalzuk.com.br/leilao-de-imoveis/u/residenciais/sp?order=menor_valor",
  "extractedAt": "2026-07-15T12:00:00.000Z",
  "query": {
    "keyword": "",
    "state": "SP",
    "city": "",
    "neighborhood": "",
    "region": "",
    "propertyType": "residential",
    "seller": "",
    "occupancy": "all",
    "auctionType": "all",
    "minDiscountPercent": 0,
    "installments": false,
    "bedroomsMin": 0,
    "parkingSpotsMin": 0,
    "priceMin": 0,
    "priceMax": 500000,
    "areaMin": 0,
    "areaMax": 300,
    "sort": "lowest_price"
  },
  "page": 1,
  "pageSize": 30,
  "totalResults": 241,
  "returnedResults": 30,
  "nextPage": 2,
  "items": [
    {
      "position": 1,
      "auctionId": 36801,
      "lotId": 229571,
      "propertyType": "Apartamento",
      "title": "Apartamento à venda em leilão",
      "url": "https://www.portalzuk.com.br/imovel/sp/araraquara/solidariedade/avenida-marginal-do-corrego-dos-martins-445/36801-229571",
      "imageUrl": "https://static.portalzuk.com.br/imovel/listagem/229571.jpg",
      "partner": "Portal Zuk",
      "address": {
        "street": "Avenida Marginal do Córrego dos Martins, 445",
        "neighborhood": "Solidariedade",
        "city": "Araraquara",
        "state": "SP",
        "formatted": "Avenida Marginal do Córrego dos Martins, 445, Solidariedade, Araraquara, SP",
        "latitude": -21.7845,
        "longitude": -48.178,
        "coordinatePrecision": "APPROXIMATE"
      },
      "areas": [
        {
          "label": "Área útil",
          "valueM2": 48.2
        }
      ],
      "auctionRounds": [
        {
          "label": "1º Leilão",
          "price": 28609.55,
          "date": "2026-07-22T14:00:00.000Z",
          "dateLabel": "22/07/2026 às 14h",
          "discountPercent": 42,
          "ended": false
        }
      ],
      "currentPrice": 28609.55,
      "metadata": {
        "residential": true,
        "commercial": false,
        "rural": false,
        "land": false,
        "houseOrApartment": true,
        "discountPercent": 42,
        "installmentCount": 12,
        "listedValue": 28609.55,
        "maxAreaM2": 48.2,
        "usableAreaM2": 48.2,
        "privateAreaM2": 48.2,
        "builtAreaM2": 48.2,
        "landAreaM2": 48.2,
        "totalAreaM2": 48.2,
        "bathrooms": 1,
        "parkingSpots": 1,
        "bedrooms": 2,
        "occupied": false,
        "judicial": true,
        "acceptingProposal": false,
        "fiduciary": false,
        "sellerSlug": "caixa-economica-federal"
      }
    }
  ]
}
```

--------------------------------

### POST /v1/mcp (tools/call: airbnb_com_br_pdp)

Source: https://geckoapi.com.br/docs/airbnb-com-br-pdp

Chama a tool MCP dedicada `airbnb_com_br_pdp` para extrair dados de uma página de acomodação do Airbnb. Os parâmetros `target` e `type` são fixos na tool.

```APIDOC
## [POST] /v1/mcp

### Description
Chama a tool MCP dedicada `airbnb_com_br_pdp` para extrair dados de uma página de acomodação do Airbnb. Os parâmetros `target` e `type` são fixos na tool.

### Method
POST

### Endpoint
/v1/mcp

### Parameters
#### Path Parameters
- Nenhum parâmetro de caminho.

#### Query Parameters
- Nenhum parâmetro de consulta.

#### Request Body
- **jsonrpc** (string) - Obrigatório - Versão do protocolo JSON-RPC (ex: "2.0").
- **id** (integer) - Obrigatório - Identificador da requisição.
- **method** (string) - Obrigatório - Deve ser "tools/call".
- **params** (object) - Obrigatório - Parâmetros da chamada.
  - **name** (string) - Obrigatório - Nome da tool: "airbnb_com_br_pdp".
  - **arguments** (object) - Obrigatório - Argumentos da tool.
    - **url** (string, URL) - Obrigatório - URL da acomodação Airbnb.
    - **executionId** (string) - Opcional - Identificador de execução.

### Request Example
{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "airbnb_com_br_pdp",
    "arguments": {
      "url": "https://www.airbnb.com.br/rooms/1501379416546185177?adults=2&check_in=2026-02-20&check_out=2026-02-22",
      "executionId": "exec_example_123"
    }
  }
}

### Response
#### Success Response (200)
- **data** (object|null) - Dados extraídos da página. Pode ser `null` se a entidade não existir.
- **notFound** (boolean) - Indica se a entidade não foi encontrada. `true` quando `data` é `null`.

#### Response Example
{
  "data": null,
  "notFound": true
}
```

--------------------------------

### Example Response

Source: https://geckoapi.com.br/docs/casasbahia-com-br-plp

Shows a complete response for a search query. The response includes pagination details and an array of product items with ratings and sponsorship flags.

```json
{
  "requestId": "d68564d2-34bc-47e6-a1a6-796794f8463b",
  "executionId": "f7b0f7f6-3363-4958-9f7e-6c0e0d189874",
  "data": {
    "source": "casasbahia.com.br",
    "type": "plp",
    "url": "https://www.casasbahia.com.br/resultado-da-busca/?query=iphone+16&page=1",
    "requestUrl": "https://www.casasbahia.com.br/resultado-da-busca/?query=iphone+16&page=1",
    "extractedAt": "2026-04-18T00:00:00.000Z",
    "query": "iphone 16",
    "totalResults": 25,
    "totalPages": 3,
    "page": 1,
    "resultsPerPage": 10,
    "offset": 0,
    "nextPage": 2,
    "nextPageUrl": "https://www.casasbahia.com.br/resultado-da-busca/?query=iphone+16&page=2",
    "items": [
      {
        "url": "https://www.casasbahia.com.br/apple-iphone-16-128gb-61-48mp-preto/p/55067621",
        "productId": "80872678",
        "sku": "55067621",
        "name": "Apple iPhone 16 128GB 6,1 48MP Preto",
        "available": true,
        "sellerId": "228278",
        "brand": "Apple",
        "thumbnail": "https://imgs.casasbahia.com.br/55067621/1xg.jpg",
        "aggregateRating": {
          "rating": 4.9,
          "reviewCount": 128
        },
        "sponsored": true
      }
    ]
  }
}
```

--------------------------------

### tools/list

Source: https://geckoapi.com.br/docs/mcp

JSON-RPC method to list available tools for the authenticated account. Returns only enabled tools, with credit cost in each tool's description.

```APIDOC
## tools/list

### Description
Lists available MCP tools for the authenticated account. Returns only enabled tools, with credit cost in each tool's description.

### Method
tools/list (JSON-RPC)

### Parameters
#### Request Body
- **params** (object) - Required - Empty object `{}`

### Request Example
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list",
  "params": {}
}

### Response
#### Success Response (200)
- **content** (array) - List of content items
- **structuredContent** (object) - Structured response data

#### Response Example
{
  "content": [
    {
      "type": "text",
      "text": "{\"requestId\":\"req_123\",\"executionId\":\"exec_example_123\",\"data\":{\"title\":\"Produto exemplo\",\"price\":199.9}}"
    }
  ],
  "structuredContent": {
    "requestId": "req_123",
    "executionId": "exec_example_123",
    "data": {
      "title": "Produto exemplo",
      "price": 199.9
    }
  }
}
```

--------------------------------

### 123milhas PLP Response Example

Source: https://geckoapi.com.br/docs/123milhas-com-plp

Example JSON response from the 123milhas.com PLP endpoint, showing a round-trip flight search result with outbound and inbound segments, pricing, and itinerary details.

```json
{
  "requestId": "99999999-1111-4111-8111-999999999999",
  "executionId": "99999999-2222-4222-8222-999999999999",
  "data": {
    "source": "123milhas.com",
    "type": "plp",
    "parser": "1.0.0",
    "url": "https://123milhas.com/v2/busca?de=GRU&para=SSA&ida=2026-06-15&volta=2026-06-20&adultos=1&criancas=0&bebes=0&classe=3",
    "requestUrl": "https://123milhas.com/v2/busca?de=GRU&para=SSA&ida=2026-06-15&volta=2026-06-20&adultos=1&criancas=0&bebes=0&classe=3",
    "authUrl": "https://123milhas.com/api/v3/client/auth",
    "searchPageUrl": "https://123milhas.com/v2/busca?de=GRU&para=SSA&ida=2026-06-15&volta=2026-06-20&adultos=1&criancas=0&bebes=0&classe=3",
    "extractedAt": "2026-05-16T20:00:00.000Z",
    "searchType": "ROUND_TRIP",
    "from": "GRU",
    "to": "SSA",
    "departureDate": "2026-06-15",
    "returnDate": "2026-06-20",
    "numAdults": 1,
    "numChildren": 0,
    "numInfants": 0,
    "classService": 3,
    "searchId": 2252111877,
    "allowPix": true,
    "allowBillet": false,
    "success": true,
    "totalFlights": 122,
    "totalGroups": 38,
    "listedOffers": 2,
    "cheapestOffer": {
      "position": 1,
      "groupId": 103,
      "totalPrice": 820.36,
      "basePrice": 729,
      "emission": 5,
      "partner": false,
      "source": "123MILHAS",
      "outboundOptions": 1,
      "inboundOptions": 1,
      "outbound": {
        "id": "outbound-103-1",
        "airline": "G3",
        "flightNumber": "G3 1234 / G3 1236",
        "route": "GRU-GIG-SSA",
        "departureTime": "2026-06-15T08:20:00",
        "arrivalTime": "2026-06-15T10:40:00",
        "durationText": "2h20m",
        "stops": 1,
        "stopsText": "1 parada",
        "ourPrice": 390.18,
        "totalPrice": 410.18,
        "airlinePrice": 360,
        "tax": 50.18,
        "luggageQuantity": 0,
        "segments": [
          {
            "position": 1,
            "id": "segment-103-out-1",
            "airline": "G3",
            "operatingAirline": "GOL",
            "flightNumber": "G3 1234",
            "origin": "GRU",
            "destination": "GIG",
            "departure": "2026-06-15T08:20:00",
            "arrival": "2026-06-15T09:15:00",
            "durationText": "00:55",
            "cabin": "ECONOMIC",
            "technicalStops": 0
          },
          {
            "position": 2,
            "id": "segment-103-out-2",
            "airline": "G3",
            "operatingAirline": "GOL",
            "flightNumber": "G3 1236",
            "origin": "GIG",
            "destination": "SSA",
            "departure": "2026-06-15T09:45:00",
            "arrival": "2026-06-15T10:40:00",
            "durationText": "00:55",
            "cabin": "ECONOMIC",
            "technicalStops": 0
          }
        ]
      },
      "inbound": {
        "id": "inbound-103-1",
        "airline": "G3",
        "flightNumber": "G3 4321",
        "route": "SSA-GRU",
        "departureTime": "2026-06-20T18:10:00",
        "arrivalTime": "2026-06-20T20:35:00",
        "durationText": "2h25m",
        "stops": 0,
        "stopsText": "Direto",
        "ourPrice": 380.18,
        "totalPrice": 410.18,
        "airlinePrice": 360,
        "tax": 50.18,
        "luggageQuantity": 0,
        "segments": [
          {
            "position": 1,
            "id": "segment-103-in-1",
            "airline": "G3",
            "operatingAirline": "GOL",
            "flightNumber": "G3 4321",
            "origin": "SSA",
            "destination": "GRU",
            "departure": "2026-06-20T18:10:00",
            "arrival": "2026-06-20T20:35:00",
            "durationText": "2h25m",
            "cabin": "ECONOMIC",
            "technicalStops": 0
          }
        ]
      },
      "outboundItineraries": [
        {
          "position": 1,
          "id": "outbound-103-1",
          "airline": "G3",
          "flightNumber": "G3 1234 / G3 1236",
          "route": "GRU-GIG-SSA",
          "departureTime": "2026-06-15T08:20:00",
          "arrivalTime": "2026-06-15T10:40:00",
          "durationText": "2h20m",
          "stops": 1,
          "stopsText": "1 parada",
          "ourPrice": 390.18,
          "totalPrice": 410.18,
          "airlinePrice": 360,
          "tax": 50.18,
          "luggageQuantity": 0,
          "segments": [
            {
              "position": 1,
              "id": "segment-103-out-1",
              "airline": "G3",
              "operatingAirline": "GOL",
              "flightNumber": "G3 1234",
              "origin": "GRU",
              "destination": "GIG",
              "departure": "2026-06-15T08:20:00",
              "arrival": "2026-06-15T09:15:00",
              "durationText": "00:55",
              "cabin": "ECONOMIC",
              "technicalStops": 0
            },
            {
              "position": 2,
              "id": "segment-103-out-2",
              "airline": "G3",
              "operatingAirline": "GOL",
              "flightNumber": "G3 1236",
              "origin": "GIG",
              "destination": "SSA",
              "departure": "2026-06-15T09:45:00",
              "arrival": "2026-06-15T10:40:00",
              "durationText": "00:55",
              "cabin": "ECONOMIC",
              "technicalStops": 0
            }
          ]
        }
      ]
    }
  }
}
```

--------------------------------

### PDP by URL - Request Example

Source: https://geckoapi.com.br/docs/zapimoveis-com-br-pdp

Example request body for extracting a Zapimoveis property detail page (PDP) by providing the public URL. The target must be 'zapimoveis.com.br' and type must be 'pdp'.

```json
{
  "target": "zapimoveis.com.br",
  "type": "pdp",
  "url": "https://www.zapimoveis.com.br/imovel/aluguel-apartamento-4-quartos-com-piscina-agua-verde-curitiba-pr-158m2-id-2795564422/"
}
```

--------------------------------

### JSON-RPC tools/list request

Source: https://geckoapi.com.br/docs/mcp

List available tools for the authenticated account. Returns only enabled tools; cost in credits appears in each tool's description.

```json
{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/list",
  "params": {}
}
```

--------------------------------

### PDP by URL request example

Source: https://geckoapi.com.br/docs/webmotors-com-br-pdp

Example request payload for the POST /v1/extract endpoint to extract a Webmotors PDP. The url field is required for this seam, target must be 'webmotors.com.br', and type must be 'pdp'.

```json
{
  "url": "https://www.webmotors.com.br/comprar/chevrolet/tracker/1-2-turbo-flex-premier-automatico/4-portas/2024/65274301",
  "target": "webmotors.com.br",
  "type": "pdp"
}
```
Tokens:
Raw