GeckoAPI
Agendar uma demo

// docs

iFood PDP (Merchant)

Extrai dados completos de uma loja do iFood combinando informacoes de merchant e cardapio.

Nota importante: alguns campos podem retornar null em produção, dependendo da página de origem. Nesta documentação, os exemplos de output são preenchidos intencionalmente com valores não nulos para facilitar integração.

Chamada HTTP

cURL 
curl -X POST https://api.geckoapi.com.br/v1/extract \
  -H "Authorization: Bearer SUA_CHAVE" \
  -H "Content-Type: application/json" \
  -d '{
  "target": "ifood.com.br",
  "type": "pdp",
  "url": "https://www.ifood.com.br/delivery/curitiba-pr/estacao-rodo-lanches-e-pizzas-jardim-botanico/540f008a-104f-44aa-bd92-7892626f8312"
}'

Possibilidades de input

Campos suportados nesta API do POST /v1/extract, com regras específicas de obrigatoriedade e condicionais.

Campo Tipo Status Regra Default Exemplo
url
URL alvo da extração. Para alguns PLPs pode ser omitida quando a API monta a URL a partir de outros campos.
 string (URL) Obrigatório URL da loja no ifood.com.br com merchantId no path. - https://www.mercadolivre.com.br/p/MLB123456
target
Fonte alvo da extração.
 enum Obrigatório Sempre obrigatorio no payload e deve ser ifood.com.br. - mercadolivre.com.br
type
Tipo da extração: pdp, plp, review ou places.
 enum Obrigatório Sempre obrigatorio no payload e deve ser pdp. - pdp

Exemplos de request

Merchant por URL

Informe a URL publica da loja no iFood. O worker extrai o merchantId da URL e consulta menu + merchant-info.

Merchant por URL 
{
  "target": "ifood.com.br",
  "type": "pdp",
  "url": "https://www.ifood.com.br/delivery/curitiba-pr/estacao-rodo-lanches-e-pizzas-jardim-botanico/540f008a-104f-44aa-bd92-7892626f8312"
}

Schema de response (leaf paths)

Mapa de paths de saída com tipo esperado para esta API.

responseSchema 
{
  "requestId": "string (uuid)",
  "executionId": "string (uuid)",
  "data.source": "string",
  "data.type": "string",
  "data.url": "string",
  "data.requestUrl": "string",
  "data.catalogRequestUrl": "string",
  "data.merchantInfoRequestUrl": "string",
  "data.extractedAt": "string (iso datetime)",
  "data.data.url": "string",
  "data.data.merchantId": "string",
  "data.data.name": "string",
  "data.data.slug": "string",
  "data.data.description": "string",
  "data.data.type": "string",
  "data.data.enabled": "boolean",
  "data.data.available": "boolean",
  "data.data.availableForScheduling": "boolean",
  "data.data.currency": "string",
  "data.data.userRating": "number",
  "data.data.userRatingCount": "number",
  "data.data.priceRange": "string",
  "data.data.distanceKm": "number",
  "data.data.minimumOrderValue": "number",
  "data.data.deliveryTimeMinutes": "number",
  "data.data.preparationTimeMinutes": "number",
  "data.data.mainCategory.code": "string",
  "data.data.mainCategory.name": "string",
  "data.data.categories[].code": "string",
  "data.data.categories[].friendlyName": "string",
  "data.data.address.city": "string",
  "data.data.address.state": "string",
  "data.data.address.zipCode": "string",
  "data.data.address.latitude": "number",
  "data.data.address.longitude": "number",
  "data.data.phone": "string",
  "data.data.cnpj": "string",
  "data.data.mcc": "string",
  "data.data.paymentCodes[]": "string",
  "data.data.features[]": "string",
  "data.data.tags[]": "string",
  "data.data.resources[].type": "string",
  "data.data.resources[].url": "string",
  "data.data.mainImage.type": "string",
  "data.data.mainImage.url": "string",
  "data.data.deliveryFee.type": "string",
  "data.data.deliveryFee.value": "number",
  "data.data.deliveryMethods[].id": "string",
  "data.data.deliveryMethods[].mode": "string",
  "data.data.deliveryMethods[].minTimeMinutes": "number",
  "data.data.deliveryMethods[].maxTimeMinutes": "number",
  "data.data.deliveryMethods[].nextSlotStartTime": "string",
  "data.data.deliveryMethods[].nextSlotEndTime": "string",
  "data.data.shifts[].dayOfWeek": "number",
  "data.data.shifts[].startTime": "string",
  "data.data.menuSectionCount": "number",
  "data.data.menuItemCount": "number",
  "data.data.menu[].code": "string",
  "data.data.menu[].name": "string",
  "data.data.menu[].items[].id": "string",
  "data.data.menu[].items[].name": "string",
  "data.data.menu[].items[].description": "string",
  "data.data.menu[].items[].image": "string",
  "data.data.menu[].items[].needChoices": "boolean",
  "data.data.menu[].items[].enabled": "boolean",
  "data.data.menu[].items[].availability": "string",
  "data.data.menu[].items[].price": "number",
  "data.data.menu[].items[].originalPrice": "number",
  "data.data.menu[].items[].tags[]": "string",
  "data.data.menu[].items[].portionTags[]": "string"
}

