# Constructor.io

**Canonical:** https://apis.io/providers/constructorio/  
**Website:** https://constructor.com/  
**APIs profiled:** 18

Constructor (Constructor.io) is an AI-powered ecommerce search and product discovery platform for online retailers. Its APIs cover autocomplete/autosuggest, keyword and natural-language search, image search, category browse, recommendations, quizzes, collections, offsite/email discovery, retail media (sponsored listings and display ads), an AI Shopping Agent and Product Insights Agent, plus a full catalog-management and configuration surface for items, variations, item groups, facets, searchabilities, synonyms, sort options, redirects and searchandising rules. Results are optimized against ecommerce KPIs (conversion, revenue per visit) using natural-language processing, behavioral re-ranking and per-user personalization, and are delivered through a REST API served from the ac.cnstrc.com family of hosts with first-party client libraries for JavaScript, Node.js, Python, Java, .NET, Ruby, Swift and Kotlin.

## Kin Score — 51.4 / 100 (developing)

Scored 2026-08-25 under rubric 0.14.0. Trend: flat (+0.0 from 51.4).

| Facet | Score |
|---|---|
| Discoverability | 81.5 |
| Contract Quality | 60.6 |
| Governance | 30.3 |
| Contract Governance | 30.3 |
| Operational Transparency | 22.4 |
| Developer Ergonomics | 57.7 |
| Commercial Clarity | 50.0 |
| Access Clarity | 50.0 |

## Agent readiness — 28.1 (agent-aware)

| Dimension | Value |
|---|---|
| Spec Presence | yes |
| Agentic Access | no |
| Reversibility Documented | no |
| MCP Server | documented |
| Auth Clarity | bearer |
| Idempotency | no |
| Error Semantics | verified |
| OpenAPI Examples | partial |
| Rate Limit Signal | no |
| Event Surface Described | no |
| Agent Skills | derived |
| Well Known Catalog | no |
| Consent Identity | no |
| Agent Card | no |
| Dry Run Mode | no |
| Delegated Identity | no |
| Protected Resource Metadata | no |
| Dynamic Client Registration | no |
| Agentic Commerce | no |

## APIs (18)

- **Constructor Search API** — AI-optimized keyword and natural-language search results for products and other index sections, returned by search query with filtering, faceting, sorting, pagination and variat...
- **Constructor Autocomplete API** — AI-optimized autocomplete and autosuggest results for products and search suggestions retrieved by query prefix, with multi-section responses.
- **Constructor Browse API** — AI-optimized category browse results by facet name/value, item ID, collection ID or group ID, plus endpoints for browse groups, countable facets, facet options and collections.
- **Constructor Recommendations API** — AI-optimized recommendation results retrieved by pod identifier for onsite recommendation placements.
- **Constructor Image Search API** — AI-optimized search results retrieved by uploaded image, with optional multi-item detection (segmentation) support.
- **Constructor AI Shopping Agent API** — Conversational product-discovery API returning intent-based suggestions over a Server-Sent Events stream, plus AI-generated item questions and answers.
- **Constructor Catalog Management API** — Authenticated catalog surface for creating, replacing, updating and deleting items, variations, item groups and full catalog files, plus item field statistics and asynchronous t...
- **Constructor Catalog Batching API** — Batched catalog ingestion service for high-volume item and variation update and delete operations.
- **Constructor Configuration API** — Authenticated configuration surface for facets, facet options, searchabilities, one-way synonyms, synonym groups, sort options, redirect rules, collections, quizzes and metadata...
- **Constructor Searchandising API** — Merchandising-rule surface for refined queries, refined filters, refined collections, refined tags, campaigns and facet-rule campaigns across search, browse and collections.
- **Constructor Quizzes API** — Guided-selling quiz surface returning the next question given prior answers, quiz results and results-page configuration.
- **Constructor Offsite Discovery Recommendations API** — Recommendation and collection results for offsite channels (email, SMS, push, social, paid media), including redirecting item image and item URL endpoints addressable by pod/col...
- **Constructor Retail Media API** — Retail media surface for updating advertiser engagement suspension status and retrieving per-advertiser ad spend accrued within an index.
- **Constructor Retail Media Display Ads API** — Display-ads surface returning ads for each requested placement, with banner and multi-banner placement responses ordered by auction rank.
- **Constructor Product Details API** — Retrieval of item and variation product-detail records for a given index.
- **Constructor Behavioral Actions API** — Offline behavioral-action ingestion for submitting user events (such as purchases and conversions) that feed Constructor's KPI-optimized ranking.
- **Constructor User Profile API** — Creation of user preference records that personalize discovery results for an identified shopper.
- **Constructor Documentation MCP Server** — Remote, anonymously reachable Model Context Protocol server published by Constructor that exposes documentation search/fetch and OpenAPI endpoint discovery tools to AI coding to...

## MCP servers (1)

- **Constructor.io MCP Server**

## Security (3)

- **Constructorio Authentication** — http · 2 schemes
- **Constructorio Domain Security** — TLSv1.3 · HSTS · DNSSEC · DMARC
- **Constructorio Trust Center** — SOC 2 Type 2, ISO 27001, CCPA, MACH Certified

## Tags

Company, Search, E-Commerce, Product Discovery, Recommendations, Personalization, Retail, Retail Media, Artificial Intelligence, Merchandising, Catalog Management, Agentic Commerce

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/constructorio/). Scores are computed from the provider's own public artifacts under a published rubric.