GeckoAPI
Entrar Agendar uma demo

// docs

iFood Store -> IDP

Recebe a URL de uma loja do iFood, percorre o cardapio e enriquece cada item com detailUrl usando a API iFood IDP.

Template ID

ifood-store-idp-enrichment

Etapas

2

Formato final

JSON / CSV

Execução

Dashboard + API key

O que este workflow faz

Este workflow foi desenhado para sair do nivel da loja e chegar ao nivel do item. Voce informa uma URL publica de loja no iFood, a GeckoAPI extrai o cardapio completo, identifica cada item que possui detailUrl e executa uma chamada de IDP para devolver complementos, observacoes, precificacao e snapshot operacional do merchant em cada item final do artifact.

Quando usar

  • Montar catalogos enriquecidos de produtos do iFood por loja.
  • Analisar composicao de cardapio, complementos e politicas de precificacao item a item.
  • Criar bases para CRM, comparacao de menus, auditoria operacional e inteligencia competitiva.

Como usar no dashboard

  1. PASSO 1

    No Dashboard, abra Workflows e selecione o template iFood Store -> IDP.

  2. PASSO 2

    Cole a URL publica da loja do iFood que voce quer enriquecer.

  3. PASSO 3

    Escolha o formato final do artifact em JSON ou CSV.

  4. PASSO 4

    Revise a estimativa maxima de creditos antes de iniciar o run.

  5. PASSO 5

    Acompanhe o progresso da etapa de loja e depois da etapa item a item ate o artifact ficar disponivel para download.

Etapas do workflow

iFood Loja

#1

ifood_store

Extrai o cardapio completo da loja informada e identifica todos os itens que expõem detailUrl.

iFood IDP

#2

ifood_item

Enriquece cada item identificado com a IDP completa do iFood.

Campos de input

Estes são os campos usados no dashboard e no body do POST /v1/workflows/runs.

Campo Tipo Obrigatório Como usar Exemplo
URL da loja
storeUrl
 text Sim

URL publica da loja no iFood usada como ponto de partida do workflow.

Use a URL da loja que voce abriria no navegador. O workflow resolve os detailUrls dos itens automaticamente.

 https://www.ifood.com.br/delivery/curitiba-pr/fire-s-burger-jardim-gisela/cf787eb5-3689-4a46-b43c-2ceda85d1a76
Formato final
outputFormat
 output_format Sim

Formato do artifact final.

JSON preserva toda a estrutura do payload IDP. CSV achata os principais campos por item.

 csv

Executar este template via API

O payload abaixo já usa este templateId e um body real compatível com o endpoint público. Depois da criação, acompanhe o run em GET /v1/workflows/runs/{runId}/status e, se necessário, cancele com POST /v1/workflows/runs/{runId}/cancel.

Ver guia completo da API de workflows
Criar workflow 
curl -X POST https://api.geckoapi.com.br/v1/workflows/runs \
+  -H "Authorization: Bearer SUA_CHAVE" \
+  -H "Content-Type: application/json" \
+  -d '{
  "templateId": "ifood-store-idp-enrichment",
  "input": {
    "storeUrl": "https://www.ifood.com.br/delivery/curitiba-pr/fire-s-burger-jardim-gisela/cf787eb5-3689-4a46-b43c-2ceda85d1a76",
    "outputFormat": "csv"
  }
}'

Cancelar um workflow faz o resultado coletado até então se perder para consumo final, então use esse endpoint com cautela.

O que você recebe no arquivo final

Cada run gera um artifact com os metadados do workflow, resumo operacional da execucao e uma lista de itens de cardapio enriquecidos por IDP.

Um item final por produto do cardapio que exponha detailUrl na loja.
Contexto da loja e da secao do menu em que o item foi encontrado.
Payload IDP completo com complementos, campo de observacao, quantidade, precos e snapshot do merchant.
Artifact final pronto para download em JSON ou CSV.

Envelope do artifact

O arquivo final sempre carrega metadados do run, o input original, a estimativa usada na criação e o resumo operacional da execução.

