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/nexbid-dev:nexbid-dev-discovery-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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.

GitHub Google LinkedIn

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

OpenAPI Specification

openapi: 3.2.0
info:
  title: Nexbid Dev Discovery API
  version: '1.0'
  description: 'Operations tagged Discovery across 2 of this provider''s published API definitions: nexbid-dev-agent-openapi.json, nexbid-dev-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://nexbid.dev
  description: Production
- url: https://api.nexbid.dev
  description: Discovery API (Production)
- url: https://attr.nexbid.dev
  description: Attribution API (Production)
tags:
- name: Discovery
  description: Well-known capability manifests.
paths:
  /.well-known/mcp.json:
    get:
      operationId: getMcpDiscovery
      summary: MCP server discovery manifest
      tags:
      - Discovery
      responses:
        '200':
          description: MCP tool list + transport.
          content:
            application/json:
              schema:
                type: object
    servers:
    - url: https://nexbid.dev
      description: Production
  /.well-known/agent-card.json:
    get:
      operationId: getAgentCard
      summary: A2A agent card
      tags:
      - Discovery
      responses:
        '200':
          description: Agent capabilities + skills.
          content:
            application/json:
              schema:
                type: object
    servers:
    - url: https://nexbid.dev
      description: Production
  /.well-known/agents.json:
    get:
      operationId: getAgentsManifest
      summary: Agent-Commerce-Kit agents.json
      tags:
      - Discovery
      responses:
        '200':
          description: Participant + services + capabilities.
          content:
            application/json:
              schema:
                type: object
    servers:
    - url: https://nexbid.dev
      description: Production
  /v1/discover:
    post:
      operationId: discoverProducts
      tags:
      - Discovery
      summary: Search products
      description: Search the Nexbid product index using natural language queries. Returns organic results and optionally a sponsored product from the real-time auction.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DiscoverRequest'
            example:
              query: running shoes under 200 CHF
              intent: purchase
              budget:
                maxCents: 20000
                currency: CHF
              geo: CH
              maxResults: 10
      responses:
        '200':
          description: Products found (may include sponsored result from auction)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DiscoverResponse'
        '400':
          description: Invalid request (missing query, query too long)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                missingQuery:
                  value:
                    error: Field "query" is required (non-empty string)
                    code: missing_query
                queryTooLong:
                  value:
                    error: Field "query" must be 500 characters or less
                    code: query_too_long
        '401':
          description: Missing or invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                missingKey:
                  value:
                    error: API key required
                    code: missing_api_key
                invalidKey:
                  value:
                    error: Invalid API key
                    code: invalid_api_key
        '403':
          description: API key revoked or insufficient permissions
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                revoked:
                  value:
                    error: API key has been revoked
                    code: api_key_revoked
                noPermission:
                  value:
                    error: API key lacks discover permission
                    code: insufficient_permissions
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - apiKeyHeader: []
      - bearerAuth: []
    servers:
    - url: https://api.nexbid.dev
      description: Discovery API (Production)
    - url: https://attr.nexbid.dev
      description: Attribution API (Production)
  /v1/feeds:
    post:
      operationId: createFeed
      tags:
      - Discovery
      summary: Register a product feed
      description: 'Register a new product feed for ingestion. Supported formats: Google Shopping XML, JSON, CSV.'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FeedCreateRequest'
            example:
              advertiserId: adv_123
              feedUrl: https://shop.example.com/feed.xml
              feedType: google_shopping_xml
              name: Main Product Feed
              geoScope:
              - CH
              - DE
      responses:
        '201':
          description: Feed created
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FeedCreateResponse'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '409':
          description: Feed already exists
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - apiKeyHeader: []
      - bearerAuth: []
    servers:
    - url: https://api.nexbid.dev
      description: Discovery API (Production)
    - url: https://attr.nexbid.dev
      description: Attribution API (Production)
components:
  responses:
    Forbidden:
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
    Unauthorized:
      description: Referenced by this document but never defined in it. API Evangelist added this empty placeholder so the document resolves; the shape is unknown and is NOT a claim about the API.
      x-ae-placeholder: true
  schemas:
    Product:
      type: object
      properties:
        id:
          type: string
        name:
          type: string
        price:
          type: string
    Budget:
      type: object
      properties:
        maxCents:
          type: integer
        currency:
          type: string
    ErrorResponse:
      type: object
      properties:
        error:
          type: string
        code:
          type: string
    DiscoverResponse:
      type: object
      properties:
        results:
          type: array
          items:
            $ref: '#/components/schemas/Product'
    DiscoverRequest:
      type: object
      properties:
        query:
          type: string
        intent:
          type: string
        budget:
          $ref: '#/components/schemas/Budget'
        geo:
          type: string
        maxResults:
          type: integer
      required:
      - query
    FeedCreateResponse:
      type: object
      properties:
        feedId:
          type: string
    FeedCreateRequest:
      type: object
      properties:
        advertiserId:
          type: string
        feedUrl:
          type: string
        feedType:
          type: string
        name:
          type: string
        geoScope:
          type: array
          items:
            type: string
      required:
      - advertiserId
      - feedUrl
      - feedType
x-refined-from:
- nexbid-dev-agent-openapi.json
- nexbid-dev-openapi.json