Constructor.io

aid: constructorio
name: Constructor.io
description: 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.
image: https://constructor.com/hubfs/constructor-featured-image-2026.png
url: https://raw.githubusercontent.com/api-evangelist/constructorio/refs/heads/main/apis.yml
x-type: company
x-source: harvest:secondary-market
specificationVersion: '0.20'
created: '2026-08-01'
modified: '2026-08-01'
tags:
- Company
- Search
- Ecommerce
- Product Discovery
- Recommendations
- Personalization
- Retail
- Retail Media
- Artificial Intelligence
- Merchandising
- Catalog Management
- Agentic Commerce
apis:
- name: Constructor Search API
  description: AI-optimized keyword and natural-language search results for products and other index sections, returned by
    search query with filtering, faceting, sorting, pagination and variations mapping.
  humanURL: https://docs.constructor.com/reference/search-search-results
  baseURL: https://ac.cnstrc.com
  tags:
  - search
  - natural-language-search
  - ecommerce
  properties:
  - type: OpenAPI
    url: openapi/constructorio-search-openapi.yml
  - type: APIReference
    url: https://docs.constructor.com/reference/search-search-results
  - type: Overlay
    url: overlays/constructorio-search-overlay.yaml
- name: Constructor Autocomplete API
  description: AI-optimized autocomplete and autosuggest results for products and search suggestions retrieved by query prefix,
    with multi-section responses.
  humanURL: https://docs.constructor.com/reference/autocomplete-autocomplete-results
  baseURL: https://ac.cnstrc.com
  tags:
  - autocomplete
  - autosuggest
  - search
  properties:
  - type: OpenAPI
    url: openapi/constructorio-autocomplete-openapi.yml
  - type: APIReference
    url: https://docs.constructor.com/reference/autocomplete-autocomplete-results
  - type: Overlay
    url: overlays/constructorio-autocomplete-overlay.yaml
- name: Constructor Browse API
  description: 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.
  humanURL: https://docs.constructor.com/reference/browse-browse-results
  baseURL: https://ac.cnstrc.com
  tags:
  - browse
  - facets
  - collections
  properties:
  - type: OpenAPI
    url: openapi/constructorio-browse-openapi.yml
  - type: APIReference
    url: https://docs.constructor.com/reference/browse-browse-results
  - type: Overlay
    url: overlays/constructorio-browse-overlay.yaml
- name: Constructor Recommendations API
  description: AI-optimized recommendation results retrieved by pod identifier for onsite recommendation placements.
  humanURL: https://docs.constructor.com/reference/recommendations-recommendation-results
  baseURL: https://ac.cnstrc.com
  tags:
  - recommendations
  - personalization
  properties:
  - type: OpenAPI
    url: openapi/constructorio-recommendations-openapi.yml
  - type: APIReference
    url: https://docs.constructor.com/reference/recommendations-recommendation-results
  - type: Overlay
    url: overlays/constructorio-recommendations-overlay.yaml
- name: Constructor Image Search API
  description: AI-optimized search results retrieved by uploaded image, with optional multi-item detection (segmentation)
    support.
  humanURL: https://docs.constructor.com/reference/image-search-image-search-results
  baseURL: https://image-search.cnstrc.com
  tags:
  - image-search
  - visual-search
  properties:
  - type: OpenAPI
    url: openapi/constructorio-image-search-openapi.yml
  - type: APIReference
    url: https://docs.constructor.com/reference/image-search-image-search-results
  - type: Overlay
    url: overlays/constructorio-image-search-overlay.yaml
- name: Constructor AI Shopping Agent API
  description: Conversational product-discovery API returning intent-based suggestions over a Server-Sent Events stream, plus
    AI-generated item questions and answers.
  humanURL: https://docs.constructor.com/reference/v1-asa-retrieve-intent
  baseURL: https://agent.cnstrc.com
  tags:
  - ai-agent
  - conversational-commerce
  - server-sent-events
  properties:
  - type: OpenAPI
    url: openapi/constructorio-ai-shopping-agent-openapi.yml
  - type: APIReference
    url: https://docs.constructor.com/reference/v1-asa-retrieve-intent
  - type: Overlay
    url: overlays/constructorio-ai-shopping-agent-overlay.yaml
- name: Constructor Catalog Management API
  description: Authenticated catalog surface for creating, replacing, updating and deleting items, variations, item groups
    and full catalog files, plus item field statistics and asynchronous task tracking.
  humanURL: https://docs.constructor.com/reference/catalog-management-introduction
  baseURL: https://ac.cnstrc.com
  tags:
  - catalog
  - items
  - variations
  properties:
  - type: OpenAPI
    url: openapi/constructorio-catalog-management-openapi.yml
  - type: APIReference
    url: https://docs.constructor.com/reference/catalog-management-introduction
  - type: Overlay
    url: overlays/constructorio-catalog-management-overlay.yaml
