How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Constructor.io Facets API

The Facets API from Constructor.io — 6 operation(s) for facets.

Constructor.io Facets API is one of 39 APIs that Constructor.io publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Facets. The published artifact set on APIs.io includes an OpenAPI specification and an API reference.

This API exposes 23 operations across 6 paths, and defines 62 schemas. It is described by OpenAPI 3.2.0, at version 0.1.

Requests are made against a single base URL, https://ac.cnstrc.com.

23 operations 6 paths 62 schemas 3 DELETE6 GET6 PATCH3 POST5 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
0.1
Base URL
https://ac.cnstrc.com
Authentication
HTTP Basic, HTTP Bearer
Resource Areas
1

Authentication & Security 2

Constructor.io Facets API declares 2 security schemes for authenticating requests. It accepts HTTP basic authentication (http_basic_auth). It accepts HTTP bearer tokens (http_bearer_auth).

Paths & Operations 23

Across 6 paths, the API surfaces 23 operations — 3 DELETE, 6 GET, 6 PATCH, 3 POST, 5 PUT. Each is listed below with its method, path, parameters, and response codes.

Facets 23
GET
/v1/facetsdeprecated
Retrieve facet configurations (Deprecated)
v1-facets-retrieve-facets 6 params → 200400401403429
POST
/v1/facetsdeprecated
Create facet configuration (Deprecated)
v1-facets-create-facet 3 params body → 200400401403429
PUT
/v1/facetsdeprecated
Create or replace facet configurations with options (Deprecated)
v1-facets-create-or-replace-facets 3 params body → 200400401403404429
PATCH
/v1/facetsdeprecated
Update facet configurations (Deprecated)
v1-facets-update-facets 3 params body → 200400401403404429
GET
/v1/facets/{facet_name}deprecated
Retrieve facet configuration (Deprecated)
v1-facets-retrieve-facet 4 params → 200400401403404429
PUT
/v1/facets/{facet_name}deprecated
Replace facet configuration (Deprecated)
v1-facets-replace-facet 4 params body → 200400401403404409429
PATCH
/v1/facets/{facet_name}deprecated
Update facet configuration (Deprecated)
v1-facets-update-facet 4 params body → 200201400401403404409429
DELETE
/v1/facets/{facet_name}deprecated
Delete facet configuration (Deprecated)
v1-facets-delete-facet 4 params → 200400401403404429
GET
/v2/facets
Retrieve facet configurations
v2-facets-retrieve-facets 6 params → 200400401403404429
POST
/v2/facets
Create facet configuration
v2-facets-create-facet 3 params body → 200400401403404409429
PUT
/v2/facets
Create or replace facet configurations
v2-facets-create-or-replace-facets 3 params body → 200400401403404409429
PATCH
/v2/facets
Update facet configurations
v2-facets-update-facets 3 params body → 200400401403404409429
GET
/v2/facets/{facet_name}
Retrieve facet configuration
v2-facets-retrieve-facet 4 params → 200400401403404429
PUT
/v2/facets/{facet_name}
Replace facet configuration
v2-facets-replace-facet 4 params body → 200400401403404409429
PATCH
/v2/facets/{facet_name}
Update facet configuration
v2-facets-update-facet 4 params body → 200400401403404409429
DELETE
/v2/facets/{facet_name}
Delete facet configuration
v2-facets-delete-facet 4 params → 200400401403404429
GET
/v1/facets/{facet_name}/options
Retrieve facet options
v1-facet-options-retrieve-facet-options 8 params → 200400401403429
POST
/v1/facets/{facet_name}/options
Create facet option
v1-facet-options-create-facet-option 4 params body → 200400401403404409429
PATCH
/v1/facets/{facet_name}/options
Create or update facet options
v1-facet-options-create-or-update-facet-options 4 params body → 200400401403404429
GET
/v1/facets/{facet_name}/options/{facet_option_value}
Retrieve facet option
v1-facet-options-retrieve-facet-option 5 params → 200400401403404429
PUT
/v1/facets/{facet_name}/options/{facet_option_value}
Replace facet option
v1-facet-options-replace-facet-option 5 params body → 200400401403404429
PATCH
/v1/facets/{facet_name}/options/{facet_option_value}
Update facet option
v1-facet-options-update-facet-option 5 params body → 200400401403404429
DELETE
/v1/facets/{facet_name}/options/{facet_option_value}
Delete facet option
v1-facet-options-delete-facet-option 5 params → 200400401403404429

