aid: marqo
name: Marqo
description: >-
  Marqo is an open-source, multimodal vector search engine that lets developers
  index text and images, generate embeddings on the fly, and run tensor, lexical,
  and hybrid search through a single REST API. Built on Vespa for storage and
  retrieval and FastAPI for the HTTP surface, Marqo bundles model inference
  (Sentence Transformers, OpenCLIP, ONNX) inside the engine so a single
  `docker run` produces a working semantic search stack. The Apache 2.0
  open-source engine has been marked deprecated by the maintainers as Marqo
  pivots to a hosted ecommerce search product, but the project remains widely
  forked, downloaded, and self-hosted, with active sibling repositories for the
  Python client, Terraform provider, InstantSearch client, ecommerce embedding
  models, and Generalised Contrastive Learning research.
type: Index
deliveryModel:
  model: open-core
  license: Apache-2.0
  license_evidence:
    repo: marqo-ai/marqo
    spdx: Apache-2.0
    stars: 5031
  open_source: true
  commercial: true
  callable_host: true
  label: Open core · an OSS project plus a commercial hosted product
  confidence: medium
  source:
  - openapi
  - pricing
  - repository-license
  generated: '2026-09-25'
  method: derived
accessModel:
  pricing: unknown
  onboarding: unknown
  trial: false
  try_now: false
  public: false
  label: Unknown
  confidence: low
  try_now_blocked_by: loopback
  source:
  - plans
  - authentication
  - security
  generated: '2026-09-03'
  method: derived
position: Consuming
access: 3rd-Party
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/marqo.png
x-docs-platform: docusaurus
x-docs-platform-confidence: medium
x-docs-platform-checked: 2026-10-03
x-docs-hosting: cloudflare-pages
tags:
  - Vector Search
  - Multi-Modal
  - Semantic Search
  - Embeddings
  - Artificial Intelligence
  - Machine Learning
  - Open Source
  - Ecommerce Search
tags_raw:
  - Vector Database
  - Vector Search
  - Multimodal
  - Semantic Search
  - Embeddings
  - AI
  - Machine Learning
  - Open Source
  - Ecommerce Search
  - Machine-Learning
  - Open-Source
url: https://raw.githubusercontent.com/api-evangelist/marqo/refs/heads/main/apis.yml
created: '2026-05-08'
modified: '2026-05-25'
specificationVersion: '0.23'
apis:
- aid: marqo:marqo-documents-api
  name: Marqo Documents API
  description: Add, update, get, and delete documents in an index.
  humanURL: https://docs.marqo.ai/
  baseURL: http://localhost:8882
  tags:
  - Documents
  properties:
  - type: OpenAPI
    url: openapi/marqo-documents-api-openapi.yml
  - type: Documentation
    url: https://docs.marqo.ai/
  - type: APIReference
    url: https://docs.marqo.ai/latest/
  - type: GettingStarted
    url: https://github.com/marqo-ai/marqo#getting-started
  - type: SourceCode
    url: https://github.com/marqo-ai/marqo
  - type: Deprecation
    url: https://github.com/marqo-ai/marqo
- aid: marqo:marqo-embeddings-api
  name: Marqo Embeddings API
  description: Generate embedding vectors using engine-loaded models.
  humanURL: https://docs.marqo.ai/
  baseURL: http://localhost:8882
  tags:
  - Embeddings
  properties:
  - type: OpenAPI
    url: openapi/marqo-embeddings-api-openapi.yml
  - type: Documentation
    url: https://docs.marqo.ai/
  - type: APIReference
    url: https://docs.marqo.ai/latest/
  - type: GettingStarted
    url: https://github.com/marqo-ai/marqo#getting-started
  - type: SourceCode
    url: https://github.com/marqo-ai/marqo
  - type: Deprecation
    url: https://github.com/marqo-ai/marqo
- aid: marqo:marqo-indexes-api
  name: Marqo Indexes API
  description: Create, list, inspect, and delete tensor / lexical indexes.
  humanURL: https://docs.marqo.ai/
  baseURL: http://localhost:8882
  tags:
  - Index
  tags_raw:
  - Indexes
  properties:
  - type: OpenAPI
    url: openapi/marqo-indexes-api-openapi.yml
  - type: Documentation
    url: https://docs.marqo.ai/
  - type: APIReference
    url: https://docs.marqo.ai/latest/
  - type: GettingStarted
    url: https://github.com/marqo-ai/marqo#getting-started
  - type: SourceCode
    url: https://github.com/marqo-ai/marqo
  - type: Deprecation
    url: https://github.com/marqo-ai/marqo
