diff --git a/lib/Github/Api/Issue.php b/lib/Github/Api/Issue.php
index 5a42d5cd4bd..f77d4e4a22d 100644
--- a/lib/Github/Api/Issue.php
+++ b/lib/Github/Api/Issue.php
@@ -60,6 +60,8 @@ public function all($username, $repository, array $params = array())
     /**
      * Search issues by username, repo, state and keyword.
      *
+     * @deprecated This method is deprecated use the Search api instead. See https://developer.github.com/v3/search/legacy/#legacy-search-api-is-deprecated
+     *
      * @link http://developer.github.com/v3/search/#search-issues
      *
      * @param string $username   the username
diff --git a/lib/Github/Api/Repo.php b/lib/Github/Api/Repo.php
index 9598d6d04ec..1578bc60b5b 100644
--- a/lib/Github/Api/Repo.php
+++ b/lib/Github/Api/Repo.php
@@ -31,6 +31,8 @@ class Repo extends AbstractApi
     /**
      * Search repositories by keyword.
      *
+     * @deprecated This method is deprecated use the Search api instead. See https://developer.github.com/v3/search/legacy/#legacy-search-api-is-deprecated
+     *
      * @link http://developer.github.com/v3/search/#search-repositories
      *
      * @param string $keyword the search query
diff --git a/lib/Github/Api/User.php b/lib/Github/Api/User.php
index 856e86c17fa..570b3c0c719 100644
--- a/lib/Github/Api/User.php
+++ b/lib/Github/Api/User.php
@@ -14,6 +14,8 @@ class User extends AbstractApi
     /**
      * Search users by username.
      *
+     * @deprecated This method is deprecated use the Search api instead. See https://developer.github.com/v3/search/legacy/#legacy-search-api-is-deprecated
+     *
      * @link http://developer.github.com/v3/search/#search-users
      *
      * @param string $keyword the keyword to search