{"openapi":"3.1.0","info":{"title":"ShopiAgencias API","version":"1.0.0","description":"API pública y de solo lectura del directorio de agencias Shopify en España y Latinoamérica. No requiere autenticación."},"servers":[{"url":"https://shopiagencias.com"}],"paths":{"/api/agencias":{"get":{"operationId":"buscarAgencias","summary":"Buscar agencias Shopify","parameters":[{"name":"q","in":"query","schema":{"type":"string"},"description":"Texto libre: nombre, ciudad o país"},{"name":"pais","in":"query","schema":{"type":"string","enum":["espana","mexico","colombia","argentina","chile","peru","uruguay","ecuador","costa-rica","panama","guatemala","republica-dominicana"]}},{"name":"ciudad","in":"query","schema":{"type":"string","enum":["madrid","barcelona","valencia","sevilla","malaga","bilbao","a-coruna","alicante","elche","murcia","zaragoza","gijon","logrono","granada","valladolid","almeria","ourense","albacete","ciudad-de-mexico","guadalajara","monterrey","puebla","queretaro","merida","tijuana","hermosillo","pachuca","bogota","medellin","cali","barranquilla","bucaramanga","manizales","buenos-aires","cordoba","rosario","santiago","valparaiso","vina-del-mar","lima","arequipa","trujillo","cusco","piura","montevideo","quito","guayaquil","manta","san-jose","la-fortuna","ciudad-de-panama","ciudad-de-guatemala","santo-domingo","moca"]}},{"name":"servicio","in":"query","schema":{"type":"string","enum":["creacion-de-tiendas","diseno-ux","temas-a-medida","migraciones","shopify-plus","desarrollo-apps","headless","integraciones-erp","seo","cro","marketing-performance","email-marketing","internacionalizacion","b2b","velocidad","soporte-mantenimiento"]}},{"name":"presupuesto","in":"query","schema":{"type":"string","enum":["b1","b2","b3","b4","b5"]},"description":"b1: Menos de 2.000 US$; b2: 2.000 – 5.000 US$; b3: 5.000 – 15.000 US$; b4: 15.000 – 50.000 US$; b5: Más de 50.000 US$"},{"name":"tipo","in":"query","schema":{"type":"string","enum":["agencia","freelancer"]}},{"name":"plus","in":"query","schema":{"type":"boolean"},"description":"Solo agencias con experiencia en Shopify Plus"},{"name":"orden","in":"query","schema":{"type":"string","enum":["valoracion","resenas","nombre"]}},{"name":"limite","in":"query","schema":{"type":"integer","minimum":1,"maximum":100,"default":20}}],"responses":{"200":{"description":"Resultados","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SearchResult"}}}}}}},"/api/agencias/{slug}":{"get":{"operationId":"obtenerAgencia","summary":"Ficha de una agencia","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Agencia","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Agency"}}}},"404":{"description":"No encontrada"}}}},"/api/catalogo":{"get":{"operationId":"listarCatalogo","summary":"Países, ciudades, servicios y rangos de presupuesto","responses":{"200":{"description":"Catálogo"}}}}},"components":{"schemas":{"SearchResult":{"type":"object","properties":{"total":{"type":"integer"},"results":{"type":"array","items":{"$ref":"#/components/schemas/Agency"}}}},"Agency":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string","enum":["agencia","freelancer"]},"tagline":{"type":"string"},"description":{"type":"string"},"country":{"type":"string"},"city":{"type":["string","null"]},"location":{"type":"string"},"website":{"type":["string","null"]},"services":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"}}}},"languages":{"type":"array","items":{"type":"string"}},"shopifyPartner":{"type":"boolean"},"shopifyPlus":{"type":"boolean"},"verified":{"type":"boolean"},"rating":{"type":["object","null"],"properties":{"average":{"type":"number"},"count":{"type":"integer"}}},"url":{"type":"string","format":"uri"},"markdownUrl":{"type":"string","format":"uri"},"contactUrl":{"type":"string","format":"uri"}}}}}}