- aid: marqo:marqo-models-api
  name: Marqo Models API
  description: Inspect, load, and eject embedding models from the engine.
  humanURL: https://docs.marqo.ai/
  baseURL: http://localhost:8882
  tags:
  - Models
  properties:
  - type: OpenAPI
    url: openapi/marqo-models-api-openapi.yml
  - type: Documentation
    url: https://docs.marqo.ai/
  - type: APIReference
    url: https://docs.marqo.ai/latest/
  - type: GettingStarted
    url: https://github.com/marqo-ai/marqo#getting-started
  - type: SourceCode
    url: https://github.com/marqo-ai/marqo
  - type: Deprecation
    url: https://github.com/marqo-ai/marqo
- aid: marqo:marqo-recommendations-api
  name: Marqo Recommendations API
  description: Return documents similar to one or more reference documents.
  humanURL: https://docs.marqo.ai/
  baseURL: http://localhost:8882
  tags:
  - Recommendations
  properties:
  - type: OpenAPI
    url: openapi/marqo-recommendations-api-openapi.yml
  - type: Documentation
    url: https://docs.marqo.ai/
  - type: APIReference
    url: https://docs.marqo.ai/latest/
  - type: GettingStarted
    url: https://github.com/marqo-ai/marqo#getting-started
  - type: SourceCode
    url: https://github.com/marqo-ai/marqo
  - type: Deprecation
    url: https://github.com/marqo-ai/marqo
- aid: marqo:marqo-search-api
  name: Marqo Search API
  description: Tensor, lexical, and hybrid search across an index.
  humanURL: https://docs.marqo.ai/
  baseURL: http://localhost:8882
  tags:
  - Search
  properties:
  - type: OpenAPI
    url: openapi/marqo-search-api-openapi.yml
  - type: Documentation
    url: https://docs.marqo.ai/
  - type: APIReference
    url: https://docs.marqo.ai/latest/
  - type: GettingStarted
    url: https://github.com/marqo-ai/marqo#getting-started
  - type: SourceCode
    url: https://github.com/marqo-ai/marqo
  - type: Deprecation
    url: https://github.com/marqo-ai/marqo
- aid: marqo:marqo-telemetry-api
  name: Marqo Telemetry API
  description: Health, readiness, and engine-level metadata.
  humanURL: https://docs.marqo.ai/
  baseURL: http://localhost:8882
  tags:
  - Telemetry
  properties:
  - type: OpenAPI
    url: openapi/marqo-telemetry-api-openapi.yml
  - type: Documentation
    url: https://docs.marqo.ai/
  - type: APIReference
    url: https://docs.marqo.ai/latest/
  - type: GettingStarted
    url: https://github.com/marqo-ai/marqo#getting-started
  - type: SourceCode
    url: https://github.com/marqo-ai/marqo
  - type: Deprecation
    url: https://github.com/marqo-ai/marqo