Exemplo de response

responseExample 
{
  "requestId": "66666666-1111-4111-8111-666666666666",
  "executionId": "66666666-2222-4222-8222-666666666666",
  "data": {
    "source": "ifood.com.br",
    "type": "pdp",
    "url": "https://www.ifood.com.br/delivery/curitiba-pr/estacao-rodo-lanches-e-pizzas-jardim-botanico/540f008a-104f-44aa-bd92-7892626f8312",
    "requestUrl": "https://www.ifood.com.br/delivery/curitiba-pr/estacao-rodo-lanches-e-pizzas-jardim-botanico/540f008a-104f-44aa-bd92-7892626f8312",
    "catalogRequestUrl": "https://cw-marketplace.ifood.com.br/v1/merchants/restaurant/540f008a-104f-44aa-bd92-7892626f8312/catalog",
    "merchantInfoRequestUrl": "https://cw-marketplace.ifood.com.br/v1/merchant-info/graphql?latitude=&longitude=&channel=IFOOD",
    "extractedAt": "2026-02-19T00:30:00.000Z",
    "data": {
      "url": "https://www.ifood.com.br/delivery/curitiba-pr/estacao-rodo-lanches-e-pizzas-jardim-botanico/540f008a-104f-44aa-bd92-7892626f8312",
      "merchantId": "540f008a-104f-44aa-bd92-7892626f8312",
      "name": "Estacao Rodo Lanches e Pizzas",
      "slug": "curitiba-pr/estacao-rodo-lanches-e-pizzas-jardim-botanico",
      "description": "Lanches, marmita, pizza e bebidas.",
      "type": "RESTAURANT",
      "enabled": true,
      "available": true,
      "availableForScheduling": false,
      "currency": "BRL",
      "userRating": 4.8,
      "userRatingCount": 1006,
      "priceRange": "CHEAPEST",
      "distanceKm": 2.07,
      "minimumOrderValue": 20,
      "deliveryTimeMinutes": 63,
      "preparationTimeMinutes": 9,
      "takeoutTimeMinutes": 15,
      "mainCategory": {
        "code": "MA1",
        "name": "Marmita",
        "description": "Marmita",
        "friendlyName": "Marmita"
      },
      "categories": [
        {
          "code": "MA1",
          "description": "Marmita",
          "friendlyName": "Marmita"
        }
      ],
      "address": {
        "streetName": "AV PRESIDENTE AFFONSO CAMARGO",
        "streetNumber": "330",
        "district": "JARDIM BOTANICO",
        "city": "CURITIBA",
        "state": "PR",
        "country": "BR",
        "zipCode": "80060090",
        "timezone": "Etc/GMT+3",
        "latitude": -25.43666,
        "longitude": -49.256742
      },
      "phone": "992285958",
      "cnpj": "30853473000100",
      "mcc": "5814",
      "paymentCodes": [
        "PIX",
        "VIS"
      ],
      "features": [
        "DELIVERY",
        "TRACKING"
      ],
      "tags": [
        "SUPER_RESTAURANT"
      ],
      "resources": [
        {
          "type": "COVER",
          "fileName": "540f008a-104f-44aa-bd92-7892626f8312/202505171215_aQvC_c.png",
          "url": "https://static-images.ifood.com.br/image/upload/540f008a-104f-44aa-bd92-7892626f8312/202505171215_aQvC_c.png"
        }
      ],
      "mainImage": {
        "type": "COVER",
        "fileName": "540f008a-104f-44aa-bd92-7892626f8312/202505171215_aQvC_c.png",
        "url": "https://static-images.ifood.com.br/image/upload/540f008a-104f-44aa-bd92-7892626f8312/202505171215_aQvC_c.png"
      },
      "image": [
        {
          "type": "COVER",
          "fileName": "540f008a-104f-44aa-bd92-7892626f8312/202505171215_aQvC_c.png",
          "url": "https://static-images.ifood.com.br/image/upload/540f008a-104f-44aa-bd92-7892626f8312/202505171215_aQvC_c.png"
        }
      ],
      "deliveryFee": {
        "type": "FIXED",
        "value": 10.99,
        "originalValue": 10.99
      },
      "deliveryMethods": [
        {
          "id": "DEFAULT",
          "title": "Padrao",
          "subtitle": "O entregador leva ate voce agora",
          "mode": "DELIVERY",
          "type": "FIXED",
          "state": "ELIGIBLE",
          "deliveredBy": "IFOOD",
          "priority": 1000,
          "minTimeMinutes": 63,
          "maxTimeMinutes": 73,
          "value": 10.99,
          "originalValue": 10.99,
          "scheduleNow": true,
          "nextSlotStartTime": "22:30",
          "nextSlotEndTime": "23:00",
          "nextSlotStartDateTime": 1771464600000,
          "nextSlotEndDateTime": 1771466400000
        }
      ],
      "shifts": [
        {
          "dayOfWeek": 1,
          "durationMinutes": 240,
          "startTime": "11:00"
        }
      ],
      "menuSectionCount": 1,
      "menuItemCount": 1,
      "menu": [
        {
          "code": "15359dea-aead-422b-869b-433473f21fe7",
          "name": "Os Mais Pedidos!!!",
          "items": [
            {
              "id": "ddaeacea-83bd-4322-871c-05fe7b96daec",
              "code": "ddaeacea-83bd-4322-871c-05fe7b96daec",
              "externalCode": "item-123",
              "name": "Cachorro Quente Duplex",
              "description": "Pao de cachorro quente, 2 salsichas e adicionais.",
              "image": "https://static-images.ifood.com.br/image/upload/540f008a-104f-44aa-bd92-7892626f8312/202505311449_66H4_i.jpg",
              "needChoices": true,
              "enabled": true,
              "availability": "AVAILABLE",
              "type": "ITEM",
              "ean": "7891234567890",
              "price": 15.6,
              "minPrice": 15.6,
              "originalPrice": 30,
              "promotionalPrice": 15.6,
              "minimumPromotionalPrice": 15.6,
              "sellingOption": {
                "minimum": 0,
                "incremental": 0,
                "availableUnits": [
                  "UNIT"
                ]
              },
              "tags": [
                "IFOOD_INDICA_V0"
              ],
              "portionTags": [
                "SERVES_1"
              ]
            }
          ]
        }
      ]
    }
  }
}

