Constructor.io
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.
Real signal across most facets with visible, nameable gaps — the contract exists but is thin, or the portal is good while governance and commercial terms are absent.
API Evangelist profiles Constructor.io the way a machine reads it — 40 machine-readable artifacts across 18 APIs, pulled from the provider's own public surface and indexed so a developer, an analyst, or an AI agent can evaluate it against every other provider on the network.
Every provider in the network is reduced to the same set of machine-readable artifacts — OpenAPI contracts, event specifications, GraphQL schemas, runnable collections, pricing and rate-limit signals, security posture, OAuth scopes, and the agent surfaces (MCP servers and skills) that let software drive the API on its own. We profile them because the interface is the part of a company you can actually inspect: it is a truer signal of what a provider does than any marketing page. From those artifacts we compute the Kin Score — Constructor.io scores 55.0/100 (developing), with a separate agent-readiness read of 37/100 (agent ready). The full breakdown is below, followed by every artifact we hold — each card links through to its machine-readable definition on apis.io.
Kin Score
This is the API Evangelist rating — a single, repeatable read computed from the artifacts on this page. Green fill is points earned; the red track is points possible, so every bar shows earned-versus-possible at a glance.
Kin Score
How this is scored →scored 2026-08-17 · rubric v0.11.0
Put this on your own site. The badge is drawn live from Constructor.io's current Kin Score — paste it once and it updates itself every time the score is recomputed. It follows your visitor's light or dark setting, and it links back here so anyone who sees it can read the full breakdown.
<!-- Kin Score · API Evangelist -->
<a href="https://providers.apievangelist.com/providers/constructorio/"
title="Constructor.io on API Evangelist — API profile and Kin Score">
<img src="https://apis.io/badge/constructorio.svg"
alt="Constructor.io Kin Score — API readiness rating by API Evangelist" width="150" height="150" loading="lazy">
</a>[](https://providers.apievangelist.com/providers/constructorio/)<!-- Kin Score · API Evangelist -->
<a href="https://providers.apievangelist.com/providers/constructorio/"
title="Constructor.io on API Evangelist — API profile and Kin Score">
<img src="https://apis.io/badge/constructorio/card.svg"
alt="Constructor.io Kin Score — API readiness rating by API Evangelist" width="340" height="120" loading="lazy">
</a>More shapes, themes and sizes → · Score as JSON · How badges work
How we profile Constructor.io
Each block below is one kind of artifact we hold for Constructor.io. For each we say what it is and why it earns a place in the profile, then list every one we've indexed — capped at two rows, scroll within the panel for the rest.
APIs 18
Each API is captured as its own OpenAPI definition — every operation, parameter, and response. This is the single most useful machine-readable description of what an API does, and it's what lets us score, lint, mock, and generate against it without asking the provider for anything.
Individual APIs this provider publishes, each with its own machine-readable definition.
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...
Scroll within the panel for all 18 ·
Open Collections 17
Open, tool-agnostic collections carry the same runnable value as Postman without locking you to one client — the portable, forkable form of the same exercise.
Open, tool-agnostic API collections (OpenAPI-derived and Bruno).
AI Shopping Agent
OPEN COLLECTIONAutocomplete
OPEN COLLECTIONBehavioral actions
OPEN COLLECTIONBrowse
OPEN COLLECTIONCatalog Batching Service
OPEN COLLECTIONCatalog management
OPEN COLLECTIONConfiguration
OPEN COLLECTIONImage Search
OPEN COLLECTIONOffsite Discovery recommendations
OPEN COLLECTIONProduct details
OPEN COLLECTIONQuizzes
OPEN COLLECTIONRecommendations
OPEN COLLECTIONRetail Media - Display Ads
OPEN COLLECTIONRetail Media
OPEN COLLECTIONSearch
OPEN COLLECTIONSearchandising
OPEN COLLECTIONUser profile
OPEN COLLECTIONScroll within the panel for all 17 ·
MCP Servers 1
Model Context Protocol servers expose these APIs directly to AI agents. We profile them because agent-native access is the fastest-growing way this provider's capabilities actually get used.
Model Context Protocol servers that expose these APIs to AI agents.
constructorio-mcp.yml
MCP SERVERSecurity Posture 3
Authentication, domain security, vulnerability disclosure, and trust-center signals — the evidence that a provider takes security seriously enough to document it. We profile it because you can't govern what you can't see.
Authentication, domain security, vulnerability disclosure, and trust-center signals.
Scopes 1
OAuth scopes are the vocabulary of least-privilege access. Profiling them shows exactly what an integration — or an agent acting on a user's behalf — is allowed to do.
OAuth scopes governing access to this provider's APIs.
Resources
Every other property we hold for Constructor.io — documentation, portals, status pages, policies, and corporate surface — grouped by the job it does, following the integrator's arc from getting started to running in production.
Get Started 4
Portal, sign-up, and the first successful call
Documentation 2
Reference material describing how the API behaves
Agent Surfaces 3
MCP servers, agent skills, and machine-readable catalogs
Design & Contract 6
Pagination, idempotency, versioning, errors, and events
Build 4
SDKs, sample code, and the tooling you integrate with
Access & Security 5
Authentication, authorization, and security posture
Operate 5
Status, limits, changes, and where to get help
Commercial 2
Pricing, plans, and the legal terms of use
Company 2
The organization behind the API
← All providers · Data indexed from github.com/api-evangelist/constructorio · machine-readable index on apis.io
This is an independent, third-party profile of Constructor.io, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.
The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.
Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.
info@apievangelist.com
·
Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and
you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.