> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apiosk.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Browse listings by type



## OpenAPI

````yaml /openapi/public-gateway.json get /types/{listing_type}/v1
openapi: 3.1.0
info:
  title: Apiosk Gateway Public API
  version: 1.1.0
  description: >-
    Sanitized public API reference for the Apiosk gateway. This document covers
    the integration contract for discovery, metadata, execution, payments, and
    community API publishing without exposing internal gateway implementation
    details.
servers:
  - url: https://gateway.apiosk.com
    description: Production gateway
security: []
tags:
  - name: Discovery
    description: Browse listing groups, APIs, and listing detail.
  - name: Execution
    description: Call APIs through public metadata and uniform execute routes.
  - name: Payments
    description: 'Public x402 boundary: 402 responses and payment proof header.'
  - name: Publishing
    description: Register, inspect, update, and deactivate community APIs.
  - name: Metrics
    description: Public wallet and traffic summary routes.
paths:
  /types/{listing_type}/v1:
    get:
      tags:
        - Discovery
      summary: Listings by type
      operationId: listByType
      parameters:
        - name: listing_type
          in: path
          required: true
          description: Public listing type to browse.
          schema:
            type: string
            enum:
              - api
              - dataset
              - service
              - connector
              - skill
              - product
          example: api
        - name: search
          in: query
          required: false
          description: Full-text search over name and description.
          schema:
            type: string
          example: weather
        - name: sort
          in: query
          required: false
          description: Sort order field.
          schema:
            type: string
            enum:
              - name
              - price
              - newest
            default: name
          example: price
        - name: order
          in: query
          required: false
          description: Sort direction.
          schema:
            type: string
            enum:
              - asc
              - desc
            default: asc
          example: asc
        - name: limit
          in: query
          required: false
          description: Maximum number of records to return.
          schema:
            type: integer
            minimum: 1
            maximum: 500
            default: 500
          example: 20
        - name: offset
          in: query
          required: false
          description: Pagination offset.
          schema:
            type: integer
            minimum: 0
            default: 0
          example: 0
      responses:
        '200':
          description: Paged listings for one listing type.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TypeListResponse'
        '404':
          $ref: '#/components/responses/NotFound'
components:
  schemas:
    TypeListResponse:
      type: object
      properties:
        listing_type:
          type: string
        apis:
          type: array
          items:
            $ref: '#/components/schemas/ApiInfoResponse'
        meta:
          $ref: '#/components/schemas/ApiListMeta'
    ApiInfoResponse:
      type: object
      properties:
        id:
          type: string
          format: uuid
        slug:
          type: string
        name:
          type: string
        description:
          type: string
        price_usd:
          type: number
        category:
          type: string
        raw_category:
          type: string
        implementation_type:
          type: string
        model_backed:
          type: boolean
        listing_type:
          type: string
        docs_url:
          type: string
        origin_url:
          type: string
        gateway_url:
          type: string
        active:
          type: boolean
        verified:
          type: boolean
        endpoint_count:
          type: integer
        listing_metadata:
          type: object
          additionalProperties: true
        created_at:
          type: string
          format: date-time
    ApiListMeta:
      type: object
      required:
        - total
        - returned
        - limit
        - offset
        - sort
        - order
      properties:
        total:
          type: integer
        returned:
          type: integer
        limit:
          type: integer
        offset:
          type: integer
        search:
          type: string
          nullable: true
        category:
          type: string
          nullable: true
        sort:
          type: string
        order:
          type: string
  responses:
    NotFound:
      description: Resource not found.
      content:
        application/json:
          schema:
            type: object
            additionalProperties: true

````