{"openapi":"3.1.0","info":{"title":"Satisfactory Expert Wiki API","version":"2.0.0","description":"Read-only, cached wiki lookup API for a Satisfactory Expert GPT. Uses satisfactory.wiki.gg first and the Fandom wiki as fallback."},"servers":[{"url":"https://sf.yeth.dev"}],"paths":{"/api/search":{"get":{"operationId":"searchSatisfactoryWiki","summary":"Search the Satisfactory wiki","description":"Use this before requesting a page when the exact wiki page title is uncertain.","security":[{"oauth2":["satisfactory.read"]}],"parameters":[{"name":"q","in":"query","required":true,"schema":{"type":"string"},"description":"Search text, such as Aluminum Ingot or Coal Generator."},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":12,"default":6}}],"responses":{"200":{"description":"Wiki search results"}}}},"/api/facts":{"get":{"operationId":"getSatisfactoryFacts","summary":"Get compact facts for an item, building, recipe, or resource","description":"Fast structured lookup for stack size, AWESOME Sink points, energy, power, fuel values, recipe details, obtaining text, infobox values, and related facts.","security":[{"oauth2":["satisfactory.read"]}],"parameters":[{"name":"title","in":"query","required":true,"schema":{"type":"string"},"description":"Exact or redirected wiki page title, such as Coal, Iron Ingot, or Coal-Powered Generator."}],"responses":{"200":{"description":"Compact facts extracted from the wiki page"}}}},"/api/page":{"get":{"operationId":"getSatisfactoryWikiPage","summary":"Get a full wiki page or one named section","description":"Use for full page data, tables, obtaining information, usage sections, recipes, raw wikitext, or raw HTML. Set section=Obtaining to retrieve only that section.","security":[{"oauth2":["satisfactory.read"]}],"parameters":[{"name":"title","in":"query","required":true,"schema":{"type":"string"},"description":"Exact or redirected wiki page title."},{"name":"section","in":"query","required":false,"schema":{"type":"string"},"description":"Optional section name, such as Obtaining, Usage, Trivia, or Recipes."},{"name":"includeTables","in":"query","required":false,"schema":{"type":"boolean","default":true}},{"name":"includeWikitext","in":"query","required":false,"schema":{"type":"boolean","default":false}},{"name":"includeHtml","in":"query","required":false,"schema":{"type":"boolean","default":false}},{"name":"maxChars","in":"query","required":false,"schema":{"type":"integer","minimum":1000,"maximum":100000,"default":40000}}],"responses":{"200":{"description":"Requested wiki page data"}}}}},"components":{"schemas":{},"securitySchemes":{"oauth2":{"type":"oauth2","flows":{"authorizationCode":{"authorizationUrl":"https://sf.yeth.dev/oauth/authorize","tokenUrl":"https://sf.yeth.dev/oauth/token","scopes":{"satisfactory.read":"Read cached public Satisfactory wiki information"}}}}}}}