{"uid":"cap_RnphuHasPnZ2wwd6cGOhC","slug":"ifood-restaurant-scraper-api-x402-87a7e09f","name":"iFood Restaurant Scraper API (x402)","description":"Pay-per-call structured web data. Failed or empty runs are not charged.","url":"https://x402.186-241-26-229.sslip.io/v1/ifood?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"city":{"type":"string","default":"fortaleza-ce","description":"City slug from an iFood restaurant URL. Discovery searches public sitemap entries for this exact city; it is not an address-radius search."},"query":{"type":"string","default":"","description":"Optional case-insensitive text filter on the restaurant URL slug. It is not a full-text site search."},"address":{"type":"string","default":"","description":"Optional delivery address for reference. Current sitemap discovery cannot apply delivery-distance or availability filters."},"menuMode":{"enum":["limited","all"],"type":"string","default":"limited","description":"Limited applies maxMenuItems if menu data becomes available; all removes that local cap, but does not guarantee source completeness."},"includeMenu":{"type":"boolean","default":true,"description":"Indicates whether menu data is wanted. If the live source is blocked, menu remains empty and coverage fields say not extracted."},"maxMenuItems":{"type":"integer","default":50,"maximum":500,"minimum":1,"description":"Local item cap in limited menu mode. No menu items are invented when the source is blocked."},"includeReviews":{"type":"boolean","default":false,"description":"Indicates whether public reviews are wanted. If unavailable, reviews remain empty with an explicit status."},"maxRestaurants":{"type":"integer","default":50,"maximum":500,"minimum":1,"description":"Maximum number of unique restaurant records to return."},"restaurantUrls":{"type":"array","description":"Public iFood restaurant URLs to process directly. When set, city discovery is skipped."}}},"responseSchema":{"type":"json","example":{"count":1,"items":[{"url":null,"city":null,"name":null,"slug":null,"category":null,"merchantId":null,"nameSource":null,"lastModified":null}],"product":"ifood"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.25","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.25/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.25","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0IA4zXHHX54mfMVCm5zfz","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.25","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Scrapes structured restaurant and menu data from iFood by city slug or direct restaurant URLs, returning name, category, merchant ID, and optional menu/review details.","exampleAgentPrompt":"Scrape iFood restaurant listings for 'sao-paulo-sp', filter by restaurants with 'pizza' in their URL slug, return up to 100 results with limited menu data capped at 30 items each.","exampleUseCases":[{"title":"Market research on iFood restaurant categories","prompt":"Pull me all the iFood restaurants in 'belo-horizonte-mg' — up to 200 of them — with their categories and merchant IDs, so I can analyze what food categories dominate the market there."},{"title":"Competitor menu benchmarking","prompt":"I have a list of iFood restaurant URLs for burger joints in Rio. Scrape their full menu data for me — up to 500 items per restaurant — so I can compare their offerings and prices."},{"title":"Lead generation for restaurant tech sales","prompt":"Find me up to 100 iFood restaurants in 'curitiba-pr' that have 'sushi' in their URL slug, and include their names, slugs, and merchant IDs so I can build a prospect list."}],"resultDescription":"Returns a JSON object with a count of matched restaurants and an items array. Each item includes the restaurant's iFood URL, city, name, slug, category, merchantId, nameSource, and lastModified timestamp. If includeMenu is true, menu data is attached when available. If includeReviews is true, public reviews are included when available. Coverage fields indicate when menu or review data could not be extracted from the live source.","failureModes":["City slug not found in iFood sitemap — returns empty items array with zero count","Live iFood source blocked — menu fields return empty with coverage status noting 'not extracted'","Invalid or inaccessible restaurantUrls — those records are skipped or returned with null fields","Query filter too narrow — may return zero results even when restaurants exist in the city","Payment failure — call is rejected before execution and not charged"],"whenToPreferThis":"Use this endpoint when you need structured iFood restaurant data (names, categories, merchant IDs, menus) for Brazilian cities and don't want to build or maintain your own scraper. It is pay-per-call with no charge for failed or empty runs, making it low-risk for exploratory queries. Prefer it over generic web scrapers when you specifically need iFood data with consistent schema output. Not suitable for real-time delivery availability or address-radius filtering, as it relies on sitemap discovery.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-02T00:46:45.147Z","isFirstParty":false,"canonicalSlug":"ifood-restaurant-scraper-api-x402-87a7e09f"}