common:
  - type: CapabilityMap
    url: capabilities/marqo-capability-edges.yml
    name: Marqo Business Capability Map
  - type: IssueTracker
    url: https://github.com/marqo-ai/marqo/issues
  - type: Releases
    url: https://github.com/marqo-ai/marqo/releases
  - type: SecurityPolicy
    url: https://github.com/marqo-ai/marqo/blob/mainline/SECURITY.md
  - type: CodeOfConduct
    url: https://github.com/marqo-ai/marqo/blob/mainline/CODE_OF_CONDUCT.md
  - type: ContributionGuide
    url: https://github.com/marqo-ai/marqo/blob/mainline/CONTRIBUTING.md
  - type: AgenticAccess
    url: agentic-access/marqo-agentic-access.yml
  - type: DomainSecurity
    url: security/marqo-domain-security.yml
  - type: Authentication
    url: authentication/marqo-authentication.yml
  - type: Website
    url: https://www.marqo.ai/
  - type: GitHubOrganization
    url: https://github.com/marqo-ai
  - type: GitHubRepository
    url: https://github.com/marqo-ai/marqo
  - type: LinkedIn
    url: https://www.linkedin.com/company/marqo-ai
  - type: Documentation
    url: https://docs.marqo.ai/
  - type: GettingStarted
    url: https://github.com/marqo-ai/marqo#getting-started
  - type: License
    url: https://github.com/marqo-ai/marqo/blob/mainline/LICENSE
  - type: Blog
    url: https://www.marqo.ai/blog/
  - type: Pricing
    url: https://www.marqo.ai/pricing
  - type: Plans
    url: plans/marqo-plans-pricing.yml
  - type: RateLimits
    url: rate-limits/marqo-rate-limits.yml
  - type: FinOps
    url: finops/marqo-finops.yml
  - type: SDKs
    name: py-marqo (Python client)
    url: https://github.com/marqo-ai/py-marqo
  - type: SDKs
    name: marqo-instantsearch-client (TypeScript)
    url: https://github.com/marqo-ai/marqo-instantsearch-client
  - type: Tools
    name: terraform-provider-marqo
    url: https://github.com/marqo-ai/terraform-provider-marqo
  - type: Tools
    name: marqo-base (Docker base image)
    url: https://github.com/marqo-ai/marqo-base
  - type: Tools
    name: ingrain_server (Sentence Transformers / CLIP serving)
    url: https://github.com/marqo-ai/ingrain_server
  - type: Models
    name: marqo-ecommerce-embeddings
    url: https://github.com/marqo-ai/marqo-ecommerce-embeddings
  - type: Models
    name: marqo-FashionCLIP
    url: https://github.com/marqo-ai/marqo-FashionCLIP
  - type: Research
    name: Generalised Contrastive Learning (GCL)
    url: https://github.com/marqo-ai/GCL
  - type: Examples
    name: local-image-search-demo
    url: https://github.com/marqo-ai/local-image-search-demo
  - type: Course
    name: Fine-Tuning Embedding Models for Semantic Search
    url: https://github.com/marqo-ai/fine-tuning-embedding-models-course
  - type: Features
    data:
      - Open-source Apache 2.0 vector search engine (project marked deprecated by maintainers; still 5,000+ stars and actively forked)
      - Single `docker run` install bundling Vespa storage and embedding model inference
      - Tensor, lexical, and hybrid search through a unified REST API
      - Multimodal indexing of text and images with on-engine inference
      - Embedding generation via Sentence Transformers, OpenCLIP, and ONNX models
      - Generalised Contrastive Learning (GCL) framework for fine-tuned retrieval
      - Marqo-FashionCLIP and marqo-ecommerce-embeddings open-weight models
      - Recommendations, filters, and structured + unstructured fields
      - FastAPI runtime exposing live `/openapi.json` and Swagger UI at `/docs`
      - Compose files for inference, model management, and Triton-backed serving
      - Python client (py-marqo), Terraform provider, and InstantSearch client
      - Hosted Marqo Cloud surface preserves API parity for legacy users
    sources:
      - https://github.com/marqo-ai/marqo
      - https://github.com/marqo-ai
    updated: '2026-05-25'
  - type: UseCases
    data:
      - name: Multimodal Semantic Search
        description: Index text and images into a single tensor store and query with natural-language or image inputs, with embedding inference running inside the engine.
      - name: Retrieval-Augmented Generation
        description: Power RAG pipelines by serving the nearest-neighbor retrieval layer for LLM context windows over private corpora.
      - name: Ecommerce Product Discovery
        description: Drive product search, recommendations, and merchandising-aware ranking using semantic relevance plus structured filters and boosts.
      - name: Visual Search
        description: Search product catalogs and image libraries using image-to-image and text-to-image similarity through OpenCLIP / Marqo-FashionCLIP.
      - name: Self-Hosted Vector Backend
        description: >-
          Stand up an Apache 2.0 vector search service alongside your application stack with `docker run`, no
          separate embedding service required.
  - type: Integrations
    data:
      - name: Vespa
        description: Vespa is the underlying storage and retrieval engine that backs every Marqo index.
      - name: Sentence Transformers
        description: Default text embedding model family loaded by the engine for tensor search.
      - name: OpenCLIP
        description: Multimodal text-and-image embedding family used for visual and cross-modal search.
      - name: Hugging Face
        description: Models are pulled from Hugging Face hubs at first use unless preloaded.
      - name: NVIDIA Triton
        description: >-
          `compose-triton.yaml` ships a Triton-backed model server profile for GPU inference.
      - name: Terraform
        description: terraform-provider-marqo manages Marqo Cloud indexes as infrastructure-as-code.
      - name: Algolia InstantSearch
        description: marqo-instantsearch-client adapts Marqo to the InstantSearch.js front-end conventions.
      - name: Shopify
        description: Hosted Marqo product offers one-click integration for Shopify catalogs.
      - name: Adobe Commerce
        description: Hosted Marqo product offers Adobe Commerce / Magento connector.
      - name: Salesforce Commerce Cloud
        description: Hosted Marqo product offers Salesforce Commerce Cloud connector.
maintainers:
  - FN: Kin Lane
    email: kin@apievangelist.com