Last updated: 2026-04-21
The fastest way to reach us is email. We read every message.
Email: [email protected]
Response time: Within 48 hours on business days (Monday–Friday, CET)
Languages: English and German
Please include: your device (iOS / Android / Web), the feature you were using, and — if relevant — the provider_id of the listing in question. Screenshots help a lot.
YELLOW.bot is a verified registry of businesses and restaurants. You can search by name or category, browse on a map, scan a menu to extract dishes and prices, or ask a natural-language question. Data is continuously refreshed and every listing has a trust score and last-update timestamp.
No — basic search and browsing is anonymous and free. You only need an account if you want programmatic API access at higher rate limits.
The app and public search are free. For developers, the Free API tier (100 requests/hour, 1000/day) is also free. Verified and Premium tiers are available for higher volume; see the API docs for pricing.
Public business directories and supplier registries (Alibaba showroom, Made-in-China, IndiaMART, GLEIF, Wikidata, Common Crawl, OpenStreetMap), aggregated and de-duplicated — plus direct business submissions from owners. Every listing shows its source and a "last seen" timestamp.
Email [email protected] with the provider_id (visible in the app detail view) and what needs to change. We verify and act within 5 business days. Owners can claim verified status by responding from the listed business domain.
We expose three programmatic interfaces:
https://yellow.bot/api/v1/ — endpoints: search, query, categories, menu-scan, lunch, offershttps://yellow.bot/api/v2/ask — semantic search with natural-language answers and sourceswss://yellow.bot:3004 — native protocol for AI agents (tools: search_providers, get_provider, ask, query_listings, list_categories, report_feedback)Full capability documentation is at /.well-known/llms-full.txt. Register for an API key at POST /api/v1/agents/register.
Exceeding limits returns HTTP 429. Use exponential back-off; unauthorized bulk extraction will result in immediate key revocation.
We do not track, profile, or sell data. There are no third-party analytics SDKs in the app and no advertising or cross-app tracking. See the full Privacy Policy for details.
Email [email protected] with "GDPR deletion request" and the email associated with your account (if any). We confirm deletion within 30 days. For a simple business listing removal, include the provider_id.
Try brighter, even lighting and a straight-on angle. Handwritten menus, reflective laminated sheets, and very stylized typography are the hardest cases. If it consistently fails, email us a photo of the menu and we will investigate.
YELLOW.bot uses coarse (kilometer-level) location only. If you just enabled the permission, give it a few seconds. If you are on Wi-Fi, iOS location can be less accurate than on cellular GPS — consider moving outside.
Within the limits of our Terms of Service, yes — for display inside your product, analytics, and research. You may not republish the raw registry as a competing directory, nor use the data to train a model that duplicates our service.
Email [email protected] with:
wss://yellow.bot:3004https://yellow.bot/api/If you find a security vulnerability, please email [email protected] with "SECURITY" in the subject. We acknowledge within 72 hours and do not take legal action against researchers who follow responsible-disclosure practices.