Kahve Tabela Partners API

The Partners API from Kahve Tabela — 1 operation(s) for partners.

GitHub OpenAPI

Operations 1

GET /api/partners/nearby Keyed partner tier of /api/nearby with monthly quota metering #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/kahvetabela-com:kahvetabela-com-partners-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

kahvetabela-com-partners-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Kahve Tabela Public Discovery Partners API
  version: '2026-07-02'
  description: Read-only public endpoints for Kahve Tabela heritage discovery, nearby route listening, and place media lookup.
servers:
- url: https://kahvetabela.com
tags:
- name: Partners
paths:
  /api/partners/nearby:
    get:
      summary: Keyed partner tier of /api/nearby with monthly quota metering
      description: 'Same parameters and payload as /api/nearby, authenticated with a partner API key sent as `Authorization: Bearer ` (never as a query parameter). Keys are provisioned out-of-band by Kahve Tabela. The endpoint is dormant (503) unless the deployment enables the partner tier. Successful responses are not cacheable and count against the key''s monthly quota; invalid-parameter responses (400) do not. The heritage corpus is open data (also served keyless at /api/nearby); the partner tier sells convenience, quota, and support, not exclusive access, so limit is capped at 20 per request.'
      operationId: listPartnerNearbyLocations
      security:
      - partnerBearer: []
      parameters:
      - name: lat
        in: query
        required: true
        schema:
          type: number
      - name: lon
        in: query
        required: true
        schema:
          type: number
      - name: limit
        in: query
        schema:
          type: integer
          minimum: 1
          maximum: 20
          default: 12
      - name: audio
        in: query
        schema:
          type: string
          enum:
          - '1'
        description: When set to 1, returns only narratable places before distance slicing.
      responses:
        '200':
          description: Nearby places.
          headers:
            X-Quota-Remaining:
              description: Requests left on this key for the current UTC month.
              schema:
                type: integer
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NearbyResponse'
        '400':
          description: Missing or invalid lat/lon.
        '401':
          description: Missing, unknown, or revoked API key.
        '429':
          description: Monthly quota exhausted; Retry-After points at the UTC month rollover.
        '503':
          description: Partner tier not enabled on this deployment.
      tags:
      - Partners
components:
  schemas:
    NearbyResponse:
      type: object
      required:
      - results
      properties:
        results:
          type: array
          items:
            allOf:
            - $ref: '#/components/schemas/LocationSummary'
            - type: object
              properties:
                distance:
                  type: number
                has_audio:
                  type: boolean
    LocationSummary:
      type: object
      required:
      - id
      - name
      - lat
      - lon
      - category
      properties:
        id:
          type: string
        name:
          type: string
        lat:
          type: number
        lon:
          type: number
        category:
          type: string
        image_url:
          type: string
  securitySchemes:
    partnerBearer:
      type: http
      scheme: bearer
      description: 'Partner API key (`Authorization: Bearer <key>`), provisioned out-of-band by Kahve Tabela. Keys are metered monthly and can be revoked.'