artifact.json 
{
  "runId": "run_ifood_idp_123",
  "correlationId": "corr_ifood_idp_123",
  "templateId": "ifood-store-idp-enrichment",
  "outputFormat": "json",
  "generatedAt": "2026-03-26T15:00:00.000Z",
  "input": {
    "storeUrl": "https://www.ifood.com.br/delivery/curitiba-pr/fire-s-burger-jardim-gisela/cf787eb5-3689-4a46-b43c-2ceda85d1a76",
    "outputFormat": "json"
  },
  "estimate": {
    "maxCredits": 3002,
    "breakdown": [],
    "caps": []
  },
  "summary": {
    "status": "completed",
    "completedTasks": 22,
    "failedTasks": 0
  },
  "items": [
    {
      "store": {
        "ifoodStoreId": "cf787eb5-3689-4a46-b43c-2ceda85d1a76",
        "merchantName": "Fire's Burger",
        "merchantUrl": "https://www.ifood.com.br/delivery/toledo-pr/fire-s-burger-jardim-gisela/cf787eb5-3689-4a46-b43c-2ceda85d1a76"
      },
      "menu": {
        "sectionName": "Lanches",
        "detailUrl": "https://ci-marketplace.ifood.com.br/v1/showcase/dish?actionAccessPoint=merchantMenu&alias=SHOWCASE_CATALOG_ITEM_PROGRAMS&channel=IFOOD&deliveryMethodCode=DEFAULT&itemId=642fbf56-5480-47d8-837a-94317505e121&merchantId=cf787eb5-3689-4a46-b43c-2ceda85d1a76"
      },
      "item": {
        "itemId": "642fbf56-5480-47d8-837a-94317505e121",
        "merchantId": "cf787eb5-3689-4a46-b43c-2ceda85d1a76",
        "code": "642fbf56-5480-47d8-837a-94317505e121",
        "name": "Burguer",
        "details": "Pao de brioche, hamburguer de 130g, queijo e molho da casa",
        "image": "https://static.ifood-static.com.br/pratos/cf787eb5-3689-4a46-b43c-2ceda85d1a76/202410281212_NG27_i.jpg",
        "unitPrice": 25.99,
        "unitMinPrice": 25.99,
        "basePrice": 25.99,
        "basePriceCents": 2599,
        "chargeRule": "HIGHEST_PRICE",
        "promoComboSize": 1,
        "isComplementChooseNeeded": true,
        "tags": [
          "TAG::CART::FD_DESPIT_4C2EC_35"
        ],
        "complements": [
          {
            "id": "0d4bdba1-21be-4872-af82-24bca915daa2",
            "code": "0d4bdba1-21be-4872-af82-24bca915daa2",
            "name": "Adicionais",
            "min": 0,
            "max": 14,
            "availability": "AVAILABLE",
            "enabled": true,
            "options": [
              {
                "id": "b6a7c284-7818-4125-a8e1-b48f945e9f04",
                "code": "b6a7c284-7818-4125-a8e1-b48f945e9f04",
                "name": "Frango Desfiado",
                "price": 7,
                "availability": "AVAILABLE",
                "quantity": null
              }
            ]
          }
        ],
        "noteField": {
          "title": "Alguma observacao?",
          "placeholder": "Ex: tirar a cebola, maionese a parte etc.",
          "maxLength": 140
        },
        "footerType": "ADD",
        "quantityCurrent": 1,
        "quantityMin": 1,
        "quantityMax": 9999,
        "reportItemAction": "item-report?itemID=642fbf56-5480-47d8-837a-94317505e121&merchantID=cf787eb5-3689-4a46-b43c-2ceda85d1a76",
        "merchant": {
          "merchantId": "cf787eb5-3689-4a46-b43c-2ceda85d1a76",
          "name": "Fire's Burger",
          "type": "RESTAURANT",
          "available": true,
          "availableForScheduling": false,
          "deliveryTimeMinutes": 25,
          "distanceKm": 1.15,
          "locale": "pt_BR",
          "logoUrl": null,
          "chargeDifferentToppingsMode": "GREATER",
          "mainFoodType": {
            "code": "LCH",
            "name": "Lanches",
            "description": "Lanches"
          },
          "address": {
            "streetName": "Rua Borges de Medeiros",
            "streetNumber": "247",
            "district": "Jardim Gisela",
            "city": "TOLEDO",
            "state": "PR",
            "country": "BR",
            "zipCode": "85905290",
            "timezone": "Etc/GMT+3",
            "latitude": -24.715711,
            "longitude": -53.733017,
            "complement": ""
          },
          "tags": [
            "NOVO"
          ],
          "features": [
            "DELIVERY",
            "TAKEOUT"
          ],
          "deliveryMethods": [
            {
              "id": "DEFAULT",
              "title": "Padrao",
              "subtitle": "O entregador leva ate voce agora",
              "mode": "DELIVERY",
              "type": "FIXED",
              "deliveredBy": "MERCHANT",
              "priority": 1000,
              "minTimeMinutes": 25,
              "maxTimeMinutes": 35,
              "value": 0,
              "scheduleNow": true
            }
          ],
          "shifts": [
            {
              "dayOfWeek": "MONDAY",
              "durationMinutes": 90,
              "startTime": "00:00:00"
            }
          ]
        },
        "extractedAt": "2026-03-26T15:02:00.000Z"
      },
      "workflow": {
        "runId": "run_ifood_idp_123",
        "templateId": "ifood-store-idp-enrichment",
        "outputFormat": "json"
      }
    }
  ]
}
Path Tipo Descrição Exemplo
correlationId string Correlacao interna usada para rastrear a execucao de ponta a ponta. corr_ifood_idp_123
estimate.maxCredits number Estimativa maxima de creditos reservada para o workflow. 3002
generatedAt ISO-8601 string Momento em que o arquivo final foi consolidado. 2026-03-26T15:00:00.000Z
input.outputFormat "json" | "csv" Formato solicitado no momento da criacao do run. json
input.storeUrl string URL publica da loja usada como ponto de partida. https://www.ifood.com.br/delivery/curitiba-pr/fire-s-burger-jardim-gisela/cf787eb5-3689-4a46-b43c-2ceda85d1a76
items[] WorkflowIfoodIdpExportItem Lista final de itens de cardapio enriquecidos via IDP. {"store":{"ifoodStoreId":"cf787eb5-3689-4a46-b43c-2ceda85d1a76","merchantName":"Fire's Burger","merchantUrl":"https://www.ifood.com.br/delivery/toledo-pr/fire-s-burger-jardim-gisela/cf787eb5-3689-4a46-b43c-2ceda85d1a76"},"menu":{"sectionName":"Lanches","detailUrl":"https://ci-marketplace.ifood.com.br/v1/showcase/dish?actionAccessPoint=merchantMenu&alias=SHOWCASE_CATALOG_ITEM_PROGRAMS&channel=IFOOD&deliveryMethodCode=DEFAULT&itemId=642fbf56-5480-47d8-837a-94317505e121&merchantId=cf787eb5-3689-4a46-b43c-2ceda85d1a76"},"item":{"itemId":"642fbf56-5480-47d8-837a-94317505e121","merchantId":"cf787eb5-3689-4a46-b43c-2ceda85d1a76","code":"642fbf56-5480-47d8-837a-94317505e121","name":"Burguer","details":"Pao de brioche, hamburguer de 130g, queijo e molho da casa","image":"https://static.ifood-static.com.br/pratos/cf787eb5-3689-4a46-b43c-2ceda85d1a76/202410281212_NG27_i.jpg","unitPrice":25.99,"unitMinPrice":25.99,"basePrice":25.99,"basePriceCents":2599,"chargeRule":"HIGHEST_PRICE","promoComboSize":1,"isComplementChooseNeeded":true,"tags":["TAG::CART::FD_DESPIT_4C2EC_35"],"complements":[{"id":"0d4bdba1-21be-4872-af82-24bca915daa2","code":"0d4bdba1-21be-4872-af82-24bca915daa2","name":"Adicionais","min":0,"max":14,"availability":"AVAILABLE","enabled":true,"options":[{"id":"b6a7c284-7818-4125-a8e1-b48f945e9f04","code":"b6a7c284-7818-4125-a8e1-b48f945e9f04","name":"Frango Desfiado","price":7,"availability":"AVAILABLE","quantity":null}]}],"noteField":{"title":"Alguma observacao?","placeholder":"Ex: tirar a cebola, maionese a parte etc.","maxLength":140},"footerType":"ADD","quantityCurrent":1,"quantityMin":1,"quantityMax":9999,"reportItemAction":"item-report?itemID=642fbf56-5480-47d8-837a-94317505e121&merchantID=cf787eb5-3689-4a46-b43c-2ceda85d1a76","merchant":{"merchantId":"cf787eb5-3689-4a46-b43c-2ceda85d1a76","name":"Fire's Burger","type":"RESTAURANT","available":true,"availableForScheduling":false,"deliveryTimeMinutes":25,"distanceKm":1.15,"locale":"pt_BR","logoUrl":null,"chargeDifferentToppingsMode":"GREATER","mainFoodType":{"code":"LCH","name":"Lanches","description":"Lanches"},"address":{"streetName":"Rua Borges de Medeiros","streetNumber":"247","district":"Jardim Gisela","city":"TOLEDO","state":"PR","country":"BR","zipCode":"85905290","timezone":"Etc/GMT+3","latitude":-24.715711,"longitude":-53.733017,"complement":""},"tags":["NOVO"],"features":["DELIVERY","TAKEOUT"],"deliveryMethods":[{"id":"DEFAULT","title":"Padrao","subtitle":"O entregador leva ate voce agora","mode":"DELIVERY","type":"FIXED","deliveredBy":"MERCHANT","priority":1000,"minTimeMinutes":25,"maxTimeMinutes":35,"value":0,"scheduleNow":true}],"shifts":[{"dayOfWeek":"MONDAY","durationMinutes":90,"startTime":"00:00:00"}]},"extractedAt":"2026-03-26T15:02:00.000Z"},"workflow":{"runId":"run_ifood_idp_123","templateId":"ifood-store-idp-enrichment","outputFormat":"json"}}
outputFormat "json" | "csv" Formato final escolhido pelo usuario. json
runId string Identificador unico do run criado no dashboard. run_ifood_idp_123
summary.completedTasks number Total de tarefas concluidas com sucesso. 22
summary.failedTasks number Total de tarefas que falharam no run. 0
summary.status WorkflowRunStatus Status final do workflow. completed
templateId string Template usado para gerar este artifact. ifood-store-idp-enrichment