- name: Constructor Catalog Batching API
  description: Batched catalog ingestion service for high-volume item and variation update and delete operations.
  humanURL: https://docs.constructor.com/reference/v2-batching-items-update-items
  baseURL: https://batching.catalog.cnstrc.com
  tags:
  - catalog
  - batching
  - ingestion
  properties:
  - type: OpenAPI
    url: openapi/constructorio-catalog-batching-openapi.yml
  - type: APIReference
    url: https://docs.constructor.com/reference/v2-batching-items-update-items
  - type: Overlay
    url: overlays/constructorio-catalog-batching-overlay.yaml
- name: Constructor Configuration API
  description: Authenticated configuration surface for facets, facet options, searchabilities, one-way synonyms, synonym groups,
    sort options, redirect rules, collections, quizzes and metadata overrides.
  humanURL: https://docs.constructor.com/reference/configuration-facets
  baseURL: https://ac.cnstrc.com
  tags:
  - configuration
  - facets
  - synonyms
  - redirects
  properties:
  - type: OpenAPI
    url: openapi/constructorio-configuration-openapi.yml
  - type: APIReference
    url: https://docs.constructor.com/reference/configuration-facets
  - type: Overlay
    url: overlays/constructorio-configuration-overlay.yaml
- name: Constructor Searchandising API
  description: Merchandising-rule surface for refined queries, refined filters, refined collections, refined tags, campaigns
    and facet-rule campaigns across search, browse and collections.
  humanURL: https://docs.constructor.com/reference/searchandising-searchandising-for-search
  baseURL: https://ac.cnstrc.com
  tags:
  - searchandising
  - merchandising
  - campaigns
  properties:
  - type: OpenAPI
    url: openapi/constructorio-searchandising-openapi.yml
  - type: APIReference
    url: https://docs.constructor.com/reference/searchandising-searchandising-for-search
  - type: Overlay
    url: overlays/constructorio-searchandising-overlay.yaml
- name: Constructor Quizzes API
  description: Guided-selling quiz surface returning the next question given prior answers, quiz results and results-page
    configuration.
  humanURL: https://docs.constructor.com/reference/v1-quizzes-get-next-question
  baseURL: https://quizzes.cnstrc.com
  tags:
  - quizzes
  - guided-selling
  properties:
  - type: OpenAPI
    url: openapi/constructorio-quizzes-openapi.yml
  - type: APIReference
    url: https://docs.constructor.com/reference/v1-quizzes-get-next-question
  - type: Overlay
    url: overlays/constructorio-quizzes-overlay.yaml
- name: Constructor Offsite Discovery Recommendations API
  description: Recommendation and collection results for offsite channels (email, SMS, push, social, paid media), including
    redirecting item image and item URL endpoints addressable by pod/collection and position.
  humanURL: https://docs.constructor.com/reference/offsite-discovery-recommendations-offsite-discovery-results
  baseURL: https://offsite-discovery.cnstrc.com
  tags:
  - offsite-discovery
  - email-recommendations
  - cross-channel
  properties:
  - type: OpenAPI
    url: openapi/constructorio-offsite-discovery-recommendations-openapi.yml
  - type: APIReference
    url: https://docs.constructor.com/reference/offsite-discovery-recommendations-offsite-discovery-results
  - type: Overlay
    url: overlays/constructorio-offsite-discovery-recommendations-overlay.yaml
- name: Constructor Retail Media API
  description: Retail media surface for updating advertiser engagement suspension status and retrieving per-advertiser ad
    spend accrued within an index.
  humanURL: https://docs.constructor.com/reference/v1-engagements-update
  baseURL: https://retail.media-cnstrc.com
  tags:
  - retail-media
  - sponsored-listings
  - advertising
  properties:
  - type: OpenAPI
    url: openapi/constructorio-retail-media-openapi.yml
  - type: APIReference
    url: https://docs.constructor.com/reference/v1-engagements-update
  - type: Overlay
    url: overlays/constructorio-retail-media-overlay.yaml
- name: Constructor Retail Media Display Ads API
  description: Display-ads surface returning ads for each requested placement, with banner and multi-banner placement responses
    ordered by auction rank.
  humanURL: https://docs.constructor.com/reference/v2-display-ads-retrieve-display-ads
  baseURL: https://display.media-cnstrc.com
  tags:
  - retail-media
  - display-ads
  - advertising
  properties:
  - type: OpenAPI
    url: openapi/constructorio-retail-media-display-ads-openapi.yml
  - type: APIReference
    url: https://docs.constructor.com/reference/v2-display-ads-retrieve-display-ads
  - type: Overlay
    url: overlays/constructorio-retail-media-display-ads-overlay.yaml
