{"openapi":"3.1.0","info":{"title":"TuBack.link Public API","version":"1.0.0","description":"Public endpoints for agents that need to understand TuBack.link backlink categories and limited public opportunities."},"servers":[{"url":"https://tuback.link"}],"paths":{"/api/public/backlinks":{"get":{"summary":"List public backlink opportunities for a category","description":"Returns a limited public sample of backlink opportunities. It does not expose private user data or admin-only information.","parameters":[{"name":"category","in":"query","required":false,"schema":{"type":"string","enum":["all","moda","belleza","hogar","tecnologia","alimentacion","salud","deporte","mascotas","joyeria","bebes-infantil","automocion","libros-papeleria","arte-diseno","b2b-industrial","software-digital","marketplace-general","turismo-ocio","sostenibilidad"],"default":"all"}},{"name":"limit","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":10,"default":10}}],"responses":{"200":{"description":"Public backlink opportunities","content":{"application/json":{"schema":{"type":"object","properties":{"site":{"type":"string"},"category":{"type":"object"},"backlinks":{"type":"array","items":{"type":"object"}}}}}}}}}},"/api/search":{"post":{"summary":"Generate backlink recommendations","description":"Generates backlink recommendations for a store URL and ecommerce category. Anonymous users receive limited results; authenticated users can unlock and save history.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["ecommerceName","category"],"properties":{"ecommerceName":{"type":"string","example":"Tu tienda"},"category":{"type":"string","example":"all"},"siteUrl":{"type":"string","example":"https://tutienda.com"},"save":{"type":"boolean","example":true}}}}}},"responses":{"200":{"description":"Search response with backlink opportunities"},"400":{"description":"Invalid request"},"429":{"description":"Rate limited"}}}}}}