Schemas 62

The contract defines 62 schemas that model the data the API accepts and returns. The most detailed are FacetResponseV2 (19 properties), FacetDeleteResponse (19 properties), FacetPatchResponse (19 properties), FacetPutResponse (19 properties). Each schema is shown below with its type and property counts.

FacetPutResponse
object
19 properties 1 required
RangeFacet
FacetOptionListPostResponse
object
7 properties 1 required
FacetListPatchRequestBody
array
A list of facets with fields that should be updated.
FacetListV2PatchResponse
object
1 property 1 required
FacetV2PatchResponse
object
19 properties 1 required
FacetDeleteResponse
object
19 properties 1 required
BatchFacetPartial
object
16 properties 1 required
FacetOptionDeleteResponse
object
7 properties 1 required
FacetListV2PutResponse
object
1 property 1 required
FacetListPutResponse
object
1 property 1 required
FacetListGetResponse
object
2 properties 2 required
FacetV2DeleteResponse
object
19 properties 1 required
FacetV2GetResponse
object
19 properties 1 required
BoundariesRangeFacet
object
17 properties 3 required
FacetOptionPutRequestBody
object
7 properties 1 required
HierarchicalFacet
object
17 properties 2 required
BoundariesRangeFacetV2
object
17 properties 4 required
FacetRangeFormat
string
FilterMatchType
string
FacetType
string
FacetOptionPatchResponse
object
7 properties 1 required
FacetResponse
object
18 properties 1 required
BatchFacetPartialV2
object
17 properties 1 required
FacetRangeInclusionType
string
FacetListPatchResponse
array
A list of facets
FacetV2PutRequestBody
OptionsRangeFacet
object
17 properties 4 required
FacetGetResponse
object
19 properties 1 required
FacetListV2PutRequestBody
object
1 property 1 required
FacetOption
object
7 properties 1 required
FacetOptionListPatchRequestBody
array
A list of facet options that should be updated.
FacetResponseV2
object
19 properties 1 required
OptionsRangeFacetV2
object
17 properties 5 required
FacetListV2GetResponse
object
2 properties 2 required
FacetV2
object
17 properties 3 required
FacetListPostResponse
object
19 properties 1 required
FacetPutRequestBody
HierarchicalFacetV2
object
17 properties 3 required
RangeFacetV2
FacetOptionListPatchResponse
array
A list of facet options
FacetOptionListGetResponse
object
2 properties 2 required
FacetListPutRequestBody
object
1 property 1 required
FacetV2PutResponse
object
19 properties 1 required
FacetV2PatchRequestBody
object
17 properties
FacetWithOptionsResponse
object
19 properties 1 required
FacetRangeType
string
FacetListV2PostRequestBody
FacetListV2PostResponse
object
19 properties 1 required
FacetWithOptions
object
17 properties 2 required
FacetListV2PatchRequestBody
object
1 property 1 required
FacetPatchRequestBody
object
17 properties
MultipleFacetV2
object
17 properties 3 required
FacetOptionListPostRequestBody
object
7 properties 1 required
FacetOptionPutResponse
object
7 properties 1 required
FacetOptionPatchRequestBody
object
7 properties
FacetPatchResponse
object
19 properties 1 required
FacetListPostRequestBody
FacetOptionListFilters
object
1 property
FacetOptionSortOrder
string
MultipleFacet
object
17 properties 2 required
FacetOptionGetResponse
object
7 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

constructorio-facets-api-openapi.yml Raw ↑

Other APIs Constructor.io publishes across the network.

Constructor Documentation MCP Server
Constructor.io Autocomplete results API
Constructor.io Behavioral actions API
Constructor.io Browse collections API
Constructor.io Browse facets API
Constructor.io Browse groups API
Constructor.io Browse results API
Constructor.io Catalog API
Constructor.io Collections API
Constructor.io Display Ads API
Constructor.io Engagements API
Constructor.io Facet campaigns API
Where this information came from

This is an independent, third-party profile of Constructor.io Facets API, 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.