{"openapi":"3.1.0","info":{"title":"Title and Cluster API","version":"0.2.0"},"paths":{"/v1/title-matches":{"post":{"summary":"Return the named register parameters for one title","operationId":"match_v1_title_matches_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TitleRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParameterAnswer"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unauthorized"},"402":{"description":"insufficient_credits: shared wallet cannot fund this lookup","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"403":{"description":"insufficient_scope or wallet_frozen","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Not Found"},"409":{"description":"request_in_progress (retry the same key), idempotency_conflict, or request_cancelled","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Gone"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Request Entity Too Large"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unprocessable Entity"},"429":{"description":"API safety allowance exhausted, independent of wallet credits","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"503":{"description":"Billing/configuration unavailable; settlement_unavailable requires retrying the same Idempotency-Key","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}}}}},"/v1/title-matches/{identifier}":{"get":{"summary":"Get Match","operationId":"get_match_v1_title_matches__identifier__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Cursor"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":10,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ParameterAnswer"},{"$ref":"#/components/schemas/SavedMatchView"}],"title":"Response Get Match V1 Title Matches  Identifier  Get"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Payment Required"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Conflict"},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Gone"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Request Entity Too Large"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unprocessable Entity"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Too Many Requests"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Service Unavailable"}}}},"/v1/request-history":{"get":{"summary":"History","operationId":"history_v1_request_history_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"410":{"description":"Gone","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"413":{"description":"Request Entity Too Large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"503":{"description":"Service Unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/request-history/{identifier}":{"get":{"summary":"Detail","operationId":"detail_v1_request_history__identifier__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Payment Required"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Conflict"},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Gone"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Request Entity Too Large"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unprocessable Entity"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Too Many Requests"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Service Unavailable"}}}},"/v1/batches/{identifier}/accept":{"post":{"summary":"Accept","operationId":"accept_v1_batches__identifier__accept_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcceptQuote"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogStatus"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Payment Required"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Conflict"},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Gone"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Request Entity Too Large"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unprocessable Entity"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Too Many Requests"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Service Unavailable"}}}},"/v1/batches/{identifier}/retry-payment":{"post":{"summary":"Retry","operationId":"retry_v1_batches__identifier__retry_payment_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AcceptQuote"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogStatus"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Payment Required"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Conflict"},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Gone"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Request Entity Too Large"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unprocessable Entity"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Too Many Requests"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Service Unavailable"}}}},"/v1/batches":{"get":{"summary":"Batches","operationId":"batches_v1_batches_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Page Size"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^[0-9a-f]{64}$"},{"type":"null"}],"title":"Cursor"}},{"name":"status","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(awaiting_quote|awaiting_acceptance|queued|running|settlement_pending|completed|completed_with_errors|completed_with_warnings|failed|cancelled)$"},{"type":"null"}],"title":"Status"}},{"name":"billing_state","in":"query","required":false,"schema":{"anyOf":[{"type":"string","pattern":"^(settlement_pending|refused|settled)$"},{"type":"null"}],"title":"Billing State"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BatchList"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Payment Required"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Conflict"},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Gone"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Request Entity Too Large"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unprocessable Entity"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Too Many Requests"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Service Unavailable"}}},"post":{"summary":"Batch","operationId":"batch_v1_batches_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/TaxonomyBatchRequest"},{"$ref":"#/components/schemas/CatalogRequest"}],"title":"Body"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/JobView"},{"$ref":"#/components/schemas/CatalogStatus"}],"title":"Response 202 Batch V1 Batches Post"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Payment Required"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Conflict"},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Gone"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Request Entity Too Large"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unprocessable Entity"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Too Many Requests"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Service Unavailable"}}}},"/v1/batches/{identifier}":{"get":{"summary":"Get Batch","operationId":"get_batch_v1_batches__identifier__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/JobView"},{"$ref":"#/components/schemas/CatalogStatus"}],"title":"Response 200 Get Batch V1 Batches  Identifier  Get"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Payment Required"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Conflict"},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Gone"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Request Entity Too Large"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unprocessable Entity"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Too Many Requests"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Service Unavailable"}}}},"/v1/batches/{identifier}/results":{"get":{"summary":"Batch Results","operationId":"batch_results_v1_batches__identifier__results_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Cursor"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/BatchResultPage"},{"$ref":"#/components/schemas/CatalogPage"}],"title":"Response 200 Batch Results V1 Batches  Identifier  Results Get"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Payment Required"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Conflict"},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Gone"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Request Entity Too Large"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unprocessable Entity"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Too Many Requests"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Service Unavailable"}}}},"/v1/batches/{identifier}/export":{"get":{"summary":"Export","operationId":"export_v1_batches__identifier__export_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Cursor"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":100,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Payment Required"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Conflict"},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Gone"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Request Entity Too Large"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unprocessable Entity"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Too Many Requests"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Service Unavailable"}}}},"/v1/batches/{identifier}/cancel":{"post":{"summary":"Cancel","operationId":"cancel_v1_batches__identifier__cancel_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Payment Required"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Conflict"},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Gone"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Request Entity Too Large"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unprocessable Entity"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Too Many Requests"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Service Unavailable"}}}},"/v1/catalog-groups":{"post":{"summary":"Grouping","operationId":"grouping_v1_catalog_groups_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CatalogGroupingRequest"}}}},"responses":{"202":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/JobView"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Payment Required"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Conflict"},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Gone"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Request Entity Too Large"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unprocessable Entity"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Too Many Requests"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Service Unavailable"}}}},"/v1/catalog-groups/{identifier}":{"get":{"summary":"Get Groups","operationId":"get_groups_v1_catalog_groups__identifier__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Cursor"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Payment Required"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Conflict"},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Gone"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Request Entity Too Large"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unprocessable Entity"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Too Many Requests"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Service Unavailable"}}}},"/v1/catalog-groups/{identifier}/groups/{group_id}/members":{"get":{"summary":"Members","operationId":"members_v1_catalog_groups__identifier__groups__group_id__members_get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"group_id","in":"path","required":true,"schema":{"type":"string","title":"Group Id"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Cursor"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Payment Required"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Conflict"},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Gone"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Request Entity Too Large"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unprocessable Entity"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Too Many Requests"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Service Unavailable"}}}},"/v1/catalog-groups/{identifier}/{kind}":{"get":{"summary":"Group Details","operationId":"group_details_v1_catalog_groups__identifier___kind__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}},{"name":"kind","in":"path","required":true,"schema":{"type":"string","title":"Kind"}},{"name":"cursor","in":"query","required":false,"schema":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Cursor"}},{"name":"page_size","in":"query","required":false,"schema":{"type":"integer","maximum":100,"minimum":1,"default":50,"title":"Page Size"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Payment Required"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Conflict"},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Gone"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Request Entity Too Large"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unprocessable Entity"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Too Many Requests"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Service Unavailable"}}}},"/v1/{resource}/{identifier}":{"delete":{"summary":"Delete","operationId":"delete_v1__resource___identifier__delete","security":[{"HTTPBearer":[]}],"parameters":[{"name":"resource","in":"path","required":true,"schema":{"type":"string","title":"Resource"}},{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}}],"responses":{"204":{"description":"Successful Response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Payment Required"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Conflict"},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Gone"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Request Entity Too Large"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unprocessable Entity"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Too Many Requests"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Service Unavailable"}}}},"/v1/usage":{"get":{"summary":"Usage","operationId":"usage_v1_usage_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"402":{"description":"Payment Required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"409":{"description":"Conflict","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"410":{"description":"Gone","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"413":{"description":"Request Entity Too Large","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"422":{"description":"Unprocessable Entity","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"429":{"description":"Too Many Requests","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"503":{"description":"Service Unavailable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/market-research":{"post":{"summary":"Post","operationId":"post_v1_market_research_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResearchRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResearchParameters"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Payment Required"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Conflict"},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Gone"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Request Entity Too Large"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unprocessable Entity"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Too Many Requests"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Service Unavailable"}}}},"/v1/market-research/{identifier}":{"get":{"summary":"Get","operationId":"get_v1_market_research__identifier__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResearchParameters"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Payment Required"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Conflict"},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Gone"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Request Entity Too Large"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unprocessable Entity"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Too Many Requests"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Service Unavailable"}}}},"/v1/content-generations":{"post":{"summary":"Post","operationId":"post_v1_content_generations_post","security":[{"HTTPBearer":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","minLength":1,"maxLength":200,"title":"Idempotency-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ContentRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParameterAnswer"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Payment Required"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Conflict"},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Gone"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Request Entity Too Large"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unprocessable Entity"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Too Many Requests"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Service Unavailable"}}}},"/v1/content-generations/{identifier}":{"get":{"summary":"Get","operationId":"get_v1_content_generations__identifier__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"identifier","in":"path","required":true,"schema":{"type":"string","title":"Identifier"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParameterAnswer"}}}},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unauthorized"},"402":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Payment Required"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Conflict"},"410":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Gone"},"413":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Request Entity Too Large"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Unprocessable Entity"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Too Many Requests"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}},"description":"Service Unavailable"}}}},"/v1/versions":{"get":{"summary":"Get Versions","operationId":"get_versions_v1_versions_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}},"security":[{"HTTPBearer":[]}]}},"/v1/clusters/{cluster_id}":{"get":{"summary":"Get Cluster","operationId":"get_cluster_v1_clusters__cluster_id__get","security":[{"HTTPBearer":[]}],"parameters":[{"name":"cluster_id","in":"path","required":true,"schema":{"type":"string","title":"Cluster Id"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/health":{"get":{"summary":"Health","operationId":"health_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"AcceptQuote":{"properties":{"acceptance":{"type":"string","pattern":"^[0-9a-f]{64}$","title":"Acceptance"}},"additionalProperties":false,"type":"object","required":["acceptance"],"title":"AcceptQuote"},"AssociationView":{"properties":{"values":{"items":{"type":"string"},"type":"array","title":"Values"},"availability":{"type":"string","enum":["available","not_enriched"],"title":"Availability"},"provenance":{"type":"string","const":"cluster_inheritance","title":"Provenance"},"total_values":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Values"},"sample_limit":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sample Limit"},"truncated":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Truncated"}},"additionalProperties":true,"type":"object","required":["values","availability","provenance"],"title":"AssociationView"},"Associations":{"properties":{"cluster_ids":{"items":{"type":"string"},"type":"array","title":"Cluster Ids"},"basis":{"type":"string","const":"retrieved_semantic_neighborhood","title":"Basis","default":"retrieved_semantic_neighborhood"},"exact_product_identity":{"type":"boolean","const":false,"title":"Exact Product Identity","default":false}},"additionalProperties":false,"type":"object","required":["cluster_ids"],"title":"Associations"},"Attribute":{"properties":{"name":{"type":"string","maxLength":2000,"minLength":1,"title":"Name"},"value":{"type":"string","maxLength":2000,"minLength":1,"title":"Value"}},"additionalProperties":false,"type":"object","required":["name","value"],"title":"Attribute"},"BatchItemView":{"properties":{"index":{"type":"integer","title":"Index"},"status":{"type":"string","title":"Status"},"error":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Error"},"result":{"anyOf":[{"$ref":"#/components/schemas/SavedMatchView"},{"$ref":"#/components/schemas/ExpandedTitleAnswer"},{"type":"null"}],"title":"Result"},"client_product_id":{"type":"string","title":"Client Product Id"}},"additionalProperties":true,"type":"object","required":["index","status","client_product_id"],"title":"BatchItemView"},"BatchList":{"properties":{"items":{"items":{"$ref":"#/components/schemas/BatchSummary"},"type":"array","title":"Items"},"has_more":{"type":"boolean","title":"Has More"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"type":"object","required":["items","has_more","next_cursor"],"title":"BatchList"},"BatchResultPage":{"properties":{"items":{"items":{"$ref":"#/components/schemas/BatchItemView"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"expires_at":{"type":"string","title":"Expires At"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"has_more":{"type":"boolean","title":"Has More"}},"additionalProperties":false,"type":"object","required":["items","total","expires_at","next_cursor","has_more"],"title":"BatchResultPage"},"BatchSummary":{"properties":{"id":{"type":"string","title":"Id"},"status":{"type":"string","title":"Status"},"workflow":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Workflow"},"billing_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Billing State"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"total":{"type":"integer","title":"Total"},"completed":{"type":"integer","title":"Completed"},"failed":{"type":"integer","title":"Failed"},"location":{"type":"string","title":"Location"},"cancel_url":{"type":"string","title":"Cancel Url"}},"type":"object","required":["id","status","created_at","expires_at","total","completed","failed","location","cancel_url"],"title":"BatchSummary"},"BidRange":{"properties":{"low":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Low"},"high":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"High"}},"additionalProperties":false,"type":"object","title":"BidRange"},"Brand":{"properties":{"segment":{"anyOf":[{"$ref":"#/components/schemas/SegmentBasis"},{"type":"null"}]},"name":{"type":"string","title":"Name"},"products":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Products"},"merchants":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Merchants"},"product_share":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Product Share"},"observed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Observed At"}},"additionalProperties":false,"type":"object","required":["name"],"title":"Brand"},"BuyerQuestion":{"properties":{"retrieval":{"anyOf":[{"type":"string","enum":["cluster","question_search"]},{"type":"null"}],"title":"Retrieval"},"id":{"type":"string","title":"Id"},"text":{"type":"string","title":"Text"},"question":{"anyOf":[{"type":"string","maxLength":500,"minLength":1},{"type":"null"}],"title":"Question"},"question_basis":{"anyOf":[{"type":"string","const":"rephrased"},{"type":"null"}],"title":"Question Basis"},"parent_cluster_id":{"type":"string","title":"Parent Cluster Id"},"parent_search_volume":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Parent Search Volume"},"basis":{"type":"string","const":"retrieved","title":"Basis","default":"retrieved"}},"additionalProperties":false,"type":"object","required":["id","text","parent_cluster_id"],"title":"BuyerQuestion"},"CandidatePage":{"properties":{"items":{"items":{"$ref":"#/components/schemas/CandidateView"},"type":"array","title":"Items"},"total":{"type":"integer","title":"Total"},"expires_at":{"type":"string","title":"Expires At"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"},"has_more":{"type":"boolean","title":"Has More"}},"additionalProperties":false,"type":"object","required":["items","total","expires_at","next_cursor","has_more"],"title":"CandidatePage"},"CandidateView":{"properties":{"cluster_id":{"type":"string","title":"Cluster Id"},"canonical":{"type":"string","title":"Canonical","description":"Cluster representative label; never a replacement product title."},"relative_score":{"type":"number","title":"Relative Score","description":"Relative ranking within this retrieval, not probability or identity confidence."},"score_kind":{"type":"string","const":"relative_ranking","title":"Score Kind"},"identity_status":{"type":"string","const":"not_evaluated","title":"Identity Status"},"match_type":{"type":"string","enum":["Top","Strong","Good","Weak"],"title":"Match Type","description":"Ranking band; Top replaces the misleading legacy Exact label."},"rank":{"type":"integer","title":"Rank"},"accepted":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Accepted"},"review_state":{"type":"string","title":"Review State"},"associations":{"additionalProperties":{"$ref":"#/components/schemas/AssociationView"},"type":"object","title":"Associations"}},"additionalProperties":true,"type":"object","required":["cluster_id","canonical","relative_score","score_kind","identity_status","match_type","rank","accepted","review_state","associations"],"title":"CandidateView"},"CatalogGroupingRequest":{"properties":{"batch_id":{"type":"string","maxLength":100,"minLength":1,"title":"Batch Id"},"previous_grouping_id":{"anyOf":[{"type":"string","maxLength":100},{"type":"null"}],"title":"Previous Grouping Id"},"min_products":{"type":"integer","maximum":10000.0,"minimum":1.0,"title":"Min Products","default":5},"max_fraction":{"type":"number","maximum":1.0,"exclusiveMinimum":0.0,"title":"Max Fraction","default":0.6},"include":{"items":{"type":"string"},"type":"array","maxItems":10,"title":"Include"}},"additionalProperties":false,"type":"object","required":["batch_id"],"title":"CatalogGroupingRequest"},"CatalogPage":{"properties":{"workflow":{"type":"string","const":"catalog_local_v1","title":"Workflow"},"processing":{"additionalProperties":true,"type":"object","title":"Processing"},"outputs":{"additionalProperties":true,"type":"object","title":"Outputs"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"has_more":{"type":"boolean","title":"Has More"},"next_cursor":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Next Cursor"}},"additionalProperties":false,"type":"object","required":["workflow","processing","outputs","expires_at","has_more","next_cursor"],"title":"CatalogPage"},"CatalogRequest":{"properties":{"workflow":{"type":"string","const":"catalog_local_v1","title":"Workflow"},"records":{"items":{"$ref":"#/components/schemas/Product"},"type":"array","maxItems":500,"minItems":1,"title":"Records"},"parameters":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","maxItems":10,"minItems":1,"title":"Parameters"},"refine_probes":{"type":"boolean","title":"Refine Probes","default":false}},"additionalProperties":false,"type":"object","required":["workflow","records","parameters"],"title":"CatalogRequest"},"CatalogStatus":{"properties":{"id":{"type":"string","title":"Id"},"workflow":{"type":"string","const":"catalog_local_v1","title":"Workflow"},"status":{"type":"string","title":"Status"},"parameters":{"items":{"type":"string"},"type":"array","title":"Parameters"},"total":{"type":"integer","maximum":500.0,"minimum":1.0,"title":"Total"},"created_at":{"type":"string","format":"date-time","title":"Created At"},"expires_at":{"type":"string","format":"date-time","title":"Expires At"},"billing":{"additionalProperties":true,"type":"object","title":"Billing"},"result_available":{"type":"boolean","title":"Result Available"},"error":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Error"},"results_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Results Url"}},"additionalProperties":false,"type":"object","required":["id","workflow","status","parameters","total","created_at","expires_at","billing","result_available"],"title":"CatalogStatus"},"CategoryPath":{"properties":{"system":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"System"},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version"},"basis":{"anyOf":[{"type":"string","const":"suggested"},{"type":"null"}],"title":"Basis"},"ids":{"items":{"type":"string"},"type":"array","maxItems":20,"minItems":1,"title":"Ids"},"labels":{"items":{"type":"string"},"type":"array","maxItems":20,"minItems":1,"title":"Labels"}},"additionalProperties":false,"type":"object","required":["ids","labels"],"title":"CategoryPath"},"CollectionSuggestion":{"properties":{"name":{"type":"string","maxLength":200,"minLength":1,"title":"Name"},"criteria":{"items":{"type":"string"},"type":"array","maxItems":10,"minItems":1,"title":"Criteria"},"basis":{"type":"string","const":"suggested","title":"Basis","default":"suggested"}},"additionalProperties":false,"type":"object","required":["name","criteria"],"title":"CollectionSuggestion"},"Concentration":{"properties":{"segment":{"anyOf":[{"$ref":"#/components/schemas/SegmentBasis"},{"type":"null"}]},"products_per_merchant":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Products Per Merchant"},"top_3_brand_product_share":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Top 3 Brand Product Share"},"top_5_brand_product_share":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Top 5 Brand Product Share"},"denominator_products":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Denominator Products"},"interpretation":{"type":"string","title":"Interpretation","default":"Product-count shares, not sales shares or entry difficulty."}},"additionalProperties":false,"type":"object","title":"Concentration"},"ContentRequest":{"properties":{"source":{"$ref":"#/components/schemas/ContentSource"},"parameters":{"items":{"anyOf":[{"type":"integer"},{"type":"string"}]},"type":"array","maxItems":68,"minItems":1,"title":"Parameters","description":"Register parameters to return, each by id or name. The response holds these and nothing else; the price is one unit per parameter."},"channels":{"items":{"type":"string","enum":["blog","sem","email","product","instagram","facebook","x","pinterest","tiktok","youtube"]},"type":"array","maxItems":10,"minItems":1,"title":"Channels"},"locale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Locale"}},"additionalProperties":false,"type":"object","required":["source","parameters","channels"],"title":"ContentRequest"},"ContentSource":{"properties":{"subject":{"$ref":"#/components/schemas/Subject"},"objective":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Objective"},"brand_voice":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Brand Voice"}},"additionalProperties":false,"type":"object","required":["subject"],"title":"ContentSource"},"CountValue":{"properties":{"value":{"type":"string","title":"Value"},"count":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Count"}},"additionalProperties":false,"type":"object","required":["value"],"title":"CountValue"},"Coverage":{"properties":{"segment":{"anyOf":[{"$ref":"#/components/schemas/SegmentBasis"},{"type":"null"}]},"products":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Products"},"merchants":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Merchants"},"brands":{"anyOf":[{"type":"integer","minimum":0.0},{"type":"null"}],"title":"Brands"}},"additionalProperties":false,"type":"object","title":"Coverage"},"DemandTrend":{"properties":{"change_percent":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Change Percent"},"baseline_period":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Baseline Period"},"current_period":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Current Period"}},"additionalProperties":false,"type":"object","title":"DemandTrend"},"DiscoveryAnswer":{"properties":{"measurement_keywords":{"anyOf":[{"items":{"$ref":"#/components/schemas/Keyword"},"type":"array"},{"type":"null"}],"title":"Measurement Keywords"},"keywords":{"anyOf":[{"items":{"$ref":"#/components/schemas/Keyword"},"type":"array"},{"type":"null"}],"title":"Keywords"},"buyer_questions":{"anyOf":[{"items":{"$ref":"#/components/schemas/BuyerQuestion"},"type":"array"},{"type":"null"}],"title":"Buyer Questions"},"intent_phrases":{"anyOf":[{"items":{"$ref":"#/components/schemas/SuggestedPhrase"},"type":"array"},{"type":"null"}],"title":"Intent Phrases"},"localized_terms":{"anyOf":[{"items":{"$ref":"#/components/schemas/LocalizedTerm"},"type":"array"},{"type":"null"}],"title":"Localized Terms"},"keyword_product_matches":{"anyOf":[{"items":{"$ref":"#/components/schemas/KeywordProductMatch"},"type":"array"},{"type":"null"}],"title":"Keyword Product Matches"},"sample_limit":{"type":"integer","title":"Sample Limit"},"possibly_truncated":{"type":"boolean","title":"Possibly Truncated","default":false}},"additionalProperties":false,"type":"object","required":["sample_limit"],"title":"DiscoveryAnswer"},"Distribution":{"properties":{"segment":{"anyOf":[{"$ref":"#/components/schemas/SegmentBasis"},{"type":"null"}]},"dimension":{"type":"string","title":"Dimension"},"values":{"items":{"$ref":"#/components/schemas/CountValue"},"type":"array","title":"Values"}},"additionalProperties":false,"type":"object","required":["dimension","values"],"title":"Distribution"},"ErrorBody":{"properties":{"code":{"type":"string","title":"Code"},"message":{"type":"string","title":"Message"},"request_id":{"type":"string","title":"Request Id"},"retryable":{"type":"boolean","title":"Retryable"},"details":{"additionalProperties":true,"type":"object","title":"Details"}},"additionalProperties":false,"type":"object","required":["code","message","request_id","retryable","details"],"title":"ErrorBody"},"ExpandedTitleAnswer":{"properties":{"title":{"type":"string","maxLength":2000,"minLength":1,"title":"Title"},"product_type":{"anyOf":[{"type":"string","maxLength":2000,"minLength":1},{"type":"null"}],"title":"Product Type"},"brand":{"anyOf":[{"type":"string","maxLength":2000,"minLength":1},{"type":"null"}],"title":"Brand"},"attributes":{"items":{"$ref":"#/components/schemas/Attribute"},"type":"array","maxItems":40,"title":"Attributes"},"categories":{"items":{"type":"string","maxLength":2000,"minLength":1},"type":"array","maxItems":100,"title":"Categories"},"use_cases":{"items":{"type":"string","maxLength":2000,"minLength":1},"type":"array","maxItems":100,"title":"Use Cases"},"occasions":{"items":{"type":"string","maxLength":2000,"minLength":1},"type":"array","maxItems":100,"title":"Occasions"},"audiences":{"items":{"type":"string","maxLength":2000,"minLength":1},"type":"array","maxItems":100,"title":"Audiences"},"seasons":{"items":{"type":"string","maxLength":2000,"minLength":1},"type":"array","maxItems":100,"title":"Seasons"},"where":{"items":{"type":"string","maxLength":2000,"minLength":1},"type":"array","maxItems":100,"title":"Where"},"why":{"items":{"type":"string","maxLength":2000,"minLength":1},"type":"array","maxItems":100,"title":"Why"},"how":{"items":{"type":"string","maxLength":2000,"minLength":1},"type":"array","maxItems":100,"title":"How"},"discovery":{"anyOf":[{"$ref":"#/components/schemas/DiscoveryAnswer"},{"type":"null"}]},"merchandising":{"anyOf":[{"$ref":"#/components/schemas/MerchandisingAnswer"},{"type":"null"}]},"associations":{"anyOf":[{"$ref":"#/components/schemas/Associations"},{"type":"null"}]},"section_status":{"additionalProperties":{"$ref":"#/components/schemas/SectionStatus"},"type":"object","title":"Section Status"}},"additionalProperties":false,"type":"object","required":["title","product_type","brand","attributes","categories","use_cases","occasions","audiences","seasons","where","why","how"],"title":"ExpandedTitleAnswer"},"ExtractedAttributes":{"properties":{"provenance":{"type":"string","const":"attribute_extractor","title":"Provenance"},"pt":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pt","description":"Predicted product type, not verified identity."},"brand":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Brand","description":"Predicted brand/manufacturer span."},"mats":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Mats","description":"Predicted material/fabric spans; may include misclassified terms. Not verified composition."},"mods":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Mods","description":"Product modifiers, including style or features; not exclusively aesthetic styles."},"mods_lex":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Mods Lex","description":"Subset of modifiers selected by the extractor lexicon; not a separate assertion."},"colors":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Colors","description":"Color spans from the title."},"sizes":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Sizes","description":"Size/capacity spans with original units; no conversion or equivalence implied."},"ga":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ga","description":"Gender/age span, not a verified buyer audience."},"qty":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Qty","description":"Quantity/pack span, not a parsed inventory count."},"line":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Line","description":"Predicted product-line span; may contain an opaque number."},"compat":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Compat","description":"Compatibility span, not verified fitment."},"conf":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Conf","description":"Minimum predicted probability over labeled tokens; not calibrated product accuracy or match confidence."},"flags":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Flags","description":"Extractor processing flags; empty does not certify correctness."},"mv":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Mv","description":"Extractor-reported model version."}},"additionalProperties":true,"type":"object","required":["provenance"],"title":"ExtractedAttributes","description":"Raw predictions from the existing extractor; absent fields remain absent."},"Facet":{"properties":{"name":{"type":"string","title":"Name"},"values":{"items":{"type":"string"},"type":"array","title":"Values"}},"additionalProperties":false,"type":"object","required":["name","values"],"title":"Facet"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"JobView":{"properties":{"id":{"type":"string","title":"Id"},"kind":{"type":"string","title":"Kind"},"status":{"type":"string","title":"Status"},"expires_at":{"type":"string","title":"Expires At"},"created_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Created At"},"completed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Completed"},"failed":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Failed"},"total":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total"}},"additionalProperties":true,"type":"object","required":["id","kind","status","expires_at"],"title":"JobView"},"Keyword":{"properties":{"retrieval":{"anyOf":[{"type":"string","enum":["cluster","keyword_search","submitted"]},{"type":"null"}],"title":"Retrieval"},"id":{"type":"string","title":"Id"},"text":{"type":"string","title":"Text"},"roles":{"items":{"type":"string"},"type":"array","title":"Roles"},"basis":{"type":"string","enum":["retrieved","suggested","submitted"],"title":"Basis","default":"retrieved"},"product_ids":{"items":{"type":"string"},"type":"array","title":"Product Ids"},"metrics":{"anyOf":[{"$ref":"#/components/schemas/KeywordMetrics"},{"type":"null"}]},"metrics_status":{"anyOf":[{"type":"string","enum":["stored","measured","no_data","stale","unavailable"]},{"type":"null"}],"title":"Metrics Status"},"monthly_demand":{"anyOf":[{"$ref":"#/components/schemas/MonthlyDemand"},{"type":"null"}]},"demand_trend":{"anyOf":[{"$ref":"#/components/schemas/DemandTrend"},{"type":"null"}]},"intent":{"anyOf":[{"$ref":"#/components/schemas/KeywordIntent"},{"type":"null"}]},"graph_coverage":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Graph Coverage"},"context":{"$ref":"#/components/schemas/MeasurementContext"}},"additionalProperties":false,"type":"object","required":["id","text"],"title":"Keyword"},"KeywordIntent":{"properties":{"stage":{"type":"string","enum":["informational","commercial","transactional"],"title":"Stage"},"reason":{"type":"string","title":"Reason"}},"additionalProperties":false,"type":"object","required":["stage","reason"],"title":"KeywordIntent"},"KeywordMetrics":{"properties":{"cpc":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Cpc"},"search_volume":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Search Volume"},"paid_search_competition":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Paid Search Competition"},"competition_index":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Competition Index"},"bid_range":{"anyOf":[{"$ref":"#/components/schemas/BidRange"},{"type":"null"}]}},"additionalProperties":false,"type":"object","title":"KeywordMetrics"},"KeywordProductMatch":{"properties":{"keyword_id":{"type":"string","title":"Keyword Id"},"product_ids":{"items":{"type":"string"},"type":"array","title":"Product Ids"},"basis":{"type":"string","const":"suggested_token_overlap","title":"Basis","default":"suggested_token_overlap"}},"additionalProperties":false,"type":"object","required":["keyword_id","product_ids"],"title":"KeywordProductMatch"},"LocalizedTerm":{"properties":{"text":{"type":"string","maxLength":500,"minLength":1,"title":"Text"},"basis":{"type":"string","const":"suggested","title":"Basis","default":"suggested"},"locale":{"type":"string","maxLength":35,"minLength":2,"title":"Locale"}},"additionalProperties":false,"type":"object","required":["text","locale"],"title":"LocalizedTerm"},"MeasurementContext":{"properties":{"market":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market"},"language":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Language"},"currency":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Currency"},"measurement_period":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Measurement Period"},"observed_at":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Observed At"},"provider":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider"}},"additionalProperties":false,"type":"object","title":"MeasurementContext"},"MerchandisingAnswer":{"properties":{"synonyms":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Synonyms"},"category_paths":{"anyOf":[{"items":{"$ref":"#/components/schemas/CategoryPath"},"type":"array"},{"type":"null"}],"title":"Category Paths"},"taxonomy_mappings":{"anyOf":[{"items":{"$ref":"#/components/schemas/TaxonomyMapping"},"type":"array"},{"type":"null"}],"title":"Taxonomy Mappings"},"collection_suggestions":{"anyOf":[{"items":{"$ref":"#/components/schemas/CollectionSuggestion"},"type":"array"},{"type":"null"}],"title":"Collection Suggestions"},"facets":{"anyOf":[{"items":{"$ref":"#/components/schemas/Facet"},"type":"array"},{"type":"null"}],"title":"Facets"},"related_product_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Related Product Types"},"alternative_product_types":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Alternative Product Types"},"compatibility":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Compatibility"},"variant_dimensions":{"anyOf":[{"items":{"$ref":"#/components/schemas/VariantDimension"},"type":"array"},{"type":"null"}],"title":"Variant Dimensions"},"missing_attributes":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Missing Attributes"}},"additionalProperties":false,"type":"object","title":"MerchandisingAnswer"},"MonthlyDemand":{"properties":{"points":{"items":{"$ref":"#/components/schemas/MonthlyPoint"},"type":"array","maxItems":120,"title":"Points"},"peak_months":{"items":{"type":"integer"},"type":"array","maxItems":12,"title":"Peak Months"}},"additionalProperties":false,"type":"object","title":"MonthlyDemand"},"MonthlyPoint":{"properties":{"year":{"type":"integer","maximum":2200.0,"minimum":1900.0,"title":"Year"},"month":{"type":"integer","maximum":12.0,"minimum":1.0,"title":"Month"},"volume":{"type":"integer","minimum":0.0,"title":"Volume"}},"additionalProperties":false,"type":"object","required":["year","month","volume"],"title":"MonthlyPoint"},"ParameterAnswer":{"properties":{},"additionalProperties":true,"type":"object","title":"ParameterAnswer","description":"Response body: one key per requested register parameter, nothing else."},"Product":{"properties":{"client_product_id":{"type":"string","maxLength":200,"minLength":1,"title":"Client Product Id"},"title":{"type":"string","maxLength":1000,"minLength":1,"title":"Title"},"language":{"type":"string","const":"en","title":"Language","default":"en"},"description":{"anyOf":[{"type":"string","maxLength":10000},{"type":"null"}],"title":"Description"},"sku":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Sku"},"product_type":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Product Type"},"brand":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Brand"},"price":{"anyOf":[{"type":"number","minimum":0.0},{"type":"null"}],"title":"Price"},"currency":{"anyOf":[{"type":"string","pattern":"^[A-Z]{3}$"},{"type":"null"}],"title":"Currency"},"tags":{"items":{"type":"string","maxLength":200},"type":"array","maxItems":1000,"title":"Tags"},"url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Url"},"image_url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Image Url"},"page_title":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Page Title"},"meta_description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Meta Description"},"h1_text":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"H1 Text"},"canonical_url":{"anyOf":[{"type":"string","maxLength":2048},{"type":"null"}],"title":"Canonical Url"},"og_title":{"anyOf":[{"type":"string","maxLength":1000},{"type":"null"}],"title":"Og Title"},"og_description":{"anyOf":[{"type":"string","maxLength":2000},{"type":"null"}],"title":"Og Description"},"word_count":{"anyOf":[{"type":"integer","maximum":50000.0,"minimum":0.0},{"type":"null"}],"title":"Word Count"},"internal_link_count":{"anyOf":[{"type":"integer","maximum":100000.0,"minimum":0.0},{"type":"null"}],"title":"Internal Link Count"},"structured_data_fields":{"items":{"type":"string","maxLength":200},"type":"array","maxItems":50,"title":"Structured Data Fields"},"image_alt_texts":{"items":{"type":"string","maxLength":200},"type":"array","maxItems":50,"title":"Image Alt Texts"}},"additionalProperties":false,"type":"object","required":["client_product_id","title"],"title":"Product"},"Record":{"properties":{"title":{"type":"string","maxLength":1000,"minLength":1,"title":"Title"},"client_product_id":{"type":"string","maxLength":200,"minLength":1,"title":"Client Product Id"},"description":{"anyOf":[{"type":"string","maxLength":10000},{"type":"null"}],"title":"Description"},"attributes":{"additionalProperties":{"type":"string"},"type":"object","maxProperties":40,"title":"Attributes"},"language":{"type":"string","maxLength":20,"minLength":2,"title":"Language","default":"en"}},"additionalProperties":false,"type":"object","required":["title","client_product_id"],"title":"Record"},"ResearchParameters":{"properties":{"market_coverage":{"anyOf":[{"$ref":"#/components/schemas/Coverage"},{"type":"null"}]},"seller_concentration":{"anyOf":[{"$ref":"#/components/schemas/Concentration"},{"type":"null"}]},"segment_attribute_distribution":{"anyOf":[{"items":{"$ref":"#/components/schemas/Distribution"},"type":"array"},{"type":"null"}],"title":"Segment Attribute Distribution"},"brand_presence":{"anyOf":[{"items":{"$ref":"#/components/schemas/Brand"},"type":"array"},{"type":"null"}],"title":"Brand Presence"}},"additionalProperties":true,"type":"object","title":"ResearchParameters","description":"Named parameter shapes; extra registered parameters retain their existing contract."},"ResearchRequest":{"properties":{"subject":{"$ref":"#/components/schemas/Subject"},"parameters":{"items":{"anyOf":[{"type":"integer"},{"type":"string"}]},"type":"array","maxItems":68,"minItems":1,"title":"Parameters","description":"Register parameters to return, each by id or name. The response holds these and nothing else; the price is one unit per parameter."},"market":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market"},"locale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Locale"}},"additionalProperties":false,"type":"object","required":["subject","parameters"],"title":"ResearchRequest"},"SavedMatchView":{"properties":{"result_id":{"type":"string","title":"Result Id"},"client_product_id":{"type":"string","title":"Client Product Id"},"original_title":{"type":"string","title":"Original Title"},"status":{"type":"string","title":"Status"},"retrieval_status":{"type":"string","title":"Retrieval Status"},"retrieval":{"additionalProperties":true,"type":"object","title":"Retrieval"},"observed_at":{"type":"string","title":"Observed At"},"versions":{"additionalProperties":{"type":"string"},"type":"object","title":"Versions"},"acceptance_policy":{"type":"string","title":"Acceptance Policy"},"accepted_cluster_ids":{"items":{"type":"string"},"type":"array","title":"Accepted Cluster Ids"},"diagnosis":{"additionalProperties":true,"type":"object","title":"Diagnosis"},"attributes":{"anyOf":[{"$ref":"#/components/schemas/ExtractedAttributes"},{"type":"null"}],"description":"Extractor fields with attribute_extractor provenance in batch results; null for interactive lookup, which does not run extraction. Inherited cluster labels remain separate associations."},"candidate_page":{"$ref":"#/components/schemas/CandidatePage"},"expires_at":{"type":"string","title":"Expires At"}},"additionalProperties":true,"type":"object","required":["result_id","client_product_id","original_title","status","retrieval_status","retrieval","observed_at","versions","acceptance_policy","accepted_cluster_ids","diagnosis","attributes","candidate_page","expires_at"],"title":"SavedMatchView"},"SectionStatus":{"properties":{"status":{"type":"string","enum":["available","no_data"],"title":"Status"}},"additionalProperties":false,"type":"object","required":["status"],"title":"SectionStatus"},"SegmentBasis":{"properties":{"requested":{"type":"string","title":"Requested"},"used":{"type":"string","title":"Used"},"match":{"type":"string","enum":["exact","broadened"],"title":"Match"}},"additionalProperties":false,"type":"object","required":["requested","used","match"],"title":"SegmentBasis"},"Subject":{"properties":{"type":{"type":"string","enum":["product_type","category","brand","dimension","title_result","catalog_group"],"title":"Type"},"value":{"anyOf":[{"type":"string","maxLength":500},{"type":"null"}],"title":"Value"},"dimension":{"anyOf":[{"type":"string","enum":["season","demographic","occasion","use_case"]},{"type":"null"}],"title":"Dimension"},"id":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Id"},"grouping_id":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Grouping Id"},"group_id":{"anyOf":[{"type":"string","maxLength":200},{"type":"null"}],"title":"Group Id"}},"additionalProperties":false,"type":"object","required":["type"],"title":"Subject"},"SuggestedPhrase":{"properties":{"text":{"type":"string","maxLength":500,"minLength":1,"title":"Text"},"basis":{"type":"string","const":"suggested","title":"Basis","default":"suggested"}},"additionalProperties":false,"type":"object","required":["text"],"title":"SuggestedPhrase"},"TaxonomyBatchRequest":{"properties":{"records":{"items":{"$ref":"#/components/schemas/Record"},"type":"array","maxItems":10000,"minItems":1,"title":"Records"},"response_format":{"type":"string","enum":["legacy","taxonomy"],"title":"Response Format","default":"legacy"},"include":{"items":{"type":"string"},"type":"array","maxItems":9,"title":"Include"},"locale":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Locale"},"market":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market"}},"additionalProperties":false,"type":"object","required":["records"],"title":"TaxonomyBatchRequest"},"TaxonomyMapping":{"properties":{"basis":{"anyOf":[{"type":"string","const":"suggested"},{"type":"null"}],"title":"Basis"},"system":{"type":"string","title":"System"},"category_id":{"type":"string","title":"Category Id"},"label":{"type":"string","title":"Label"},"version":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Version"},"market":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Market"}},"additionalProperties":false,"type":"object","required":["system","category_id","label"],"title":"TaxonomyMapping"},"TitleRequest":{"properties":{"title":{"type":"string","maxLength":1000,"minLength":1,"title":"Title"},"client_product_id":{"anyOf":[{"type":"string","maxLength":200,"minLength":1},{"type":"null"}],"title":"Client Product Id"},"description":{"anyOf":[{"type":"string","maxLength":10000},{"type":"null"}],"title":"Description"},"attributes":{"additionalProperties":{"type":"string"},"type":"object","maxProperties":40,"title":"Attributes"},"language":{"type":"string","maxLength":20,"minLength":2,"title":"Language","default":"en"},"channel":{"anyOf":[{"type":"string","enum":["product_listing","catalog","shopper_message","article","review","video","email","ad","social_post","news"]},{"type":"null"}],"title":"Channel","description":"Input source channel. Accepted in active input-types mode; new requests with a channel are refused in off/shadow mode."},"parameters":{"items":{"anyOf":[{"type":"integer"},{"type":"string"}]},"type":"array","maxItems":68,"minItems":1,"title":"Parameters","description":"Register parameters to return, each by id (1-68) or name. The response holds these and nothing else; the price is one unit per parameter."},"locale":{"anyOf":[{"type":"string","maxLength":35,"minLength":2,"pattern":"^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,8})*$"},{"type":"null"}],"title":"Locale"},"market":{"anyOf":[{"type":"string","maxLength":20,"minLength":2},{"type":"null"}],"title":"Market"},"keywords":{"anyOf":[{"items":{"type":"string"},"type":"array","maxItems":500,"minItems":1},{"type":"null"}],"title":"Keywords","description":"Optional keywords to measure, in addition to the keywords the API recommends for this title. Requires a keyword measurement parameter (cpc, search_volume, paid_search_competition, competition_index, keyword_bid_range, monthly_demand, demand_trend). At most 500; each at most 80 characters and 10 words."}},"additionalProperties":false,"type":"object","required":["title","parameters"],"title":"TitleRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VariantDimension":{"properties":{"name":{"type":"string","title":"Name"},"values":{"items":{"type":"string"},"type":"array","title":"Values"},"basis":{"type":"string","enum":["observed_family","suggested"],"title":"Basis"}},"additionalProperties":false,"type":"object","required":["name","values","basis"],"title":"VariantDimension"}},"securitySchemes":{"HTTPBearer":{"type":"http","scheme":"bearer"}}}}