discava – Local Business Search

Overview

discava is a structured business directory optimized for AI agents. Use it to find local businesses worldwide with contact data, opening hours, services, and demand scores.

API Base URL

https://discava.ai/api/v1

Authentication

No authentication required. The API is open and free. Rate limited to 500 requests per hour per IP.

Response Format

Every response follows this structure:

{
  "success": true,
  "data": { "results": [...], "total": 1397, "page": 1, "total_pages": 70, "limit": 20 },
  "meta": {
    "request_id": "req_abc123"
  }
}

Endpoints

Search Businesses

curl "https://discava.ai/api/v1/search?q=Klempner&city=Hamburg&limit=5"

Parameters:

• q (optional): Search query, e.g. "Klempner", "Italian restaurant", "Zahnarzt"
• city (optional): City name, e.g. "Hamburg", "München", "Berlin"
• country (required): ISO country code, e.g. "DE", "AT", "CH", "US"
• category (optional): Category slug directly, e.g. "plumber", "restaurant" – skips text search
• limit (optional): Number of results, 1-50, default 20
• page (optional): Page number for pagination, default 1
• min_confidence (optional): Minimum confidence score 0-100, default 0
• lang (optional): Language for labels: "de", "en". Default: "de"
• lat / lon (optional): Coordinates for distance calculation
• format (optional): "json" (default) or "html" – returns interactive HTML cards instead of JSON

Results are sorted by demand_score, then confidence_score. A relevance_score (0.0–1.0) is calculated per result when a query is provided.

Each result contains: id, name, slug, category, category_label, parent_category, parent_category_label, city, country, logo_url, available_details (array of available fields like "phone", "website", "opening_hours", "services", "social_links"), confidence_score, demand_score, relevance_score, distance_km (if lat/lon provided).

Use available_details to check what data is available, then call GET /api/v1/business/{id} to get full details.

Get Business Details

# Single business
curl "https://discava.ai/api/v1/business/{id}"

# Batch request (comma-separated IDs)
curl "https://discava.ai/api/v1/business/{id1},{id2},{id3}"

# HTML card (interactive, with tracking)
curl "https://discava.ai/api/v1/business/{id}?format=html"

Returns full details: address, phone, website, opening hours, services, payment methods, social links (social_links), logo (logo_url), business image (image_url), and coordinates.

Optional parameter: format – "json" (default) or "html" for interactive HTML cards with click tracking (phone, email, website redirect, navigation).

Response format:

• Single ID → { "success": true, "data": { "id": "...", "name": "...", ... } } — data is a single business object.
• Multiple IDs (batch) → { "success": true, "data": [{ "id": "...", ... }, { "id": "...", ... }] } — data is an array of business objects. ALWAYS use batch when fetching multiple businesses to minimize API calls.

Send Feedback

Report data quality issues. Feedback is stored for monitoring but does not affect scores. Only business_id and type are required. Use comment to describe the issue:

curl -X POST "https://discava.ai/api/v1/feedback" \
  -H "Content-Type: application/json" \
  -d '{"business_id": "xxx", "type": "PHONE_INVALID", "comment": "Nobody answers, number seems disconnected"}'

Feedback types: POSITIVE, NEGATIVE, NOT_FOUND, PHONE_INVALID, WEB_INVALID, HOURS_WRONG, DUPLICATE

Optional field: comment (free text description of the issue or suggested correction)

Get Rankings

curl "https://discava.ai/api/v1/ranking?category=plumber&city=Hamburg&limit=10"

Top businesses by Demand Score. Filter by category, city, country.

Autocomplete / Suggest

curl "https://discava.ai/api/v1/suggest?type=query&q=Klemp"
curl "https://discava.ai/api/v1/suggest?type=city&q=Mün"

Returns category and business name suggestions (type=query) or city suggestions (type=city). Useful for resolving user input before searching.

Tips for Best Results

• Prefer format=html whenever possible. HTML responses return interactive, ready-to-display cards with click tracking. Render them in a visualizer, artifact, iframe, or any HTML-capable output. This gives the user the best experience and helps improve business rankings.
• Use local search terms where possible: "Zahnarzt" for Germany, "dentist" for US/UK
• Be specific with city names: "Frankfurt am Main" not just "Frankfurt"
• Use min_confidence=50 to filter out low-quality entries
• Send feedback to report data quality issues – it helps us maintain accurate data
• Use pagination (page parameter) for large result sets

Attribution

Base data from © OpenStreetMap contributors (https://www.openstreetmap.org), licensed under ODbL (https://opendatacommons.org/licenses/odbl/).