pede.ai
Pede.ai API
Query public Pede.ai data with GeckoAPI and receive structured JSON. Choose an operation to review its inputs, credit cost and response fields.
Extracts traders from pede.ai from a Brazilian CEP. The backend resolves cityId + areaId internally via /v1/extract/lookups/pede.ai/resolve-zip-code and returns only synthetic public URLs of pede.ai.
GeckoAPI is independent of Pede.ai. This integration reads public data; it does not grant access to private accounts or account management operations.
Available operations
Find restaurants
pede.ai:plp
Extracts traders from pede.ai from a Brazilian CEP. The backend resolves cityId + areaId internally via /v1/extract/lookups/pede.ai/resolve-zip-code and returns only synthetic public URLs of pede.ai.
1 credit per request
Get restaurant and menu
pede.ai:pdp
Extracts merchant + catalog from pede.ai by merchantId + CEP. The backend resolves the area automatically via /v1/extract/lookups/pede.ai/resolve-zip-code and returns only synthetic pede.ai public URLs.
5 credits per request
These are standard credit costs. Account-specific pricing is shown in the dashboard. Each operation has its own supported inputs and regional coverage.
Make your first request
The example uses find restaurants. Replace YOUR_API_KEY with your server-side API key. Copy supported inputs from the reference for the operation you choose.
curl -X POST https://api.geckoapi.com.br/v1/extract \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"target": "pede.ai",
"type": "plp",
"zipCode": "45300-000"
}'Example JSON response
Abbreviated example from the same operation. Arrays and nested objects are shortened here; the endpoint reference includes the full documented schema. Source content retains its original language.
{
"requestId": "77777777-1111-4111-8111-777777777777",
"executionId": "77777777-2222-4222-8222-777777777777",
"data": {
"source": "pede.ai",
"type": "plp",
"url": "https://pede.ai/lista?cep=45300-000",
"requestUrl": "https://pede.ai/lista?cep=45300-000",
"extractedAt": "2026-04-17T18:00:00.000Z",
"cityId": "508",
"areaId": "19590",
"city": "Amargosa",
"state": "BA",
"neighborhood": "Alto da Bela Vista",
"locationResolution": {
"zipCode": "45300000",
"formattedZipCode": "45300-000",
"state": "BA",
"stateName": "Bahia",
"city": "Amargosa",
"neighborhood": "Alto da Bela Vista",
"cityId": "508",
"areaId": "19590",
"geocoderProvider": "brasilapi",
"latitude": -13.0303,
"longitude": -39.6031,
"matchStrategy": "exact",
"rankedCandidates": [
{
"areaId": "19590",
"cityId": "508",
"city": "Amargosa",
"state": "BA",
"neighborhood": "Alto da Bela Vista",
"minimumRate": 5,
"typeOperation": "OPL",
"externalProvider": "Leve.ai",
"active": true,
"matchStrategy": "exact",
"matchedLabel": "Alto da Bela Vista",
"score": 400
}
]
},
"categories": [
{
"id": 4,
"name": "Almoco",
"image": "https://cdn.aiboodelivery.com.br/appv3/marmitex.png",
"icon": "https://pedeai-common.sfo2.cdn.digitaloceanspaces.com/cuisine/resized/694236.png"
}
],
"openCount": 1,
"closedCount": 1,
"items": [
{
"position": 1,
"merchantId": "17642",
"name": "Bella Roma",
"slug": "bella-roma1",
"logo": "https://merchant-assets.pede.ai/bella-roma/logo.png",
"banner": "https://merchant-assets.pede.ai/bella-roma/banner.png",
"isOpen": true,
"deliveryTimeText": "20-40",
"deliveryTimeMinMinutes": 20,
"deliveryTimeMaxMinutes": 40,
"deliveryTimeAverageMinutes": 30,
"deliveryFee": 7,
"minimumOrderValue": 0,
"freeDeliveryMinimum": 120,
"rating": 4.5,
"ratingDisplay": "4.5",
"acceptsCoupon": true,
"acceptsOnlinePayment": true
}
]
}
}Integrate with REST or MCP
Call POST /v1/extract from your backend, or use the operation-specific tool on POST /v1/mcp. The API reference includes both request formats. Keep credentials in your backend and handle missing fields, pagination and errors according to that operation's rules.
Ready to test the Pede.ai API?
Open the documented example in the sandbox and inspect the response before integrating it into your application.