- name: Constructor Product Details API
  description: Retrieval of item and variation product-detail records for a given index.
  humanURL: https://docs.constructor.com/reference/v1-product-details-get-items
  baseURL: https://product-details.cnstrc.com
  tags:
  - product-details
  - catalog
  properties:
  - type: OpenAPI
    url: openapi/constructorio-product-details-openapi.yml
  - type: APIReference
    url: https://docs.constructor.com/reference/v1-product-details-get-items
  - type: Overlay
    url: overlays/constructorio-product-details-overlay.yaml
- name: Constructor Behavioral Actions API
  description: Offline behavioral-action ingestion for submitting user events (such as purchases and conversions) that feed
    Constructor's KPI-optimized ranking.
  humanURL: https://docs.constructor.com/reference/v1-offline-behavioral-actions-create-actions
  baseURL: https://ac.cnstrc.com
  tags:
  - behavioral-data
  - analytics
  - events
  properties:
  - type: OpenAPI
    url: openapi/constructorio-behavioral-actions-openapi.yml
  - type: APIReference
    url: https://docs.constructor.com/reference/v1-offline-behavioral-actions-create-actions
  - type: Overlay
    url: overlays/constructorio-behavioral-actions-overlay.yaml
- name: Constructor User Profile API
  description: Creation of user preference records that personalize discovery results for an identified shopper.
  humanURL: https://docs.constructor.com/reference/v1-user-profile-create-preferences
  baseURL: https://user-profile.cnstrc.com
  tags:
  - user-profile
  - personalization
  properties:
  - type: OpenAPI
    url: openapi/constructorio-user-profile-openapi.yml
  - type: APIReference
    url: https://docs.constructor.com/reference/v1-user-profile-create-preferences
  - type: Overlay
    url: overlays/constructorio-user-profile-overlay.yaml
- name: Constructor Documentation MCP Server
  description: Remote, anonymously reachable Model Context Protocol server published by Constructor that exposes documentation
    search/fetch and OpenAPI endpoint discovery tools to AI coding tools such as Claude, Cursor and Windsurf.
  humanURL: https://docs.constructor.com/docs/ai-tooling-mcp-server
  baseURL: https://docs.constructor.com/mcp
  tags:
  - mcp
  - agent-native
  - documentation
  properties:
  - type: MCPServer
    url: mcp/constructorio-mcp.yml
  - type: ToolCrosswalk
    url: mcp/constructorio-tool-crosswalk.yml
  - type: Documentation
    url: https://docs.constructor.com/docs/ai-tooling-mcp-server
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
- FN: APIs.json
  email: info@apis.io
common:
- type: Website
  url: https://constructor.com/
- type: DeveloperPortal
  url: https://docs.constructor.com/
- type: Documentation
  url: https://docs.constructor.com/
- type: APIReference
  url: https://docs.constructor.com/reference/main-readme
- type: GettingStarted
  url: https://docs.constructor.com/docs/integrating-with-constructor-retrieving-results-getting-started
- type: Support
  url: https://docs.constructor.com/docs/integrating-with-constructor-customer-support-guide
- type: Blog
  url: https://constructor.com/blog
- type: GitHubOrganization
  url: https://github.com/Constructor-io
- type: SignUp
  url: https://info.constructor.com/ecommerce-search-discovery-demo
- type: Login
  url: https://app.constructor.io/users/sign_in
- type: TermsOfService
  url: https://constructor.com/terms-of-service-agreement/
- type: PrivacyPolicy
  url: https://constructor.com/privacy-policy
- type: Compliance
  url: https://constructor.com/security-and-compliance
- type: StatusPage
  url: https://constructor.status.io/
- type: ChangeLog
  url: https://releases.constructor.io/
- type: SDKs
  url: packages/constructorio-packages.yml
- type: Packages
  url: packages/constructorio-packages.yml
- type: CLI
  url: cli/constructorio-cli.yml
- type: Components
  url: components/constructorio-components.yml
- type: Authentication
  url: authentication/constructorio-authentication.yml
- type: OAuthScopes
  url: scopes/constructorio-scopes.yml
- type: Conventions
  url: conventions/constructorio-conventions.yml
- type: ErrorCatalog
  url: errors/constructorio-problem-types.yml
- type: Lifecycle
  url: lifecycle/constructorio-lifecycle.yml
- type: Deprecation
  url: https://docs.constructor.com/reference/configuration-facets-and-searchabilities-v2-migration-guide
- type: Conformance
  url: conformance/constructorio-conformance.yml
- type: TrustCenter
  url: security/constructorio-trust-center.yml
- type: DomainSecurity
  url: security/constructorio-domain-security.yml
- type: WellKnown
  url: well-known/constructorio-well-known.yml
- type: LLMsTxt
  url: llms/constructorio-llms.txt
- type: DataModel
  url: data-model/constructorio-data-model.yml
- type: ChangeLog
  url: changelog/constructorio-changelog.yml
- type: AgentSkill
  url: skills/_index.yml
x-enrichment:
  date: '2026-08-01'
  status: enriched
  artifacts_added: 76
  pass: local-v1