Gummble API Reference API

Gummble API Reference API as documented publicly: 9 operations. Contract generated from the documentation by API Evangelist (2026-11-11); not the provider's own document.

GitHub OpenAPI

Operations 9

GET /api/v1/apps GET /api/v1/apps #
GET /api/v1/apps/{slugorid} Get an app #
GET /api/v1/flows List flows #
GET /api/v1/flows/{id} Get a flow #
GET /api/v1/screens List screens #
GET /api/v1/screens/{id} Get a screen #
GET /api/v1/screens/{id}/download Download #
POST /api/v1/search/visual POST /api/v1/search/visual #

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/gummble-com:api-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

gummble-com-api-openapi-generated.yml Raw ↑
openapi: 3.1.0
info:
  title: Gummble API Reference API
  version: '2026-11-11'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-11: 9 operation(s) read from 4 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Gummble has published no machine-readable contract that the pipeline
    could find. Engine: local.'
  x-evidence-tiers:
    code-example: 9
    documentation: 10
    pages-with-code: 7
    pages-read: 11
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-11'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://docs.gummble.com/docs/api/apps
  - https://docs.gummble.com/docs/api/flows
  - https://docs.gummble.com/docs/api/screens
  - https://docs.gummble.com/docs/api/search
  x-docs-section: api
servers:
- url: https://api.gummble.com
paths:
  /api/v1/apps:
    get:
      operationId: get_api_v1_apps
      tags:
      - Api
      summary: GET /api/v1/apps
      x-source: https://docs.gummble.com/docs/api/apps
      parameters:
      - name: limit
        in: query
        required: false
        schema:
          type: string
      - name: q
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl 'https://api.gummble.com/api/v1/apps?q=linear&limit=1'  -H \"Authorization: Bearer $TOKEN \" \n { \n \"data\" : [{ \n \"\
          id\" : \"app_01HXY...\" , \n \"slug\" : \"linear\" , \n \"name\" : \"Linear\" , \n \"platforms\" : [ \"web\" , \"ios\" ], \n \"categories\"\
          \ : [ \"Productivity\" ], \n \"iconUrl\" : \"https://storage.gummble.com/apps/linear/icon.webp\" , \n \"previewScreenIds\" : [ \"sc_…\"\
          \ , \"sc_…\" ] \n }], \n \"pagination\" : { \"cursor\""
  /api/v1/apps/{slugorid}:
    get:
      operationId: get_api_v1_apps_slugorid
      tags:
      - Api
      summary: Get an app
      description: Returns the full app payload including all screens and flows.
      x-source: https://docs.gummble.com/docs/api/apps
      parameters:
      - name: slugorid
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1AppsSlugoridResponse'
      x-evidence:
        kind: documentation
  /api/v1/flows:
    get:
      operationId: get_api_v1_flows
      tags:
      - Api
      summary: List flows
      x-source: https://docs.gummble.com/docs/api/flows
      parameters:
      - name: appId
        in: query
        required: false
        schema:
          type: string
        description: Filter by app
      - name: type
        in: query
        required: false
        schema:
          type: string
        description: Flow type ( onboarding , paywall , checkout , …)
      - name: platform
        in: query
        required: false
        schema:
          type: string
        description: IOS | ANDROID | WEB Platform filter; lowercase URL tokens are accepted and normalized
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1FlowsResponse'
      x-evidence:
        kind: documentation
  /api/v1/flows/{id}:
    get:
      operationId: get_api_v1_flows_id
      tags:
      - Api
      summary: Get a flow
      x-source: https://docs.gummble.com/docs/api/flows
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1FlowsIdResponse'
      x-evidence:
        kind: documentation
  /api/v1/screens:
    get:
      operationId: get_api_v1_screens
      tags:
      - Api
      summary: List screens
      x-source: https://docs.gummble.com/docs/api/screens
      parameters:
      - name: appId
        in: query
        required: false
        schema:
          type: string
        description: Filter by app
      - name: pattern
        in: query
        required: false
        schema:
          type: string
        description: UI pattern ( onboarding , paywall , empty-state , …)
      - name: colors
        in: query
        required: false
        schema:
          type: array
        description: Dominant color filter
      - name: q
        in: query
        required: false
        schema:
          type: string
        description: Free-text on extracted OCR + caption
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/screens/{id}:
    get:
      operationId: get_api_v1_screens_id
      tags:
      - Api
      summary: Get a screen
      x-source: https://docs.gummble.com/docs/api/screens
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/screens/{id}/download:
    get:
      operationId: get_api_v1_screens_id_download
      tags:
      - Api
      summary: Download
      x-source: https://docs.gummble.com/docs/api/screens
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/search:
    get:
      operationId: get_api_v1_search
      tags:
      - Api
      summary: Universal search
      description: Hybrid keyword + semantic search across apps, screens, and flows.
      x-source: https://docs.gummble.com/docs/api/search
      parameters:
      - name: q
        in: query
        required: true
        schema:
          type: string
        description: Query string
      - name: type
        in: query
        required: false
        schema:
          type: string
        description: Result type filter (app | screen | flow | all)
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        description: Max results (default 10, max 50)
      - name: semantic
        in: query
        required: false
        schema:
          type: boolean
        description: 'Force semantic-only mode (default: hybrid)'
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /api/v1/search/visual:
    post:
      operationId: post_api_v1_search_visual
      tags:
      - Api
      summary: POST /api/v1/search/visual
      x-source: https://docs.gummble.com/docs/api/search
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl -X POST https://api.gummble.com/api/v1/search/visual  -H \"Authorization: Bearer $TOKEN \"  -F \"image=@screenshot.png\"\
          \  -F \"limit=10\" \n Uploads are validated by magic-byte sniffing (not just MIME). Only\nJPEG, PNG, and WebP under 8 MiB are accepted.\
          \ \n Response shape \n { \n \"data\" : [ \n { \n \"type\" : \"screen\" , \n \"score\" : 0.87 , \n \"item\" : { ... full Screen object\
          \ ... } \n } \n ] \n } \n score ranges "
security:
- bearer: []
components:
  schemas:
    GetApiV1AppsSlugoridResponse:
      type: object
      properties:
        id:
          type: string
          description: App identifier
        slug:
          type: string
          description: App slug
        name:
          type: string
          description: App name
        description:
          type: string
          description: Optional description
        platform:
          type: string
          description: IOS | ANDROID | WEB
        categories:
          type: array
          description: Categories
        iconUrl:
          type: string
          description: Icon URL
        websiteUrl:
          type: string
          description: Optional website URL
        screens:
          type: array
          description: Screens (populated on GET /apps/:slug)
        flows:
          type: array
          description: Flows (populated on GET /apps/:slug)
    GetApiV1FlowsResponse:
      type: object
      properties:
        flows:
          type: array
          description: Array of Flow objects
    GetApiV1FlowsIdResponse:
      type: object
      properties:
        flow:
          type: object
          description: Flow object with ordered list of screen objects
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
tags:
- name: Api