{"openapi":"3.0.0","info":{"title":"ASO Tool API","version":"1.0.0","description":"API documentation for ASO Tool - App Store Optimization platform","contact":{"name":"API Support","email":"support@appalize.com"},"license":{"name":"MIT","url":"https://opensource.org/licenses/MIT"}},"servers":[{"url":"/","description":"Current host (Relative)"},{"url":"https://api.appalize.com","description":"Production API"},{"url":"http://localhost:5001","description":"Backend server (Direct)"}],"components":{"securitySchemes":{"apiKey":{"type":"apiKey","in":"header","name":"x-api-key","description":"Enter your API Key here (e.g., apk_...)"}},"schemas":{"Error":{"type":"object","properties":{"success":{"type":"boolean","example":false},"error":{"type":"string","example":"VALIDATION_ERROR"},"message":{"type":"string","example":"Invalid input provided"},"statusCode":{"type":"number","example":400},"timestamp":{"type":"string","format":"date-time"},"path":{"type":"string","example":"/api/user-keywords"}}},"PaginationParams":{"type":"object","properties":{"page":{"type":"number","minimum":1,"default":1,"description":"Page number"},"limit":{"type":"number","minimum":1,"maximum":100,"default":20,"description":"Number of items per page"},"sortBy":{"type":"string","enum":["createdAt","updatedAt","text"],"default":"createdAt","description":"Field to sort by"},"sortOrder":{"type":"string","enum":["asc","desc"],"default":"desc","description":"Sort order"},"search":{"type":"string","description":"Search term to filter keywords"}}},"PaginatedResponse":{"type":"object","properties":{"data":{"type":"array","items":{"type":"object"}},"pagination":{"type":"object","properties":{"page":{"type":"number"},"limit":{"type":"number"},"total":{"type":"number"},"totalPages":{"type":"number"},"hasNext":{"type":"boolean"},"hasPrev":{"type":"boolean"}}}}}},"responses":{"UnauthorizedError":{"description":"Authentication required","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"success":false,"error":"AUTHENTICATION_ERROR","message":"Authentication required","statusCode":401}}}},"ValidationError":{"description":"Validation error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"success":false,"error":"VALIDATION_ERROR","message":"Invalid input provided","statusCode":400}}}},"NotFoundError":{"description":"Resource not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"},"example":{"success":false,"error":"NOT_FOUND_ERROR","message":"Resource not found","statusCode":404}}}}}},"tags":[{"name":"Authentication","description":"User authentication and authorization endpoints"},{"name":"User Keywords","description":"Manage user keywords and tracking"},{"name":"Tags","description":"Manage tags for keywords"},{"name":"Apps","description":"App Store data and information"},{"name":"Health","description":"Health check and system status"}],"security":[{"apiKey":[]}],"paths":{}}