{"openapi":"3.0.3","info":{"title":"x402labs.sh API","description":"Public x402labs.sh paid API endpoints","version":"0.1.0"},"components":{"schemas":{}},"paths":{"/openapi.json":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/llms.txt":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/health":{"get":{"responses":{"200":{"description":"Default Response"}}}},"/v1/scraping/scrape":{"post":{"summary":"Scrape a single URL (Firecrawl)","tags":["scraping"],"description":"Returns HTML and/or Markdown from a single URL via Firecrawl. Protected by x402.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["url"],"additionalProperties":false,"properties":{"url":{"type":"string","format":"uri"},"formats":{"type":"array","items":{"type":"string","enum":["html","markdown"]}},"onlyMainContent":{"type":"boolean"},"includeTags":{"type":"array","items":{"type":"string"}},"excludeTags":{"type":"array","items":{"type":"string"}},"maxAge":{"type":"integer","minimum":0},"headers":{"type":"object","additionalProperties":{"type":"string"}},"waitFor":{"type":"integer","minimum":0},"mobile":{"type":"boolean"},"skipTlsVerification":{"type":"boolean"},"timeout":{"type":"integer","minimum":1},"parsers":{"type":"array","items":{"anyOf":[{"type":"string"},{"type":"object","required":["type"],"additionalProperties":false,"properties":{"type":{"type":"string","enum":["pdf"]},"maxPages":{"type":"integer","minimum":1}}}]}},"actions":{"type":"array","items":{"type":"object","required":["type"],"additionalProperties":true,"properties":{"type":{"type":"string"}}}},"location":{"type":"object","additionalProperties":false,"properties":{"country":{"type":"string"},"languages":{"type":"array","items":{"type":"string"}}}},"removeBase64Images":{"type":"boolean"},"blockAds":{"type":"boolean"},"proxy":{"type":"string"},"storeInCache":{"type":"boolean"},"zeroDataRetention":{"type":"boolean"}}},"example":{"url":"https://example.com","formats":["markdown"],"onlyMainContent":true}}}},"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"details":{"type":"object","additionalProperties":true}}}}}}}},"402":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"},"details":{"type":"object","additionalProperties":true}}}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"},"details":{"type":"object","additionalProperties":true}}}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"},"details":{"type":"object","additionalProperties":true}}}}}}}},"502":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"},"details":{"type":"object","additionalProperties":true}}}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"},"details":{"type":"object","additionalProperties":true}}}}}}}}},"x-example-summary":"Extract the main content from a public web page as Markdown.","x-example-kind":"illustrative"}},"/v1/social/truthsocial/profile":{"get":{"summary":"Fetch a Truth Social profile","tags":["social"],"description":"Returns public Truth Social profile data from ScrapeCreators. Protected by x402.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"handle","required":true,"example":"exampleUser"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"required":["message"]}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"required":["message"]}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"required":["message"]}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"required":["message"]}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"required":["message"]}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"required":["message"]}}}}}}},"x-example-summary":"Look up an illustrative public profile handle.","x-example-kind":"illustrative"}},"/v1/social/truthsocial/user-posts":{"get":{"summary":"Fetch Truth Social posts by profile","tags":["social"],"description":"Returns public Truth Social posts from ScrapeCreators. Protected by x402.","parameters":[{"schema":{"type":"string","minLength":1,"maxLength":64},"in":"query","name":"handle","required":false,"example":"exampleUser"},{"schema":{"type":"string","minLength":1,"maxLength":32,"pattern":"^[0-9]+$"},"in":"query","name":"userId","required":false},{"schema":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[0-9]+$"},"in":"query","name":"nextMaxId","required":false},{"schema":{"type":"boolean"},"in":"query","name":"trim","required":false,"example":true}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"required":["message"]}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"required":["message"]}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"required":["message"]}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"required":["message"]}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"required":["message"]}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"required":["message"]}}}}}}},"x-example-summary":"Fetch an illustrative profile timeline with trimmed output.","x-example-kind":"illustrative"}},"/v1/social/truthsocial/post":{"get":{"summary":"Fetch a single Truth Social post by URL","tags":["social"],"description":"Returns a single public Truth Social post from ScrapeCreators. Protected by x402.","parameters":[{"schema":{"type":"string","format":"uri","maxLength":256,"pattern":"^https://truthsocial\\.com/@[^/]+/(posts/)?[0-9]+/?$"},"in":"query","name":"url","required":true,"example":"https://truthsocial.com/@exampleUser/posts/1234567890"}],"responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"400":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"required":["message"]}}}}}},"401":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"required":["message"]}}}}}},"403":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"required":["message"]}}}}}},"404":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"required":["message"]}}}}}},"429":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"required":["message"]}}}}}},"503":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","properties":{"error":{"type":"object","properties":{"message":{"type":"string"},"code":{"type":"string"},"details":{"type":"object","additionalProperties":true}},"required":["message"]}}}}}}},"x-example-summary":"Fetch an illustrative post by canonical URL.","x-example-kind":"illustrative"}},"/v1/pricing":{"get":{"summary":"List x402-protected route prices","tags":["pricing"],"description":"Returns current x402 route pricing metadata for agent/tool consumers.","responses":{"200":{"description":"Default Response","content":{"application/json":{"schema":{"type":"object","required":["enabled","facilitatorUrl","routes"],"properties":{"enabled":{"type":"boolean"},"facilitatorUrl":{"type":"string"},"routes":{"type":"array","items":{"type":"object","required":["route","method","path","price","network"],"properties":{"route":{"type":"string"},"method":{"type":"string"},"path":{"type":"string"},"price":{"type":"string"},"description":{"type":"string"},"mimeType":{"type":"string"},"network":{"type":"string"}}}}}}}}}}}}}}