diff --git a/api.yaml b/api.yaml
index bf12677..7f34af7 100644
--- a/api.yaml
+++ b/api.yaml
@@ -115,12 +115,12 @@ paths:
           name: from
           schema:
             type: string
-          description: A RFC3339 formatted date to start searching when articles are older than specified
+          description: Date to start searching when the article was created or modified, given in unix seconds
         - in: query
           name: to
           schema:
             type: string
-          description: A RFC3339 formatted date to stop searching when articles are older than specified
+          description: Date to end searching when the article was created or modified, given in unix seconds
         - in: query
           name: authors
           schema:
@@ -349,10 +349,10 @@ components:
             description: Id of tags to add
         created:
           type: string
-          description: A RFC3339 formatted date when the article was created
+          description: Date when the article was created, given in unix seconds
         modified:
           type: string
-          description: A RFC3339 formatted date when the article was modified
+          description: Date when the article was last modified, given in unix seconds
           nullable: true
         link:
           type: string