Referência completa de campos

Path Tipo Descrição Exemplo
data.catalogRequestUrl string Campo data.catalogRequestUrl retornado no payload de resposta. https://cw-marketplace.ifood.com.br/v1/merchants/restaurant/540f008a-104f-44aa-bd92-7892626f8312/catalog
data.data.address.city string Campo data.data.address.city retornado no payload de resposta. CURITIBA
data.data.address.latitude number Campo data.data.address.latitude retornado no payload de resposta. -25.43666
data.data.address.longitude number Campo data.data.address.longitude retornado no payload de resposta. -49.256742
data.data.address.state string Campo data.data.address.state retornado no payload de resposta. PR
data.data.address.zipCode string Campo data.data.address.zipCode retornado no payload de resposta. 80060090
data.data.available boolean Campo data.data.available retornado no payload de resposta. true
data.data.availableForScheduling boolean Campo data.data.availableForScheduling retornado no payload de resposta. false
data.data.categories[].code string Campo data.data.categories[].code retornado no payload de resposta. MA1
data.data.categories[].friendlyName string Campo data.data.categories[].friendlyName retornado no payload de resposta. Marmita
data.data.cnpj string Campo data.data.cnpj retornado no payload de resposta. 30853473000100
data.data.currency string Campo data.data.currency retornado no payload de resposta. BRL
data.data.deliveryFee.type string Campo data.data.deliveryFee.type retornado no payload de resposta. FIXED
data.data.deliveryFee.value number Campo data.data.deliveryFee.value retornado no payload de resposta. 10.99
data.data.deliveryMethods[].id string Campo data.data.deliveryMethods[].id retornado no payload de resposta. DEFAULT
data.data.deliveryMethods[].maxTimeMinutes number Campo data.data.deliveryMethods[].maxTimeMinutes retornado no payload de resposta. 73
data.data.deliveryMethods[].minTimeMinutes number Campo data.data.deliveryMethods[].minTimeMinutes retornado no payload de resposta. 63
data.data.deliveryMethods[].mode string Campo data.data.deliveryMethods[].mode retornado no payload de resposta. DELIVERY
data.data.deliveryMethods[].nextSlotEndTime string Campo data.data.deliveryMethods[].nextSlotEndTime retornado no payload de resposta. 23:00
data.data.deliveryMethods[].nextSlotStartTime string Campo data.data.deliveryMethods[].nextSlotStartTime retornado no payload de resposta. 22:30
data.data.deliveryTimeMinutes number Campo data.data.deliveryTimeMinutes retornado no payload de resposta. 63
data.data.description string Campo data.data.description retornado no payload de resposta. Lanches, marmita, pizza e bebidas.
data.data.distanceKm number Campo data.data.distanceKm retornado no payload de resposta. 2.07
data.data.enabled boolean Campo data.data.enabled retornado no payload de resposta. true
data.data.features[] string Campo data.data.features[] retornado no payload de resposta. DELIVERY
data.data.mainCategory.code string Campo data.data.mainCategory.code retornado no payload de resposta. MA1
data.data.mainCategory.name string Campo data.data.mainCategory.name retornado no payload de resposta. Marmita
data.data.mainImage.type string Campo data.data.mainImage.type retornado no payload de resposta. COVER
data.data.mainImage.url string Campo data.data.mainImage.url retornado no payload de resposta. https://static-images.ifood.com.br/image/upload/540f008a-104f-44aa-bd92-7892626f8312/202505171215_aQvC_c.png
data.data.mcc string Campo data.data.mcc retornado no payload de resposta. 5814
data.data.menu[].code string Campo data.data.menu[].code retornado no payload de resposta. 15359dea-aead-422b-869b-433473f21fe7
data.data.menu[].items[].availability string Campo data.data.menu[].items[].availability retornado no payload de resposta. AVAILABLE
data.data.menu[].items[].description string Campo data.data.menu[].items[].description retornado no payload de resposta. Pao de cachorro quente, 2 salsichas e adicionais.
data.data.menu[].items[].enabled boolean Campo data.data.menu[].items[].enabled retornado no payload de resposta. true
data.data.menu[].items[].id string Campo data.data.menu[].items[].id retornado no payload de resposta. ddaeacea-83bd-4322-871c-05fe7b96daec
data.data.menu[].items[].image string Campo data.data.menu[].items[].image retornado no payload de resposta. https://static-images.ifood.com.br/image/upload/540f008a-104f-44aa-bd92-7892626f8312/202505311449_66H4_i.jpg
data.data.menu[].items[].name string Campo data.data.menu[].items[].name retornado no payload de resposta. Cachorro Quente Duplex
data.data.menu[].items[].needChoices boolean Campo data.data.menu[].items[].needChoices retornado no payload de resposta. true
data.data.menu[].items[].originalPrice number Campo data.data.menu[].items[].originalPrice retornado no payload de resposta. 30
data.data.menu[].items[].portionTags[] string Campo data.data.menu[].items[].portionTags[] retornado no payload de resposta. SERVES_1
data.data.menu[].items[].price number Campo data.data.menu[].items[].price retornado no payload de resposta. 15.6
data.data.menu[].items[].tags[] string Campo data.data.menu[].items[].tags[] retornado no payload de resposta. IFOOD_INDICA_V0
data.data.menu[].name string Campo data.data.menu[].name retornado no payload de resposta. Os Mais Pedidos!!!
data.data.menuItemCount number Campo data.data.menuItemCount retornado no payload de resposta. 1
data.data.menuSectionCount number Campo data.data.menuSectionCount retornado no payload de resposta. 1
data.data.merchantId string Campo data.data.merchantId retornado no payload de resposta. 540f008a-104f-44aa-bd92-7892626f8312
data.data.minimumOrderValue number Campo data.data.minimumOrderValue retornado no payload de resposta. 20
data.data.name string Campo data.data.name retornado no payload de resposta. Estacao Rodo Lanches e Pizzas
data.data.paymentCodes[] string Campo data.data.paymentCodes[] retornado no payload de resposta. PIX
data.data.phone string Campo data.data.phone retornado no payload de resposta. 992285958
data.data.preparationTimeMinutes number Campo data.data.preparationTimeMinutes retornado no payload de resposta. 9
data.data.priceRange string Campo data.data.priceRange retornado no payload de resposta. CHEAPEST
data.data.resources[].type string Campo data.data.resources[].type retornado no payload de resposta. COVER
data.data.resources[].url string Campo data.data.resources[].url retornado no payload de resposta. https://static-images.ifood.com.br/image/upload/540f008a-104f-44aa-bd92-7892626f8312/202505171215_aQvC_c.png
data.data.shifts[].dayOfWeek number Campo data.data.shifts[].dayOfWeek retornado no payload de resposta. 1
data.data.shifts[].startTime string Campo data.data.shifts[].startTime retornado no payload de resposta. 11:00
data.data.slug string Campo data.data.slug retornado no payload de resposta. curitiba-pr/estacao-rodo-lanches-e-pizzas-jardim-botanico
data.data.tags[] string Campo data.data.tags[] retornado no payload de resposta. SUPER_RESTAURANT
data.data.type string Campo data.data.type retornado no payload de resposta. RESTAURANT
data.data.url string Campo data.data.url retornado no payload de resposta. https://www.ifood.com.br/delivery/curitiba-pr/estacao-rodo-lanches-e-pizzas-jardim-botanico/540f008a-104f-44aa-bd92-7892626f8312
data.data.userRating number Campo data.data.userRating retornado no payload de resposta. 4.8
data.data.userRatingCount number Campo data.data.userRatingCount retornado no payload de resposta. 1006
data.extractedAt string (iso datetime) Campo data.extractedAt retornado no payload de resposta. 2026-02-19T00:30:00.000Z
data.merchantInfoRequestUrl string Campo data.merchantInfoRequestUrl retornado no payload de resposta. https://cw-marketplace.ifood.com.br/v1/merchant-info/graphql?latitude=&longitude=&channel=IFOOD
data.requestUrl string Campo data.requestUrl retornado no payload de resposta. https://www.ifood.com.br/delivery/curitiba-pr/estacao-rodo-lanches-e-pizzas-jardim-botanico/540f008a-104f-44aa-bd92-7892626f8312
data.source string Campo data.source retornado no payload de resposta. ifood.com.br
data.type string Campo data.type retornado no payload de resposta. pdp
data.url string Campo data.url retornado no payload de resposta. https://www.ifood.com.br/delivery/curitiba-pr/estacao-rodo-lanches-e-pizzas-jardim-botanico/540f008a-104f-44aa-bd92-7892626f8312
executionId string (uuid) Campo executionId retornado no payload de resposta. 66666666-2222-4222-8222-666666666666
requestId string (uuid) Campo requestId retornado no payload de resposta. 66666666-1111-4111-8111-666666666666

Erros comuns

Status errorCode Quando acontece
400 INVALID_PAYLOAD JSON inválido ou violação das regras de validação do payload.
401 UNAUTHORIZED Header Authorization ausente ou token/chave inválida.
402 INSUFFICIENT_CREDITS Saldo de créditos insuficiente para a API solicitada.
403 FORBIDDEN Usuário sem acesso ou API temporariamente desabilitada.
409 EXECUTION_CONFLICT executionId conflita com uma execução em estado incompatível.
429 RATE_LIMIT_EXCEEDED / TOO_MANY_INFLIGHT_REQUESTS Limite de taxa ou limite de requisições em voo excedido.
5xx UPSTREAM_TIMEOUT / UPSTREAM_HTTP_ERROR / WORKER_INVOCATION_FAILED / WORKER_FUNCTION_ERROR / WORKER_INVALID_RESPONSE / INTERNAL_ERROR Falha de servidor no worker, provider/proxy ou gateway. Nesses casos os créditos são estornados automaticamente.
WhatsApp