Home
Providers
Marqo
Marqo
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.
Marqo publishes 7 APIs on the APIs.io network, including Documents API, Embeddings API, Indexes API, and 4 more. Tagged areas include Vector Database, Vector Search, Multi-Modal, Semantic Search, and Embeddings.
Marqo’s developer surface includes authentication, documentation, getting-started guide, engineering blog, pricing, tooling, code examples, and 23 more developer resources.
7 APIs
12 Features
5 Use Cases
On this page
Kin Score
APIs 7
Open Collections 9
Pricing Plans 1
Rate Limits 1
FinOps 1
Features 12
Security Posture 2
Agentic Access 1
Use Cases 5
Integrations 10
Resources 30
apis.yml
34 Operational Transparency
Composite quality — 36.7/100 · thin
Contract Quality
12.4 / 25
Developer Ergonomics
8.6 / 20
Operational Transparency
4.4 / 13
Contract Governance
0.0 / 12
Agent readiness — 21/100 · agent aware
Machine-Readable Contract
18 / 18
Agentic Access Contract
10 / 10
Documented Reversibility
0 / 6
MCP Server
0 / 12
Machine-Readable Auth
10 / 10
Idempotency
0 / 9
Stable Error Semantics
0 / 8
Request/Response Examples
7 / 7
Rate-Limit Signaling
7 / 7
Typed Event Surface
0 / 6
Agent Skills
0 / 5
Well-Known Catalog
0 / 4
Consent & Bot Identity
0 / 3
A2A Agent Card
0 / 8
Dry-Run / Simulate Mode
0 / 4
Delegated User Identity
0 / 6
Protected Resource Metadata
0 / 5
Registration Without a Human
0 / 6
Agentic Commerce Surface
0 / 5
Individual APIs this provider publishes, each with its own machine-readable definition.
Scroll for all 7
Open, tool-agnostic API collections (OpenAPI-derived and Bruno).
Scroll for all 9
Published pricing tiers and plan structures.
Documented rate limits and quota policies.
Cost, billing, and metering signals for API financial operations.
Notable capabilities this provider offers.
Scroll for all 12
Authentication, domain security, vulnerability disclosure, and trust-center signals.
Recommended x-agentic-access execution contracts for AI agents.
What developers build with this provider.
Pre-built integrations with other platforms and tools.
Scroll for all 10
Get Started 1
Portal, sign-up, and the first successful call
Documentation 2
Reference material describing how the API behaves
Agent Surfaces 1
MCP servers, agent skills, and machine-readable catalogs
Build 9
SDKs, sample code, and the tooling you integrate with
Scroll for all 9
Access & Security 3
Authentication, authorization, and security posture
Learn 1
Tutorials, courses, talks, and written guidance
Operate 3
Status, limits, changes, and where to get help
Commercial 4
Pricing, plans, and the legal terms of use
Company 3
The organization behind the API
Other 3
Properties that don't map to a standard resource type
Source (apis.yml)
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
accessModel:
pricing: unknown
onboarding: self-serve
trial: false
try_now: false
public: false
label: Self-serve signup
confidence: high
source:
- plans
- authentication
generated: '2026-07-22'
method: derived
position: Consumer
access: 3rd-Party
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/marqo.png
tags:
- Vector Database
- 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
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:
- 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: 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
Every provider 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 providers
9 MCP tools reach this
find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
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 provider
curl "https://apis.io/api/v1/providers/marqo"
All providers
curl "https://apis.io/api/v1/providers?limit=25"
Every operation they expose
curl "https://apis.io/api/v1/providers/marqo/operations?limit=25"
How their score was established
curl "https://apis.io/api/v1/providers/marqo/evidence"
Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no email required.
A second provider on the same verified email joins the account you already have.