Estrutura de cada item

Cada item do artifact representa um produto do cardapio que tinha detailUrl disponivel na loja e foi enriquecido com a resposta completa do seam ifood.com.br:idp.

item.json 
{
  "store": {
    "ifoodStoreId": "cf787eb5-3689-4a46-b43c-2ceda85d1a76",
    "merchantName": "Fire's Burger",
    "merchantUrl": "https://www.ifood.com.br/delivery/toledo-pr/fire-s-burger-jardim-gisela/cf787eb5-3689-4a46-b43c-2ceda85d1a76"
  },
  "menu": {
    "sectionName": "Lanches",
    "detailUrl": "https://ci-marketplace.ifood.com.br/v1/showcase/dish?actionAccessPoint=merchantMenu&alias=SHOWCASE_CATALOG_ITEM_PROGRAMS&channel=IFOOD&deliveryMethodCode=DEFAULT&itemId=642fbf56-5480-47d8-837a-94317505e121&merchantId=cf787eb5-3689-4a46-b43c-2ceda85d1a76"
  },
  "item": {
    "itemId": "642fbf56-5480-47d8-837a-94317505e121",
    "merchantId": "cf787eb5-3689-4a46-b43c-2ceda85d1a76",
    "code": "642fbf56-5480-47d8-837a-94317505e121",
    "name": "Burguer",
    "details": "Pao de brioche, hamburguer de 130g, queijo e molho da casa",
    "unitPrice": 25.99,
    "basePrice": 25.99,
    "basePriceCents": 2599,
    "complements": [
      {
        "name": "Adicionais"
      }
    ],
    "noteField": {
      "title": "Alguma observacao?"
    },
    "merchant": {
      "name": "Fire's Burger",
      "type": "RESTAURANT",
      "address": {
        "city": "TOLEDO",
        "state": "PR"
      }
    },
    "extractedAt": "2026-03-26T15:02:00.000Z"
  },
  "workflow": {
    "runId": "run_ifood_idp_123",
    "templateId": "ifood-store-idp-enrichment",
    "outputFormat": "json"
  }
}
Path Tipo Descrição Exemplo
item.basePrice number | null Preco base normalizado em reais. 25.99
item.basePriceCents integer | null Preco base em centavos quando disponivel. 2599
item.chargeRule string | null Regra de cobranca dos complementos. N/A
item.code string | null Codigo do item retornado pela IDP. 642fbf56-5480-47d8-837a-94317505e121
item.complements[].name string | null Nome de cada grupo de complemento. Adicionais
item.complements[].options[].name string | null Nome das opcoes dentro de cada grupo de complemento. N/A
item.details string | null Descricao textual do item. Pao de brioche, hamburguer de 130g, queijo e molho da casa
item.extractedAt ISO-8601 string Momento em que a IDP deste item foi extraida. 2026-03-26T15:02:00.000Z
item.footerType string | null Tipo do rodape de compra devolvido pela IDP. N/A
item.isComplementChooseNeeded boolean | null Indica se o item exige selecao de complementos. N/A
item.itemId string Identificador unico do item no iFood. 642fbf56-5480-47d8-837a-94317505e121
item.merchant.address.city string | null Cidade do merchant. TOLEDO
item.merchant.address.state string | null UF do merchant. PR
item.merchant.deliveryTimeMinutes number | null Tempo de entrega atual associado ao merchant. N/A
item.merchant.name string | null Nome do merchant devolvido dentro da IDP. Fire's Burger
item.merchant.type string | null Tipo do merchant. RESTAURANT
item.merchantId string Identificador do merchant associado ao item. cf787eb5-3689-4a46-b43c-2ceda85d1a76
item.name string | null Nome do item. Burguer
item.noteField.title string | null Titulo do campo de observacao livre do item. Alguma observacao?
item.promoComboSize integer | null Tamanho de combo promocional quando presente. N/A
item.quantityCurrent integer | null Quantidade inicial selecionada no rodape da IDP. N/A
item.quantityMax integer | null Quantidade maxima permitida. N/A
item.quantityMin integer | null Quantidade minima permitida. N/A
item.reportItemAction string | null Acao bruta de denuncia do item, quando presente. N/A
item.tags[] string Tags brutas devolvidas pelo iFood para o item. N/A
item.unitPrice number | null Preco unitario atual do item. 25.99
menu.detailUrl string URL IDP usada para enriquecer o item. https://ci-marketplace.ifood.com.br/v1/showcase/dish?actionAccessPoint=merchantMenu&alias=SHOWCASE_CATALOG_ITEM_PROGRAMS&channel=IFOOD&deliveryMethodCode=DEFAULT&itemId=642fbf56-5480-47d8-837a-94317505e121&merchantId=cf787eb5-3689-4a46-b43c-2ceda85d1a76
menu.sectionName string | null Secao do cardapio em que o item apareceu. Lanches
store.ifoodStoreId string Identificador da loja de origem no iFood. cf787eb5-3689-4a46-b43c-2ceda85d1a76
store.merchantName string | null Nome observado para a loja quando o item foi descoberto. Fire's Burger
store.merchantUrl string | null URL publica da loja no iFood. https://www.ifood.com.br/delivery/toledo-pr/fire-s-burger-jardim-gisela/cf787eb5-3689-4a46-b43c-2ceda85d1a76
workflow.templateId string Template responsavel por gerar este item no artifact. ifood-store-idp-enrichment

Observações importantes

  • O workflow so enriquece itens que exponham detailUrl no cardapio retornado pela loja.
  • Em beta, cada run aceita ate 1.000 itens com detailUrl por loja. Se a loja ultrapassar esse limite, o workflow falha para evitar um artifact parcial.
Grátis para sempre

Rodar este workflow no dashboard?

Use o template no dashboard para estimar créditos, acompanhar a execução por etapa e baixar o artifact final.

Abrir dashboard Ver exemplos de uso
WhatsApp