{"components":{"securitySchemes":{"bearerAuth":{"scheme":"bearer","type":"http"}}},"info":{"description":"","title":"Etsy","version":"1","x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","quote":{"header":"X-AISA-Cost-Mode","value":"quote"}},"x-aisa-catalogs":{"etsy-com":{"description":"","title":"Etsy","x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","quote":{"header":"X-AISA-Cost-Mode","value":"quote"}},"x-aisa-document":{"facts_hash":"4106ddae462ee05ca740e3cf74efc7f881a623a47cd00018c014ede895fd7a9d","generator_version":"3","protocol_version":"1","schema_version":"1"},"x-aisa-plans":{"builder":1.0,"display_plan":"payg","payg":1.0,"similarweb_payg":1.0,"team":1.0,"version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb"}}},"x-aisa-configured-paths":["/apis/v1/etsy-com/listings/listing","/apis/v1/etsy-com/listings/listing-variations","/apis/v1/etsy-com/listings/search-suggestions","/apis/v1/etsy-com/listings/shop-sections","/apis/v1/etsy-com/listings/similar-listings"],"x-aisa-document":{"composer_version":"28","document_hash":"sha256:12623171a0cbfe9f544598f8b908a6c55dbd1801f4d05732e3afc059861b238f","facts_hash":"4106ddae462ee05ca740e3cf74efc7f881a623a47cd00018c014ede895fd7a9d","generator_version":"3","protocol_version":"1","response_pending":[],"schema_version":"1"},"x-aisa-plans":{"builder":1.0,"display_plan":"payg","payg":1.0,"similarweb_payg":1.0,"team":1.0,"version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb"},"x-aisa-provider":"etsy-com"},"jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","openapi":"3.1.0","paths":{"/apis/v1/etsy-com/listings/listing":{"post":{"description":"<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.0005 USD (not a fixed price). Declared unit rate: $0.0001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","operationId":"etsy-com.listings.listing","requestBody":{"content":{"application/json":{"examples":{"default":{"value":{"listing_id":1}},"minimal":{"value":{"listing_id":1}}},"schema":{"additionalProperties":true,"allOf":[{"anyOf":[{"properties":{"listing_id":{}},"required":["listing_id"]},{"properties":{"url":{}},"required":["url"]}]}],"properties":{"listing_id":{"type":"number"},"url":{"type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful response. The payload schema has not been reviewed yet."},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"summary":"Listing","tags":["Etsy"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"etsy-com","x-aisa-category":"commerce","x-aisa-constraints":{"required_any_of":[[{"in":"body","name":"option_listing_id","selector":"/listing_id"},{"in":"body","name":"option_url","selector":"/url"}]]},"x-aisa-docs-url":"https://aisa.one/docs/api-reference/etsy-com/etsy-com-listings-listing","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_units","customer_multiplier":1.0,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.0005,"estimate_source":"profile_seed","evidence_source":"response_body","unit":"provider_credit","unit_rate_usd":0.0001},"x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":false},"x-aisa-review":{"request":"runtime_binding","response":"generic","status":"unreviewed"},"x-aisa-revision":{"customer_pricing_ref":"660b80f46152","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"3505e8726630"},"x-aisa-runtime-operation":{"method":"POST","operation_id":"etsy-com.listings.listing","path":"/apis/v1/etsy-com/listings/listing"},"x-aisa-status":"enabled","x-aisa-validation":"mixed","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n  --url https://api.aisa.one/apis/v1/etsy-com/listings/listing \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n  \"listing_id\": 1\n}'"}]}},"/apis/v1/etsy-com/listings/listing-variations":{"post":{"description":"<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.0005 USD (not a fixed price). Declared unit rate: $0.0001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","operationId":"etsy-com.listings.listing-variations","requestBody":{"content":{"application/json":{"examples":{"default":{"value":{"listing_id":1}},"minimal":{"value":{"listing_id":1}}},"schema":{"additionalProperties":true,"properties":{"listing_id":{"type":"number"}},"required":["listing_id"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful response. The payload schema has not been reviewed yet."},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"summary":"Listing variations","tags":["Etsy"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"etsy-com","x-aisa-category":"commerce","x-aisa-docs-url":"https://aisa.one/docs/api-reference/etsy-com/etsy-com-listings-listing-variations","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_units","customer_multiplier":1.0,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.0005,"estimate_source":"profile_seed","evidence_source":"response_body","unit":"provider_credit","unit_rate_usd":0.0001},"x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":false},"x-aisa-review":{"request":"runtime_binding","response":"generic","status":"unreviewed"},"x-aisa-revision":{"customer_pricing_ref":"660b80f46152","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"c8e1faf4c403"},"x-aisa-runtime-operation":{"method":"POST","operation_id":"etsy-com.listings.listing-variations","path":"/apis/v1/etsy-com/listings/listing-variations"},"x-aisa-status":"enabled","x-aisa-validation":"mixed","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n  --url https://api.aisa.one/apis/v1/etsy-com/listings/listing-variations \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n  \"listing_id\": 1\n}'"}]}},"/apis/v1/etsy-com/listings/search-suggestions":{"post":{"description":"<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.0005 USD (not a fixed price). Declared unit rate: $0.0001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","operationId":"etsy-com.listings.search-suggestions","requestBody":{"content":{"application/json":{"examples":{"default":{"value":{"query":"nike"}},"minimal":{"value":{"query":"nike"}}},"schema":{"additionalProperties":true,"properties":{"query":{"type":"string"}},"required":["query"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful response. The payload schema has not been reviewed yet."},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"summary":"Search suggestions","tags":["Etsy"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"etsy-com","x-aisa-category":"commerce","x-aisa-docs-url":"https://aisa.one/docs/api-reference/etsy-com/etsy-com-listings-search-suggestions","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_units","customer_multiplier":1.0,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.0005,"estimate_source":"profile_seed","evidence_source":"response_body","unit":"provider_credit","unit_rate_usd":0.0001},"x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":false},"x-aisa-review":{"request":"runtime_binding","response":"generic","status":"unreviewed"},"x-aisa-revision":{"customer_pricing_ref":"660b80f46152","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"95831a32e60b"},"x-aisa-runtime-operation":{"method":"POST","operation_id":"etsy-com.listings.search-suggestions","path":"/apis/v1/etsy-com/listings/search-suggestions"},"x-aisa-status":"enabled","x-aisa-validation":"mixed","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n  --url https://api.aisa.one/apis/v1/etsy-com/listings/search-suggestions \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n  \"query\": \"nike\"\n}'"}]}},"/apis/v1/etsy-com/listings/shop-sections":{"post":{"description":"<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.0005 USD (not a fixed price). Declared unit rate: $0.0001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","operationId":"etsy-com.listings.shop-sections","requestBody":{"content":{"application/json":{"examples":{"default":{"value":{"shop_id":1}},"minimal":{"value":{"shop_id":1}}},"schema":{"additionalProperties":true,"properties":{"shop_id":{"type":"number"}},"required":["shop_id"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful response. The payload schema has not been reviewed yet."},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"summary":"Shop sections","tags":["Etsy"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"etsy-com","x-aisa-category":"commerce","x-aisa-docs-url":"https://aisa.one/docs/api-reference/etsy-com/etsy-com-listings-shop-sections","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_units","customer_multiplier":1.0,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.0005,"estimate_source":"profile_seed","evidence_source":"response_body","unit":"provider_credit","unit_rate_usd":0.0001},"x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":false},"x-aisa-review":{"request":"runtime_binding","response":"generic","status":"unreviewed"},"x-aisa-revision":{"customer_pricing_ref":"660b80f46152","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"cd7cba620a8d"},"x-aisa-runtime-operation":{"method":"POST","operation_id":"etsy-com.listings.shop-sections","path":"/apis/v1/etsy-com/listings/shop-sections"},"x-aisa-status":"enabled","x-aisa-validation":"mixed","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n  --url https://api.aisa.one/apis/v1/etsy-com/listings/shop-sections \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n  \"shop_id\": 1\n}'"}]}},"/apis/v1/etsy-com/listings/similar-listings":{"post":{"description":"<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.0005 USD (not a fixed price). Declared unit rate: $0.0001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","operationId":"etsy-com.listings.similar-listings","requestBody":{"content":{"application/json":{"examples":{"default":{"value":{"listing_id":1}},"minimal":{"value":{"listing_id":1}}},"schema":{"additionalProperties":true,"properties":{"listing_id":{"type":"number"}},"required":["listing_id"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful response. The payload schema has not been reviewed yet."},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"summary":"Similar listings","tags":["Etsy"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"etsy-com","x-aisa-category":"commerce","x-aisa-docs-url":"https://aisa.one/docs/api-reference/etsy-com/etsy-com-listings-similar-listings","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_units","customer_multiplier":1.0,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.0005,"estimate_source":"profile_seed","evidence_source":"response_body","unit":"provider_credit","unit_rate_usd":0.0001},"x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":false},"x-aisa-review":{"request":"runtime_binding","response":"generic","status":"unreviewed"},"x-aisa-revision":{"customer_pricing_ref":"660b80f46152","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"2f68e5dce1a4"},"x-aisa-runtime-operation":{"method":"POST","operation_id":"etsy-com.listings.similar-listings","path":"/apis/v1/etsy-com/listings/similar-listings"},"x-aisa-status":"enabled","x-aisa-validation":"mixed","x-codeSamples":[{"label":"Reference example","lang":"text","source":"# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n  --url https://api.aisa.one/apis/v1/etsy-com/listings/similar-listings \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n  \"listing_id\": 1\n}'"}]}}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}]}