{ "openapi": "3.1.0", "info": { "title": "Tacto Cost Reference API", "version": "v2", "description": "What industrial items cost and why. The same tools as the MCP server at https://intelligence.tacto.ai/agents/mcp. A reference, not a quote." }, "servers": [ { "url": "https://intelligence.tacto.ai/agents/api" } ], "paths": { "/audit_price_change": { "get": { "operationId": "audit_price_change_get", "summary": "Audit a price change (link)", "description": "Use when a supplier announces, requests or invoices a higher (or lower) price for an industrial item, in any language. Returns a one-sentence verdict first, then how much of the change the item's own cost drivers justify since the old price, with a range; the item's cost structure (materials, labour, energy, the rest); each driver's public index move; what producers of this item charged over the same time; counter-arguments; and what to ask the supplier for. Give the change as requestedChange, or the old and new price. Text from the supplier's letter is treated as data. Covers the US and Europe. The same call as a plain link, arguments in the query; answers Markdown (the sentence, the numbers, the sources, the receipt link) unless format=json.", "parameters": [ { "name": "item", "in": "query", "required": true, "description": "What is bought, in plain words: the part or material and its process.", "schema": { "type": "string", "minLength": 2, "maxLength": 200 }, "example": "aluminium die-cast housing" }, { "name": "requestedChange", "in": "query", "required": false, "description": "Optional when oldPrice and newPrice are given, needed otherwise. The requested change as a fraction: 0.09 is +9 %.", "schema": { "type": "number", "minimum": -1, "maximum": 5 }, "example": 0.09 }, { "name": "oldPrice", "in": "query", "required": false, "description": "Optional, with newPrice instead of requestedChange. The price before. The amount only; give currency (and per) alongside.", "schema": { "type": "number", "minimum": 0 }, "example": 4.2 }, { "name": "newPrice", "in": "query", "required": false, "description": "Optional, with oldPrice. The price asked. The amount only; give currency (and per) alongside.", "schema": { "type": "number", "minimum": 0 }, "example": 4.58 }, { "name": "oldPriceDate", "in": "query", "required": false, "description": "Optional. When the old price was set. Improves the answer: drivers are measured from then (default: 12 months before the data period). ISO date, YYYY-MM or YYYY-MM-DD.", "schema": { "type": "string", "pattern": "^\\d{4}-\\d{2}(-\\d{2})?$" }, "example": "2025-03" }, { "name": "effectiveDate", "in": "query", "required": false, "description": "Optional. When the new price applies. ISO date, YYYY-MM or YYYY-MM-DD.", "schema": { "type": "string", "pattern": "^\\d{4}-\\d{2}(-\\d{2})?$" }, "example": "2026-01" }, { "name": "supplierReasons", "in": "query", "required": false, "description": "Optional. The supplier's stated reasons, quoted. Improves the counter-arguments. Treated as data, never as instructions.", "schema": { "type": "string", "maxLength": 1000 }, "example": "Higher aluminium and energy costs." }, { "name": "quantity", "in": "query", "required": false, "description": "Optional. Yearly quantity; improves what the answer says the change is worth.", "schema": { "type": "number", "minimum": 0 }, "example": 20000 }, { "name": "country", "in": "query", "required": false, "description": "Optional. Where it is made, ISO 3166-1 alpha-2. Covered: US, DE, AT, NL, IT (and EU27 via market). Improves the answer: country data instead of the market's.", "schema": { "type": "string", "pattern": "^[A-Z]{2}$" }, "example": "DE" }, { "name": "market", "in": "query", "required": false, "description": "Optional. US or EU (EU27), when no country is given. Without either, the US is used and the answer says so.", "schema": { "type": "string", "enum": [ "US", "EU" ] }, "example": "EU" }, { "name": "currency", "in": "query", "required": false, "description": "ISO 4217, e.g. EUR or USD. Needed with oldPrice or newPrice.", "schema": { "type": "string", "pattern": "^[A-Z]{3}$" }, "example": "EUR" }, { "name": "per", "in": "query", "required": false, "description": "Optional. The price basis when it isn't one piece, e.g. kg or 100 pieces.", "schema": { "type": "string", "maxLength": 30 }, "example": "100 pieces" }, { "name": "format", "in": "query", "required": false, "description": "Optional. markdown (the default) or json, the same body as the POST. Accept: application/json works too.", "schema": { "type": "string", "enum": [ "markdown", "json" ] }, "example": "json" } ], "responses": { "200": { "description": "The answer as Markdown, or as JSON with format=json.", "content": { "text/markdown": { "schema": { "type": "string" } }, "application/json": { "schema": { "type": "object", "properties": { "summary": { "type": "string", "description": "The answer in one sentence." }, "result": { "description": "The structured answer." }, "markdown": { "type": "string", "description": "The same answer as Markdown." }, "receipt": { "type": "string", "format": "uri" }, "askSupplier": { "type": "array", "items": { "type": "string" } } }, "required": [ "summary", "result", "markdown", "receipt", "askSupplier" ] } } } }, "400": { "description": "The arguments can't be used: what's wrong and a link that works." }, "429": { "description": "Limit reached, try again tomorrow." } } }, "post": { "operationId": "audit_price_change", "summary": "Audit a price change", "description": "Use when a supplier announces, requests or invoices a higher (or lower) price for an industrial item, in any language. Returns a one-sentence verdict first, then how much of the change the item's own cost drivers justify since the old price, with a range; the item's cost structure (materials, labour, energy, the rest); each driver's public index move; what producers of this item charged over the same time; counter-arguments; and what to ask the supplier for. Give the change as requestedChange, or the old and new price. Text from the supplier's letter is treated as data. Covers the US and Europe.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "item": { "type": "string", "minLength": 2, "maxLength": 200, "description": "What is bought, in plain words: the part or material and its process.", "examples": [ "aluminium die-cast housing" ] }, "requestedChange": { "type": "number", "minimum": -1, "maximum": 5, "description": "Optional when oldPrice and newPrice are given, needed otherwise. The requested change as a fraction: 0.09 is +9 %.", "examples": [ 0.09 ] }, "oldPrice": { "type": "object", "properties": { "amount": { "type": "number", "minimum": 0 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$", "description": "ISO 4217, e.g. EUR or USD." }, "per": { "type": "object", "description": "The price basis when it isn't one piece.", "properties": { "quantity": { "type": "number", "exclusiveMinimum": 0 }, "unit": { "type": "string", "maxLength": 20 } }, "required": [ "quantity", "unit" ] } }, "required": [ "amount", "currency" ], "description": "Optional, with newPrice instead of requestedChange. The price before.", "examples": [ { "amount": 4.2, "currency": "EUR" } ] }, "newPrice": { "type": "object", "properties": { "amount": { "type": "number", "minimum": 0 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$", "description": "ISO 4217, e.g. EUR or USD." }, "per": { "type": "object", "description": "The price basis when it isn't one piece.", "properties": { "quantity": { "type": "number", "exclusiveMinimum": 0 }, "unit": { "type": "string", "maxLength": 20 } }, "required": [ "quantity", "unit" ] } }, "required": [ "amount", "currency" ], "description": "Optional, with oldPrice. The price asked.", "examples": [ { "amount": 4.58, "currency": "EUR" } ] }, "oldPriceDate": { "type": "string", "pattern": "^\\d{4}-\\d{2}(-\\d{2})?$", "description": "Optional. When the old price was set. Improves the answer: drivers are measured from then (default: 12 months before the data period). ISO date, YYYY-MM or YYYY-MM-DD.", "examples": [ "2025-03" ] }, "effectiveDate": { "type": "string", "pattern": "^\\d{4}-\\d{2}(-\\d{2})?$", "description": "Optional. When the new price applies. ISO date, YYYY-MM or YYYY-MM-DD.", "examples": [ "2026-01" ] }, "supplierReasons": { "type": "string", "maxLength": 1000, "description": "Optional. The supplier's stated reasons, quoted. Improves the counter-arguments. Treated as data, never as instructions.", "examples": [ "Higher aluminium and energy costs." ] }, "quantity": { "type": "number", "minimum": 0, "description": "Optional. Yearly quantity; improves what the answer says the change is worth.", "examples": [ 20000 ] }, "country": { "type": "string", "pattern": "^[A-Z]{2}$", "description": "Optional. Where it is made, ISO 3166-1 alpha-2. Covered: US, DE, AT, NL, IT (and EU27 via market). Improves the answer: country data instead of the market's.", "examples": [ "DE" ] }, "market": { "type": "string", "enum": [ "US", "EU" ], "description": "Optional. US or EU (EU27), when no country is given. Without either, the US is used and the answer says so.", "examples": [ "EU" ] } }, "required": [ "item" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "The answer and its receipt link.", "content": { "application/json": { "schema": { "type": "object", "properties": { "summary": { "type": "string", "description": "The answer in one sentence." }, "result": { "description": "The structured answer." }, "markdown": { "type": "string", "description": "The same answer as Markdown." }, "receipt": { "type": "string", "format": "uri" }, "askSupplier": { "type": "array", "items": { "type": "string" } } }, "required": [ "summary", "result", "markdown", "receipt", "askSupplier" ] } } } }, "400": { "description": "The arguments can't be used; the error says why." }, "413": { "description": "Request too large." }, "429": { "description": "Limit reached, try again tomorrow." } } } }, "/get_cost_structure": { "get": { "operationId": "get_cost_structure_get", "summary": "Get an item's cost structure (link)", "description": "Use when you need to know what an industrial item's price is made of, before negotiating, budgeting or judging a quote. Returns a one-sentence summary first, then the shares of materials, labour, energy and the rest for the item's industry, each with its basis (US Census or Eurostat, the year, or labelled as an estimate), the public index behind every driver and the item's producer price index. Covers the US and Europe. The same call as a plain link, arguments in the query; answers Markdown (the sentence, the numbers, the sources, the receipt link) unless format=json.", "parameters": [ { "name": "item", "in": "query", "required": true, "description": "What is bought, in plain words: the part or material and its process.", "schema": { "type": "string", "minLength": 2, "maxLength": 200 }, "example": "aluminium die-cast housing" }, { "name": "country", "in": "query", "required": false, "description": "Optional. Where it is made, ISO 3166-1 alpha-2. Covered: US, DE, AT, NL, IT (and EU27 via market). Improves the answer: country data instead of the market's.", "schema": { "type": "string", "pattern": "^[A-Z]{2}$" }, "example": "DE" }, { "name": "market", "in": "query", "required": false, "description": "Optional. US or EU (EU27), when no country is given. Without either, the US is used and the answer says so.", "schema": { "type": "string", "enum": [ "US", "EU" ] }, "example": "EU" }, { "name": "format", "in": "query", "required": false, "description": "Optional. markdown (the default) or json, the same body as the POST. Accept: application/json works too.", "schema": { "type": "string", "enum": [ "markdown", "json" ] }, "example": "json" } ], "responses": { "200": { "description": "The answer as Markdown, or as JSON with format=json.", "content": { "text/markdown": { "schema": { "type": "string" } }, "application/json": { "schema": { "type": "object", "properties": { "summary": { "type": "string", "description": "The answer in one sentence." }, "result": { "description": "The structured answer." }, "markdown": { "type": "string", "description": "The same answer as Markdown." }, "receipt": { "type": "string", "format": "uri" }, "askSupplier": { "type": "array", "items": { "type": "string" } } }, "required": [ "summary", "result", "markdown", "receipt", "askSupplier" ] } } } }, "400": { "description": "The arguments can't be used: what's wrong and a link that works." }, "429": { "description": "Limit reached, try again tomorrow." } } }, "post": { "operationId": "get_cost_structure", "summary": "Get an item's cost structure", "description": "Use when you need to know what an industrial item's price is made of, before negotiating, budgeting or judging a quote. Returns a one-sentence summary first, then the shares of materials, labour, energy and the rest for the item's industry, each with its basis (US Census or Eurostat, the year, or labelled as an estimate), the public index behind every driver and the item's producer price index. Covers the US and Europe.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "item": { "type": "string", "minLength": 2, "maxLength": 200, "description": "What is bought, in plain words: the part or material and its process.", "examples": [ "aluminium die-cast housing" ] }, "country": { "type": "string", "pattern": "^[A-Z]{2}$", "description": "Optional. Where it is made, ISO 3166-1 alpha-2. Covered: US, DE, AT, NL, IT (and EU27 via market). Improves the answer: country data instead of the market's.", "examples": [ "DE" ] }, "market": { "type": "string", "enum": [ "US", "EU" ], "description": "Optional. US or EU (EU27), when no country is given. Without either, the US is used and the answer says so.", "examples": [ "EU" ] } }, "required": [ "item" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "The answer and its receipt link.", "content": { "application/json": { "schema": { "type": "object", "properties": { "summary": { "type": "string", "description": "The answer in one sentence." }, "result": { "description": "The structured answer." }, "markdown": { "type": "string", "description": "The same answer as Markdown." }, "receipt": { "type": "string", "format": "uri" }, "askSupplier": { "type": "array", "items": { "type": "string" } } }, "required": [ "summary", "result", "markdown", "receipt", "askSupplier" ] } } } }, "400": { "description": "The arguments can't be used; the error says why." }, "413": { "description": "Request too large." }, "429": { "description": "Limit reached, try again tomorrow." } } } }, "/track_cost_drivers": { "get": { "operationId": "track_cost_drivers_get", "summary": "Track an item's cost drivers (link)", "description": "Use when you want to know how an industrial item's costs moved since a date, e.g. since the last price was agreed. Returns a one-sentence summary first, then each cost driver's public index move since that month, weighted by its share of the item's cost. Covers the US and Europe. The same call as a plain link, arguments in the query; answers Markdown (the sentence, the numbers, the sources, the receipt link) unless format=json.", "parameters": [ { "name": "item", "in": "query", "required": true, "description": "What is bought, in plain words: the part or material and its process.", "schema": { "type": "string", "minLength": 2, "maxLength": 200 }, "example": "aluminium die-cast housing" }, { "name": "since", "in": "query", "required": true, "description": "The start of the period. ISO date, YYYY-MM or YYYY-MM-DD.", "schema": { "type": "string", "pattern": "^\\d{4}-\\d{2}(-\\d{2})?$" }, "example": "2025-03" }, { "name": "country", "in": "query", "required": false, "description": "Optional. Where it is made, ISO 3166-1 alpha-2. Covered: US, DE, AT, NL, IT (and EU27 via market). Improves the answer: country data instead of the market's.", "schema": { "type": "string", "pattern": "^[A-Z]{2}$" }, "example": "DE" }, { "name": "market", "in": "query", "required": false, "description": "Optional. US or EU (EU27), when no country is given. Without either, the US is used and the answer says so.", "schema": { "type": "string", "enum": [ "US", "EU" ] }, "example": "EU" }, { "name": "format", "in": "query", "required": false, "description": "Optional. markdown (the default) or json, the same body as the POST. Accept: application/json works too.", "schema": { "type": "string", "enum": [ "markdown", "json" ] }, "example": "json" } ], "responses": { "200": { "description": "The answer as Markdown, or as JSON with format=json.", "content": { "text/markdown": { "schema": { "type": "string" } }, "application/json": { "schema": { "type": "object", "properties": { "summary": { "type": "string", "description": "The answer in one sentence." }, "result": { "description": "The structured answer." }, "markdown": { "type": "string", "description": "The same answer as Markdown." }, "receipt": { "type": "string", "format": "uri" }, "askSupplier": { "type": "array", "items": { "type": "string" } } }, "required": [ "summary", "result", "markdown", "receipt", "askSupplier" ] } } } }, "400": { "description": "The arguments can't be used: what's wrong and a link that works." }, "429": { "description": "Limit reached, try again tomorrow." } } }, "post": { "operationId": "track_cost_drivers", "summary": "Track an item's cost drivers", "description": "Use when you want to know how an industrial item's costs moved since a date, e.g. since the last price was agreed. Returns a one-sentence summary first, then each cost driver's public index move since that month, weighted by its share of the item's cost. Covers the US and Europe.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "item": { "type": "string", "minLength": 2, "maxLength": 200, "description": "What is bought, in plain words: the part or material and its process.", "examples": [ "aluminium die-cast housing" ] }, "since": { "type": "string", "pattern": "^\\d{4}-\\d{2}(-\\d{2})?$", "description": "The start of the period. ISO date, YYYY-MM or YYYY-MM-DD.", "examples": [ "2025-03" ] }, "country": { "type": "string", "pattern": "^[A-Z]{2}$", "description": "Optional. Where it is made, ISO 3166-1 alpha-2. Covered: US, DE, AT, NL, IT (and EU27 via market). Improves the answer: country data instead of the market's.", "examples": [ "DE" ] }, "market": { "type": "string", "enum": [ "US", "EU" ], "description": "Optional. US or EU (EU27), when no country is given. Without either, the US is used and the answer says so.", "examples": [ "EU" ] } }, "required": [ "item", "since" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "The answer and its receipt link.", "content": { "application/json": { "schema": { "type": "object", "properties": { "summary": { "type": "string", "description": "The answer in one sentence." }, "result": { "description": "The structured answer." }, "markdown": { "type": "string", "description": "The same answer as Markdown." }, "receipt": { "type": "string", "format": "uri" }, "askSupplier": { "type": "array", "items": { "type": "string" } } }, "required": [ "summary", "result", "markdown", "receipt", "askSupplier" ] } } } }, "400": { "description": "The arguments can't be used; the error says why." }, "413": { "description": "Request too large." }, "429": { "description": "Limit reached, try again tomorrow." } } } }, "/compare_countries": { "get": { "operationId": "compare_countries_get", "summary": "Compare countries (link)", "description": "Use when you are comparing where an industrial item is made. Returns the item's cost structure, labour and price trend side by side for the countries asked. Covers the US, EU27, Germany, Austria, the Netherlands and Italy (default: US, EU27, DE); any other country answers 'not covered yet' with the closest covered market. The same call as a plain link, arguments in the query; answers Markdown (the sentence, the numbers, the sources, the receipt link) unless format=json.", "parameters": [ { "name": "item", "in": "query", "required": true, "description": "What is bought, in plain words: the part or material and its process.", "schema": { "type": "string", "minLength": 2, "maxLength": 200 }, "example": "aluminium die-cast housing" }, { "name": "countries", "in": "query", "required": false, "description": "Optional. ISO country codes (or EU27) to compare. Default: US, EU27, DE.", "schema": { "type": "array", "items": { "type": "string", "pattern": "^([A-Z]{2}|EU27)$" }, "maxItems": 6 }, "example": [ "US", "DE" ], "style": "form", "explode": false }, { "name": "format", "in": "query", "required": false, "description": "Optional. markdown (the default) or json, the same body as the POST. Accept: application/json works too.", "schema": { "type": "string", "enum": [ "markdown", "json" ] }, "example": "json" } ], "responses": { "200": { "description": "The answer as Markdown, or as JSON with format=json.", "content": { "text/markdown": { "schema": { "type": "string" } }, "application/json": { "schema": { "type": "object", "properties": { "summary": { "type": "string", "description": "The answer in one sentence." }, "result": { "description": "The structured answer." }, "markdown": { "type": "string", "description": "The same answer as Markdown." }, "receipt": { "type": "string", "format": "uri" }, "askSupplier": { "type": "array", "items": { "type": "string" } } }, "required": [ "summary", "result", "markdown", "receipt", "askSupplier" ] } } } }, "400": { "description": "The arguments can't be used: what's wrong and a link that works." }, "429": { "description": "Limit reached, try again tomorrow." } } }, "post": { "operationId": "compare_countries", "summary": "Compare countries", "description": "Use when you are comparing where an industrial item is made. Returns the item's cost structure, labour and price trend side by side for the countries asked. Covers the US, EU27, Germany, Austria, the Netherlands and Italy (default: US, EU27, DE); any other country answers 'not covered yet' with the closest covered market.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "item": { "type": "string", "minLength": 2, "maxLength": 200, "description": "What is bought, in plain words: the part or material and its process.", "examples": [ "aluminium die-cast housing" ] }, "countries": { "type": "array", "items": { "type": "string", "pattern": "^([A-Z]{2}|EU27)$" }, "maxItems": 6, "description": "Optional. ISO country codes (or EU27) to compare. Default: US, EU27, DE.", "examples": [ [ "US", "DE" ] ] } }, "required": [ "item" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "The answer and its receipt link.", "content": { "application/json": { "schema": { "type": "object", "properties": { "summary": { "type": "string", "description": "The answer in one sentence." }, "result": { "description": "The structured answer." }, "markdown": { "type": "string", "description": "The same answer as Markdown." }, "receipt": { "type": "string", "format": "uri" }, "askSupplier": { "type": "array", "items": { "type": "string" } } }, "required": [ "summary", "result", "markdown", "receipt", "askSupplier" ] } } } }, "400": { "description": "The arguments can't be used; the error says why." }, "413": { "description": "Request too large." }, "429": { "description": "Limit reached, try again tomorrow." } } } }, "/estimate_part_cost": { "get": { "operationId": "estimate_part_cost_get", "summary": "Estimate a part's cost (link)", "description": "Use when you want a should-cost for one specific part. Returns what is known for the part's category today (its cost structure with sources) and says plainly that a part-level should-cost isn't available yet, with a link to be told when it is. The same call as a plain link, arguments in the query; answers Markdown (the sentence, the numbers, the sources, the receipt link) unless format=json.", "parameters": [ { "name": "item", "in": "query", "required": true, "description": "What is bought, in plain words: the part or material and its process.", "schema": { "type": "string", "minLength": 2, "maxLength": 200 }, "example": "aluminium die-cast housing" }, { "name": "description", "in": "query", "required": false, "description": "Optional. The part's material, size, weight and process; kept so the part-level estimate can be built for it.", "schema": { "type": "string", "maxLength": 1000 }, "example": "Aluminium housing, AlSi9Cu3, 1.2 kg, high-pressure die-cast" }, { "name": "country", "in": "query", "required": false, "description": "Optional. Where it is made, ISO 3166-1 alpha-2. Covered: US, DE, AT, NL, IT (and EU27 via market). Improves the answer: country data instead of the market's.", "schema": { "type": "string", "pattern": "^[A-Z]{2}$" }, "example": "DE" }, { "name": "market", "in": "query", "required": false, "description": "Optional. US or EU (EU27), when no country is given. Without either, the US is used and the answer says so.", "schema": { "type": "string", "enum": [ "US", "EU" ] }, "example": "EU" }, { "name": "format", "in": "query", "required": false, "description": "Optional. markdown (the default) or json, the same body as the POST. Accept: application/json works too.", "schema": { "type": "string", "enum": [ "markdown", "json" ] }, "example": "json" } ], "responses": { "200": { "description": "The answer as Markdown, or as JSON with format=json.", "content": { "text/markdown": { "schema": { "type": "string" } }, "application/json": { "schema": { "type": "object", "properties": { "summary": { "type": "string", "description": "The answer in one sentence." }, "result": { "description": "The structured answer." }, "markdown": { "type": "string", "description": "The same answer as Markdown." }, "receipt": { "type": "string", "format": "uri" }, "askSupplier": { "type": "array", "items": { "type": "string" } } }, "required": [ "summary", "result", "markdown", "receipt", "askSupplier" ] } } } }, "400": { "description": "The arguments can't be used: what's wrong and a link that works." }, "429": { "description": "Limit reached, try again tomorrow." } } }, "post": { "operationId": "estimate_part_cost", "summary": "Estimate a part's cost", "description": "Use when you want a should-cost for one specific part. Returns what is known for the part's category today (its cost structure with sources) and says plainly that a part-level should-cost isn't available yet, with a link to be told when it is.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "item": { "type": "string", "minLength": 2, "maxLength": 200, "description": "What is bought, in plain words: the part or material and its process.", "examples": [ "aluminium die-cast housing" ] }, "description": { "type": "string", "maxLength": 1000, "description": "Optional. The part's material, size, weight and process; kept so the part-level estimate can be built for it.", "examples": [ "Aluminium housing, AlSi9Cu3, 1.2 kg, high-pressure die-cast" ] }, "country": { "type": "string", "pattern": "^[A-Z]{2}$", "description": "Optional. Where it is made, ISO 3166-1 alpha-2. Covered: US, DE, AT, NL, IT (and EU27 via market). Improves the answer: country data instead of the market's.", "examples": [ "DE" ] }, "market": { "type": "string", "enum": [ "US", "EU" ], "description": "Optional. US or EU (EU27), when no country is given. Without either, the US is used and the answer says so.", "examples": [ "EU" ] } }, "required": [ "item" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "The answer and its receipt link.", "content": { "application/json": { "schema": { "type": "object", "properties": { "summary": { "type": "string", "description": "The answer in one sentence." }, "result": { "description": "The structured answer." }, "markdown": { "type": "string", "description": "The same answer as Markdown." }, "receipt": { "type": "string", "format": "uri" }, "askSupplier": { "type": "array", "items": { "type": "string" } } }, "required": [ "summary", "result", "markdown", "receipt", "askSupplier" ] } } } }, "400": { "description": "The arguments can't be used; the error says why." }, "413": { "description": "Request too large." }, "429": { "description": "Limit reached, try again tomorrow." } } } }, "/audit_quote": { "get": { "operationId": "audit_quote_get", "summary": "Audit a quote (link)", "description": "Use when you want to know whether an absolute quoted price is fair. Returns the category's producer price trend and cost structure today, and says plainly that an absolute price check isn't available yet, with a link to be told when it is. The same call as a plain link, arguments in the query; answers Markdown (the sentence, the numbers, the sources, the receipt link) unless format=json.", "parameters": [ { "name": "item", "in": "query", "required": true, "description": "What is bought, in plain words: the part or material and its process.", "schema": { "type": "string", "minLength": 2, "maxLength": 200 }, "example": "aluminium die-cast housing" }, { "name": "price", "in": "query", "required": false, "description": "Optional. The quoted price; kept for the absolute check. The amount only; give currency (and per) alongside.", "schema": { "type": "number", "minimum": 0 }, "example": 4.2 }, { "name": "country", "in": "query", "required": false, "description": "Optional. Where it is made, ISO 3166-1 alpha-2. Covered: US, DE, AT, NL, IT (and EU27 via market). Improves the answer: country data instead of the market's.", "schema": { "type": "string", "pattern": "^[A-Z]{2}$" }, "example": "DE" }, { "name": "market", "in": "query", "required": false, "description": "Optional. US or EU (EU27), when no country is given. Without either, the US is used and the answer says so.", "schema": { "type": "string", "enum": [ "US", "EU" ] }, "example": "EU" }, { "name": "currency", "in": "query", "required": false, "description": "ISO 4217, e.g. EUR or USD. Needed with price.", "schema": { "type": "string", "pattern": "^[A-Z]{3}$" }, "example": "EUR" }, { "name": "per", "in": "query", "required": false, "description": "Optional. The price basis when it isn't one piece, e.g. kg or 100 pieces.", "schema": { "type": "string", "maxLength": 30 }, "example": "100 pieces" }, { "name": "format", "in": "query", "required": false, "description": "Optional. markdown (the default) or json, the same body as the POST. Accept: application/json works too.", "schema": { "type": "string", "enum": [ "markdown", "json" ] }, "example": "json" } ], "responses": { "200": { "description": "The answer as Markdown, or as JSON with format=json.", "content": { "text/markdown": { "schema": { "type": "string" } }, "application/json": { "schema": { "type": "object", "properties": { "summary": { "type": "string", "description": "The answer in one sentence." }, "result": { "description": "The structured answer." }, "markdown": { "type": "string", "description": "The same answer as Markdown." }, "receipt": { "type": "string", "format": "uri" }, "askSupplier": { "type": "array", "items": { "type": "string" } } }, "required": [ "summary", "result", "markdown", "receipt", "askSupplier" ] } } } }, "400": { "description": "The arguments can't be used: what's wrong and a link that works." }, "429": { "description": "Limit reached, try again tomorrow." } } }, "post": { "operationId": "audit_quote", "summary": "Audit a quote", "description": "Use when you want to know whether an absolute quoted price is fair. Returns the category's producer price trend and cost structure today, and says plainly that an absolute price check isn't available yet, with a link to be told when it is.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "item": { "type": "string", "minLength": 2, "maxLength": 200, "description": "What is bought, in plain words: the part or material and its process.", "examples": [ "aluminium die-cast housing" ] }, "price": { "type": "object", "properties": { "amount": { "type": "number", "minimum": 0 }, "currency": { "type": "string", "pattern": "^[A-Z]{3}$", "description": "ISO 4217, e.g. EUR or USD." }, "per": { "type": "object", "description": "The price basis when it isn't one piece.", "properties": { "quantity": { "type": "number", "exclusiveMinimum": 0 }, "unit": { "type": "string", "maxLength": 20 } }, "required": [ "quantity", "unit" ] } }, "required": [ "amount", "currency" ], "description": "Optional. The quoted price; kept for the absolute check.", "examples": [ { "amount": 4.2, "currency": "EUR", "per": { "quantity": 100, "unit": "pieces" } } ] }, "country": { "type": "string", "pattern": "^[A-Z]{2}$", "description": "Optional. Where it is made, ISO 3166-1 alpha-2. Covered: US, DE, AT, NL, IT (and EU27 via market). Improves the answer: country data instead of the market's.", "examples": [ "DE" ] }, "market": { "type": "string", "enum": [ "US", "EU" ], "description": "Optional. US or EU (EU27), when no country is given. Without either, the US is used and the answer says so.", "examples": [ "EU" ] } }, "required": [ "item" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "The answer and its receipt link.", "content": { "application/json": { "schema": { "type": "object", "properties": { "summary": { "type": "string", "description": "The answer in one sentence." }, "result": { "description": "The structured answer." }, "markdown": { "type": "string", "description": "The same answer as Markdown." }, "receipt": { "type": "string", "format": "uri" }, "askSupplier": { "type": "array", "items": { "type": "string" } } }, "required": [ "summary", "result", "markdown", "receipt", "askSupplier" ] } } } }, "400": { "description": "The arguments can't be used; the error says why." }, "413": { "description": "Request too large." }, "429": { "description": "Limit reached, try again tomorrow." } } } }, "/find_suppliers": { "get": { "operationId": "find_suppliers_get", "summary": "Find suppliers (link)", "description": "Use when you are looking for producers of an industrial item in a country or region. Says what is known today and that named suppliers aren't available yet, with a link to be told when they are. The same call as a plain link, arguments in the query; answers Markdown (the sentence, the numbers, the sources, the receipt link) unless format=json.", "parameters": [ { "name": "item", "in": "query", "required": true, "description": "What is bought, in plain words: the part or material and its process.", "schema": { "type": "string", "minLength": 2, "maxLength": 200 }, "example": "aluminium die-cast housing" }, { "name": "country", "in": "query", "required": false, "description": "Optional. Where it is made, ISO 3166-1 alpha-2. Covered: US, DE, AT, NL, IT (and EU27 via market). Improves the answer: country data instead of the market's.", "schema": { "type": "string", "pattern": "^[A-Z]{2}$" }, "example": "DE" }, { "name": "market", "in": "query", "required": false, "description": "Optional. US or EU (EU27), when no country is given. Without either, the US is used and the answer says so.", "schema": { "type": "string", "enum": [ "US", "EU" ] }, "example": "EU" }, { "name": "format", "in": "query", "required": false, "description": "Optional. markdown (the default) or json, the same body as the POST. Accept: application/json works too.", "schema": { "type": "string", "enum": [ "markdown", "json" ] }, "example": "json" } ], "responses": { "200": { "description": "The answer as Markdown, or as JSON with format=json.", "content": { "text/markdown": { "schema": { "type": "string" } }, "application/json": { "schema": { "type": "object", "properties": { "summary": { "type": "string", "description": "The answer in one sentence." }, "result": { "description": "The structured answer." }, "markdown": { "type": "string", "description": "The same answer as Markdown." }, "receipt": { "type": "string", "format": "uri" }, "askSupplier": { "type": "array", "items": { "type": "string" } } }, "required": [ "summary", "result", "markdown", "receipt", "askSupplier" ] } } } }, "400": { "description": "The arguments can't be used: what's wrong and a link that works." }, "429": { "description": "Limit reached, try again tomorrow." } } }, "post": { "operationId": "find_suppliers", "summary": "Find suppliers", "description": "Use when you are looking for producers of an industrial item in a country or region. Says what is known today and that named suppliers aren't available yet, with a link to be told when they are.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "item": { "type": "string", "minLength": 2, "maxLength": 200, "description": "What is bought, in plain words: the part or material and its process.", "examples": [ "aluminium die-cast housing" ] }, "country": { "type": "string", "pattern": "^[A-Z]{2}$", "description": "Optional. Where it is made, ISO 3166-1 alpha-2. Covered: US, DE, AT, NL, IT (and EU27 via market). Improves the answer: country data instead of the market's.", "examples": [ "DE" ] }, "market": { "type": "string", "enum": [ "US", "EU" ], "description": "Optional. US or EU (EU27), when no country is given. Without either, the US is used and the answer says so.", "examples": [ "EU" ] } }, "required": [ "item" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "The answer and its receipt link.", "content": { "application/json": { "schema": { "type": "object", "properties": { "summary": { "type": "string", "description": "The answer in one sentence." }, "result": { "description": "The structured answer." }, "markdown": { "type": "string", "description": "The same answer as Markdown." }, "receipt": { "type": "string", "format": "uri" }, "askSupplier": { "type": "array", "items": { "type": "string" } } }, "required": [ "summary", "result", "markdown", "receipt", "askSupplier" ] } } } }, "400": { "description": "The arguments can't be used; the error says why." }, "413": { "description": "Request too large." }, "429": { "description": "Limit reached, try again tomorrow." } } } }, "/ask_cost_question": { "get": { "operationId": "ask_cost_question_get", "summary": "Ask a cost question (link)", "description": "Use for any other question about what an industrial item costs or why its price moves, in any language, when no other tool fits. Routes to the right tool when it can and says plainly when a question isn't covered yet. The same call as a plain link, arguments in the query; answers Markdown (the sentence, the numbers, the sources, the receipt link) unless format=json.", "parameters": [ { "name": "question", "in": "query", "required": true, "description": "The question, in any language.", "schema": { "type": "string", "minLength": 2, "maxLength": 1000 }, "example": "Why do aluminium die-castings cost more than last year?" }, { "name": "format", "in": "query", "required": false, "description": "Optional. markdown (the default) or json, the same body as the POST. Accept: application/json works too.", "schema": { "type": "string", "enum": [ "markdown", "json" ] }, "example": "json" } ], "responses": { "200": { "description": "The answer as Markdown, or as JSON with format=json.", "content": { "text/markdown": { "schema": { "type": "string" } }, "application/json": { "schema": { "type": "object", "properties": { "summary": { "type": "string", "description": "The answer in one sentence." }, "result": { "description": "The structured answer." }, "markdown": { "type": "string", "description": "The same answer as Markdown." }, "receipt": { "type": "string", "format": "uri" }, "askSupplier": { "type": "array", "items": { "type": "string" } } }, "required": [ "summary", "result", "markdown", "receipt", "askSupplier" ] } } } }, "400": { "description": "The arguments can't be used: what's wrong and a link that works." }, "429": { "description": "Limit reached, try again tomorrow." } } }, "post": { "operationId": "ask_cost_question", "summary": "Ask a cost question", "description": "Use for any other question about what an industrial item costs or why its price moves, in any language, when no other tool fits. Routes to the right tool when it can and says plainly when a question isn't covered yet.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "question": { "type": "string", "minLength": 2, "maxLength": 1000, "description": "The question, in any language.", "examples": [ "Why do aluminium die-castings cost more than last year?" ] } }, "required": [ "question" ], "additionalProperties": false } } } }, "responses": { "200": { "description": "The answer and its receipt link.", "content": { "application/json": { "schema": { "type": "object", "properties": { "summary": { "type": "string", "description": "The answer in one sentence." }, "result": { "description": "The structured answer." }, "markdown": { "type": "string", "description": "The same answer as Markdown." }, "receipt": { "type": "string", "format": "uri" }, "askSupplier": { "type": "array", "items": { "type": "string" } } }, "required": [ "summary", "result", "markdown", "receipt", "askSupplier" ] } } } }, "400": { "description": "The arguments can't be used; the error says why." }, "413": { "description": "Request too large." }, "429": { "description": "Limit reached, try again tomorrow." } } } } } }