Bynder Similarity Search API

Endpoints for performing AI-powered similarity searches on assets

GitHub OpenAPI

Operations 1

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /api/1/assets/similarity-search/ Find assets similar to an image or text · Search for similar assets #
Ask an LLM
“How do I find assets similar to a given image?”
“Can I search similar assets by text description instead of an image?”
Tell an agent
Find assets similar to {assetIds}.
Search similar assets to the image at {imageUrl}.

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/bynder:bynder-similarity-search-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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

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

OpenAPI Specification

bynder-similarity-search-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Bynder Asset Similarity Search API
  description: Find similar assets using AI-powered image and content similarity matching.
  version: 1.0.0
  x-bynder-visibility: public
servers:
- url: https://{your-bynder-domain}/
  variables:
    your-bynder-domain:
      default: example.com
      description: Your Bynder domain.
security:
- bearerAuth: []
tags:
- description: Endpoints for performing AI-powered similarity searches on assets
  name: Similarity Search
paths:
  /api/1/assets/similarity-search/:
    post:
      description: 'Perform a similarity search for assets based on asset IDs, image URL, image data, or text query.


        This endpoint uses the newer, standard UUID format of 8-4-4-4-12, and letters are lowercase. See the example for `assetIds`, and Note on identifiers for more information. Additionally, only one of the search parameters (`assetIds`, `imageUrl`, `imageData`, `textQuery`) should be provided per request. Providing multiple parameters will result in a `400` Bad request response. Only OAuth2 authentication is supported for this endpoint, and permanent tokens are not accepted.'
      requestBody:
        content:
          application/json:
            schema:
              properties:
                assetIds:
                  description: List of asset IDs to search similar assets for.
                  example:
                  - eff9f6c7-ae77-4614-911b-fd238df5bac3
                  - 5af81baa-ee0b-4611-bfa6-fd023c7989b8
                  items:
                    type: string
                  type: array
                imageData:
                  description: Base64 encoded image data for similarity search.
                  example: data:image/jpeg;base64,...
                  type: string
                imageUrl:
                  description: URL of the image to find similar assets.
                  example: https://d2csxpduxe849s.cloudfront.net/media/A7148429-45E9-45C9-98BABD031228C0E2/0A1C48A2-2523-440C-81DD9DFA221D28FC/webimage-5FE11596-1C5D-4FC1-9C216A240BA53979.png
                  type: string
                textQuery:
                  description: A text query describing the image for the search.
                  example: Image of a sunset
                  type: string
              type: object
        required: true
      responses:
        '200':
          content:
            application/json:
              example:
                assets:
                - assetId: e0664bc4-4d64-4776-a010-a19d337f7ee9
                  similarityScore: 0.98
                - assetId: 0e870dbc-c6a4-414a-8467-75fac70c84d9
                  similarityScore: 0.95
              schema:
                properties:
                  assets:
                    items:
                      properties:
                        assetId:
                          example: e0664bc4-4d64-4776-a010-a19d337f7ee9
                          type: string
                        similarityScore:
                          example: 0.98
                          format: float
                          type: number
                      type: object
                    type: array
                type: object
          description: Successful response
        '400':
          content:
            application/json:
              example:
                message: 'Multiple search parameters provided. Please provide only one of the following parameters: assetIds, imageUrl, imageData, textQuery.'
                reason: MULTIPLE_SEARCH_PARAMETERS
              schema:
                properties:
                  message:
                    example: 'Multiple search parameters provided. Please provide only one of the following parameters: assetIds, imageUrl, imageData, textQuery.'
                    type: string
                  reason:
                    example: MULTIPLE_SEARCH_PARAMETERS
                    type: string
                type: object
          description: Bad request
      summary: Search for similar assets
      tags:
      - Similarity Search
      operationId: postApi1AssetsSimilaritySearch
      x-operation-id-source: derived
components:
  securitySchemes:
    bearerAuth:
      bearerFormat: OAuth2
      scheme: bearer
      type: http
x-provenance:
  method: harvested
  publisher: Bynder
  source: https://developers.bynder.com/apis/bynder-asset-similarity-search-api-1/versions/4ea406ce-ed69-40f3-9ed6-96c4fd9a831f.md
  note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
    stamped by stamp-openapi-provenance.py (roadmap#793)