搜索 API

Tier: 基础版, 专业版, 旗舰版
Offering: JihuLab.com, 私有化部署

每一个 API 调用搜索都必须经过身份验证。

wiki_blobs
commits
blobs
notes

如果您想使用基本搜索，请参阅指定搜索类型。

高级搜索 API#

在整个极狐GitLab 实例中搜索一个术语。响应取决于请求的范围。

plaintext
GET /search

属性	类型	必需	描述
scope	string	是	要搜索的范围。值包括 projects、issues、merge_requests、milestones、snippet_titles 和 users。附加的范围包括 wiki_blobs、commits、blobs 和 notes。
search	string	是	搜索术语。
confidential	boolean	否	按保密性筛选。支持 issues 范围；其他范围被忽略。
order_by	string	否	允许的值仅为 created_at。如果未设置，结果将按基本搜索中的 created_at 降序排列，或按高级搜索中最相关的文档排列。
sort	string	否	允许的值仅为 asc 或 desc。如果未设置，结果将按基本搜索中的 created_at 降序排列，或按高级搜索中最相关的文档排列。
state	string	否	按状态筛选。支持 issues 和 merge_requests 范围；其他范围被忽略。
fields	array of strings	否	您希望搜索的字段数组，允许的值仅为 title。支持 issues 和 merge_requests 范围；其他范围被忽略。仅限专业版和旗舰版。

范围：projects#

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/search?scope=projects&search=flight"

示例响应：

json
1[
2  {
3    "id": 6,
4    "description": "Nobis sed ipsam vero quod cupiditate veritatis hic.",
5    "name": "Flight",
6    "name_with_namespace": "Twitter / Flight",
7    "path": "flight",
8    "path_with_namespace": "twitter/flight",
9    "created_at": "2017-09-05T07:58:01.621Z",
10    "default_branch": "main",
11    "tag_list":[], //deprecated, use `topics` instead
12    "topics":[],
13    "ssh_url_to_repo": "ssh://jarka@localhost:2222/twitter/flight.git",
14    "http_url_to_repo": "http://localhost:3000/twitter/flight.git",
15    "web_url": "http://localhost:3000/twitter/flight",
16    "readme_url": "http://localhost:3000/twitter/flight/-/blob/main/README.md",
17    "avatar_url": null,
18    "star_count": 0,
19    "forks_count": 0,
20    "last_activity_at": "2018-01-31T09:56:30.902Z"
21  }
22]

范围：issues#

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/search?scope=issues&search=file"

示例响应：

json
1[
2  {
3    "id": 83,
4    "iid": 1,
5    "project_id": 12,
6    "title": "Add file",
7    "description": "Add first file",
8    "state": "opened",
9    "created_at": "2018-01-24T06:02:15.514Z",
10    "updated_at": "2018-02-06T12:36:23.263Z",
11    "closed_at": null,
12    "labels":[],
13    "milestone": null,
14    "assignees": [{
15      "id": 20,
16      "name": "Ceola Deckow",
17      "username": "sammy.collier",
18      "state": "active",
19      "avatar_url": "https://www.gravatar.com/avatar/c23d85a4f50e0ea76ab739156c639231?s=80&d=identicon",
20      "web_url": "http://localhost:3000/sammy.collier"
21    }],
22    "author": {
23      "id": 1,
24      "name": "Administrator",
25      "username": "root",
26      "state": "active",
27      "avatar_url": "https://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",
28      "web_url": "http://localhost:3000/root"
29    },
30    "assignee": {
31      "id": 20,
32      "name": "Ceola Deckow",
33      "username": "sammy.collier",
34      "state": "active",
35      "avatar_url": "https://www.gravatar.com/avatar/c23d85a4f50e0ea76ab739156c639231?s=80&d=identicon",
36      "web_url": "http://localhost:3000/sammy.collier"
37    },
38    "user_notes_count": 0,
39    "upvotes": 0,
40    "downvotes": 0,
41    "due_date": null,
42    "confidential": false,
43    "discussion_locked": null,
44    "web_url": "http://localhost:3000/h5bp/7bp/subgroup-prj/issues/1",
45    "time_stats": {
46      "time_estimate": 0,
47      "total_time_spent": 0,
48      "human_time_estimate": null,
49      "human_total_time_spent": null
50    }
51  }
52]

`assignee` 列已弃用。现在显示为单个大小的数组 `assignees`，以符合极狐GitLab EE API。

范围：merge_requests#

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/search?scope=merge_requests&search=file"

示例响应：

json
1[
2  {
3    "id": 56,
4    "iid": 8,
5    "project_id": 6,
6    "title": "Add first file",
7    "description": "This is a test MR to add file",
8    "state": "opened",
9    "created_at": "2018-01-22T14:21:50.830Z",
10    "updated_at": "2018-02-06T12:40:33.295Z",
11    "target_branch": "main",
12    "source_branch": "jaja-test",
13    "upvotes": 0,
14    "downvotes": 0,
15    "author": {
16      "id": 1,
17      "name": "Administrator",
18      "username": "root",
19      "state": "active",
20      "avatar_url": "https://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",
21      "web_url": "http://localhost:3000/root"
22    },
23    "assignee": {
24      "id": 5,
25      "name": "Jacquelyn Kutch",
26      "username": "abigail",
27      "state": "active",
28      "avatar_url": "https://www.gravatar.com/avatar/3138c66095ee4bd11a508c2f7f7772da?s=80&d=identicon",
29      "web_url": "http://localhost:3000/abigail"
30    },
31    "source_project_id": 6,
32    "target_project_id": 6,
33    "labels": [
34      "ruby",
35      "tests"
36    ],
37    "draft": false,
38    "work_in_progress": false,
39    "milestone": {
40      "id": 13,
41      "iid": 3,
42      "project_id": 6,
43      "title": "v2.0",
44      "description": "Qui aut qui eos dolor beatae itaque tempore molestiae.",
45      "state": "active",
46      "created_at": "2017-09-05T07:58:29.099Z",
47      "updated_at": "2017-09-05T07:58:29.099Z",
48      "due_date": null,
49      "start_date": null
50    },
51    "merge_when_pipeline_succeeds": false,
52    "merge_status": "can_be_merged",
53    "sha": "78765a2d5e0a43585945c58e61ba2f822e4d090b",
54    "merge_commit_sha": null,
55    "squash_commit_sha": null,
56    "user_notes_count": 0,
57    "discussion_locked": null,
58    "should_remove_source_branch": null,
59    "force_remove_source_branch": true,
60    "web_url": "http://localhost:3000/twitter/flight/merge_requests/8",
61    "time_stats": {
62      "time_estimate": 0,
63      "total_time_spent": 0,
64      "human_time_estimate": null,
65      "human_total_time_spent": null
66    }
67  }
68]

范围：milestones#

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/search?scope=milestones&search=release"

示例响应：

json
1[
2  {
3    "id": 44,
4    "iid": 1,
5    "project_id": 12,
6    "title": "next release",
7    "description": "Next release milestone",
8    "state": "active",
9    "created_at": "2018-02-06T12:43:39.271Z",
10    "updated_at": "2018-02-06T12:44:01.298Z",
11    "due_date": "2018-04-18",
12    "start_date": "2018-02-04"
13  }
14]

范围：snippet_titles#

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/search?scope=snippet_titles&search=sample"

示例响应：

json
1[
2  {
3    "id": 50,
4    "title": "Sample file",
5    "file_name": "file.rb",
6    "description": "Simple ruby file",
7    "author": {
8      "id": 1,
9      "name": "Administrator",
10      "username": "root",
11      "state": "active",
12      "avatar_url": "https://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",
13      "web_url": "http://localhost:3000/root"
14    },
15    "updated_at": "2018-02-06T12:49:29.104Z",
16    "created_at": "2017-11-28T08:20:18.071Z",
17    "project_id": 9,
18    "web_url": "http://localhost:3000/root/jira-test/snippets/50"
19  }
20]

范围：users#

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/search?scope=users&search=doe"

示例响应：

json
1[
2  {
3    "id": 1,
4    "name": "John Doe1",
5    "username": "user1",
6    "state": "active",
7    "avatar_url": "http://www.gravatar.com/avatar/c922747a93b40d1ea88262bf1aebee62?s=80&d=identicon",
8    "web_url": "http://localhost/user1"
9  }
10]

范围：wiki_blobs#

Tier: 专业版, 旗舰版

此范围仅在高级搜索启用时可用。

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/search?scope=wiki_blobs&search=bye"

示例响应：

json
1
2[
3  {
4    "basename": "home",
5    "data": "hello\n\nand bye\n\nend",
6    "path": "home.md",
7    "filename": "home.md",
8    "id": null,
9    "ref": "main",
10    "startline": 5,
11    "project_id": 6,
12    "group_id": null
13  }
14]

`filename` 已弃用，建议使用 `path`。两者都返回文件在存储库中的完整路径，但未来 `filename` 仅用于表示文件名而非完整路径。详情请参阅[议题 34521](https://jihulab.com/gitlab-cn/gitlab/-/issues/34521)。

范围：commits#

Tier: 专业版, 旗舰版

此范围仅在高级搜索启用时可用。

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/search?scope=commits&search=bye"

示例响应：

json
1
2[
3  {
4  "id": "4109c2d872d5fdb1ed057400d103766aaea97f98",
5  "short_id": "4109c2d8",
6  "title": "goodbye $.browser",
7  "created_at": "2013-02-18T22:02:54.000Z",
8  "parent_ids": [
9    "59d05353ab575bcc2aa958fe1782e93297de64c9"
10  ],
11  "message": "goodbye $.browser\n",
12  "author_name": "angus croll",
13  "author_email": "anguscroll@gmail.com",
14  "authored_date": "2013-02-18T22:02:54.000Z",
15  "committer_name": "angus croll",
16  "committer_email": "anguscroll@gmail.com",
17  "committed_date": "2013-02-18T22:02:54.000Z",
18  "project_id": 6
19  }
20]

范围：blobs#

Tier: 专业版, 旗舰版

此范围仅在高级搜索启用时可用。

以下过滤器可用于此范围：

filename
path
extension

要使用过滤器，请在查询中包含它。例如：a query filename:some_name*。

您可以使用通配符（*）进行全局匹配。

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/search?scope=blobs&search=installation"

示例响应：

json
1
2[
3  {
4    "basename": "README",
5    "data": "```\n\n## Installation\n\nQuick start using the [pre-built",
6    "path": "README.md",
7    "filename": "README.md",
8    "id": null,
9    "ref": "main",
10    "startline": 46,
11    "project_id": 6
12  }
13]

范围：notes#

Tier: 专业版, 旗舰版

此范围仅在高级搜索启用时可用。

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/search?scope=notes&search=maxime"

示例响应：

json
1[
2  {
3    "id": 191,
4    "body": "Harum maxime consequuntur et et deleniti assumenda facilis.",
5    "attachment": null,
6    "author": {
7      "id": 23,
8      "name": "User 1",
9      "username": "user1",
10      "state": "active",
11      "avatar_url": "https://www.gravatar.com/avatar/111d68d06e2d317b5a59c2c6c5bad808?s=80&d=identicon",
12      "web_url": "http://localhost:3000/user1"
13    },
14    "created_at": "2017-09-05T08:01:32.068Z",
15    "updated_at": "2017-09-05T08:01:32.068Z",
16    "system": false,
17    "noteable_id": 22,
18    "noteable_type": "Issue",
19    "project_id": 6,
20    "noteable_iid": 2
21  }
22]

群组搜索 API#

在指定的群组中搜索一个术语。

如果用户不是群组的成员且群组是私有的，则对该群组的 GET 请求会导致 404 Not Found 状态码。

plaintext
GET /groups/:id/search

属性	类型	必需	描述
id	integer or string	是	群组的 ID 或URL 编码路径。
scope	string	是	要搜索的范围。值包括 projects、issues、merge_requests、milestones 和 users。附加的范围包括 wiki_blobs、commits、blobs 和 notes。
search	string	是	搜索术语。
confidential	boolean	否	按保密性筛选。仅支持 issues 范围；其他范围被忽略。
order_by	string	否	允许的值仅为 created_at。如果未设置，结果将按基本搜索中的 created_at 降序排列，或按高级搜索中最相关的文档排列。
sort	string	否	允许的值仅为 asc 或 desc。如果未设置，结果将按基本搜索中的 created_at 降序排列，或按高级搜索中最相关的文档排列。
state	string	否	按状态筛选。仅支持 issues 和 merge_requests；其他范围被忽略。

响应取决于请求的范围。

范围：projects#

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/3/search?scope=projects&search=flight"

示例响应：

json
1[
2  {
3    "id": 6,
4    "description": "Nobis sed ipsam vero quod cupiditate veritatis hic.",
5    "name": "Flight",
6    "name_with_namespace": "Twitter / Flight",
7    "path": "flight",
8    "path_with_namespace": "twitter/flight",
9    "created_at": "2017-09-05T07:58:01.621Z",
10    "default_branch": "main",
11    "tag_list":[], //deprecated, use `topics` instead
12    "topics":[],
13    "ssh_url_to_repo": "ssh://jarka@localhost:2222/twitter/flight.git",
14    "http_url_to_repo": "http://localhost:3000/twitter/flight.git",
15    "web_url": "http://localhost:3000/twitter/flight",
16    "readme_url": "http://localhost:3000/twitter/flight/-/blob/main/README.md",
17    "avatar_url": null,
18    "star_count": 0,
19    "forks_count": 0,
20    "last_activity_at": "2018-01-31T09:56:30.902Z"
21  }
22]

范围：issues#

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/3/search?scope=issues&search=file"

示例响应：

json
1[
2  {
3    "id": 83,
4    "iid": 1,
5    "project_id": 12,
6    "title": "Add file",
7    "description": "Add first file",
8    "state": "opened",
9    "created_at": "2018-01-24T06:02:15.514Z",
10    "updated_at": "2018-02-06T12:36:23.263Z",
11    "closed_at": null,
12    "labels":[],
13    "milestone": null,
14    "assignees": [{
15      "id": 20,
16      "name": "Ceola Deckow",
17      "username": "sammy.collier",
18      "state": "active",
19      "avatar_url": "https://www.gravatar.com/avatar/c23d85a4f50e0ea76ab739156c639231?s=80&d=identicon",
20      "web_url": "http://localhost:3000/sammy.collier"
21    }],
22    "author": {
23      "id": 1,
24      "name": "Administrator",
25      "username": "root",
26      "state": "active",
27      "avatar_url": "https://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",
28      "web_url": "http://localhost:3000/root"
29    },
30    "assignee": {
31      "id": 20,
32      "name": "Ceola Deckow",
33      "username": "sammy.collier",
34      "state": "active",
35      "avatar_url": "https://www.gravatar.com/avatar/c23d85a4f50e0ea76ab739156c639231?s=80&d=identicon",
36      "web_url": "http://localhost:3000/sammy.collier"
37    },
38    "user_notes_count": 0,
39    "upvotes": 0,
40    "downvotes": 0,
41    "due_date": null,
42    "confidential": false,
43    "discussion_locked": null,
44    "web_url": "http://localhost:3000/h5bp/7bp/subgroup-prj/issues/1",
45    "time_stats": {
46      "time_estimate": 0,
47      "total_time_spent": 0,
48      "human_time_estimate": null,
49      "human_total_time_spent": null
50    }
51  }
52]

`assignee` 列已弃用，现显示为单个大小的数组 `assignees`，以符合极狐GitLab EE API。

范围：merge_requests#

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/3/search?scope=merge_requests&search=file"

示例响应：

json
1[
2  {
3    "id": 56,
4    "iid": 8,
5    "project_id": 6,
6    "title": "Add first file",
7    "description": "This is a test MR to add file",
8    "state": "opened",
9    "created_at": "2018-01-22T14:21:50.830Z",
10    "updated_at": "2018-02-06T12:40:33.295Z",
11    "target_branch": "main",
12    "source_branch": "jaja-test",
13    "upvotes": 0,
14    "downvotes": 0,
15    "author": {
16      "id": 1,
17      "name": "Administrator",
18      "username": "root",
19      "state": "active",
20      "avatar_url": "https://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",
21      "web_url": "http://localhost:3000/root"
22    },
23    "assignee": {
24      "id": 5,
25      "name": "Jacquelyn Kutch",
26      "username": "abigail",
27      "state": "active",
28      "avatar_url": "https://www.gravatar.com/avatar/3138c66095ee4bd11a508c2f7f7772da?s=80&d=identicon",
29      "web_url": "http://localhost:3000/abigail"
30    },
31    "source_project_id": 6,
32    "target_project_id": 6,
33    "labels": [
34      "ruby",
35      "tests"
36    ],
37    "draft": false,
38    "work_in_progress": false,
39    "milestone": {
40      "id": 13,
41      "iid": 3,
42      "project_id": 6,
43      "title": "v2.0",
44      "description": "Qui aut qui eos dolor beatae itaque tempore molestiae.",
45      "state": "active",
46      "created_at": "2017-09-05T07:58:29.099Z",
47      "updated_at": "2017-09-05T07:58:29.099Z",
48      "due_date": null,
49      "start_date": null
50    },
51    "merge_when_pipeline_succeeds": false,
52    "merge_status": "can_be_merged",
53    "sha": "78765a2d5e0a43585945c58e61ba2f822e4d090b",
54    "merge_commit_sha": null,
55    "squash_commit_sha": null,
56    "user_notes_count": 0,
57    "discussion_locked": null,
58    "should_remove_source_branch": null,
59    "force_remove_source_branch": true,
60    "web_url": "http://localhost:3000/twitter/flight/merge_requests/8",
61    "time_stats": {
62      "time_estimate": 0,
63      "total_time_spent": 0,
64      "human_time_estimate": null,
65      "human_total_time_spent": null
66    }
67  }
68]

范围：milestones#

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/3/search?scope=milestones&search=release"

示例响应：

json
1[
2  {
3    "id": 44,
4    "iid": 1,
5    "project_id": 12,
6    "title": "next release",
7    "description": "Next release milestone",
8    "state": "active",
9    "created_at": "2018-02-06T12:43:39.271Z",
10    "updated_at": "2018-02-06T12:44:01.298Z",
11    "due_date": "2018-04-18",
12    "start_date": "2018-02-04"
13  }
14]

范围：users#

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/3/search?scope=users&search=doe"

示例响应：

json
1[
2  {
3    "id": 1,
4    "name": "John Doe1",
5    "username": "user1",
6    "state": "active",
7    "avatar_url": "http://www.gravatar.com/avatar/c922747a93b40d1ea88262bf1aebee62?s=80&d=identicon",
8    "web_url": "http://localhost/user1"
9  }
10]

范围：wiki_blobs#

Tier: 专业版, 旗舰版

此范围仅在高级搜索启用时可用。

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/6/search?scope=wiki_blobs&search=bye"

示例响应：

json
1
2[
3  {
4    "basename": "home",
5    "data": "hello\n\nand bye\n\nend",
6    "path": "home.md",
7    "filename": "home.md",
8    "id": null,
9    "ref": "main",
10    "startline": 5,
11    "project_id": 6,
12    "group_id": 1
13  }
14]

范围：commits#

Tier: 专业版, 旗舰版

此范围仅在高级搜索启用时可用。

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/6/search?scope=commits&search=bye"

示例响应：

json
1
2[
3  {
4  "id": "4109c2d872d5fdb1ed057400d103766aaea97f98",
5  "short_id": "4109c2d8",
6  "title": "goodbye $.browser",
7  "created_at": "2013-02-18T22:02:54.000Z",
8  "parent_ids": [
9    "59d05353ab575bcc2aa958fe1782e93297de64c9"
10  ],
11  "message": "goodbye $.browser\n",
12  "author_name": "angus croll",
13  "author_email": "anguscroll@gmail.com",
14  "authored_date": "2013-02-18T22:02:54.000Z",
15  "committer_name": "angus croll",
16  "committer_email": "anguscroll@gmail.com",
17  "committed_date": "2013-02-18T22:02:54.000Z",
18  "project_id": 6
19  }
20]

范围：blobs#

Tier: 专业版, 旗舰版

此范围仅在高级搜索启用时可用。

以下过滤器可用于此范围：

filename
path
extension

要使用过滤器，请在查询中包含它。例如：a query filename:some_name*。

您可以使用通配符（*）进行全局匹配。

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/6/search?scope=blobs&search=installation"

示例响应：

json
1
2[
3  {
4    "basename": "README",
5    "data": "```\n\n## Installation\n\nQuick start using the [pre-built",
6    "path": "README.md",
7    "filename": "README.md",
8    "id": null,
9    "ref": "main",
10    "startline": 46,
11    "project_id": 6
12  }
13]

范围：notes#

Tier: 专业版, 旗舰版

此范围仅在高级搜索启用时可用。

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/6/search?scope=notes&search=maxime"

示例响应：

json
1[
2  {
3    "id": 191,
4    "body": "Harum maxime consequuntur et et deleniti assumenda facilis.",
5    "attachment": null,
6    "author": {
7      "id": 23,
8      "name": "User 1",
9      "username": "user1",
10      "state": "active",
11      "avatar_url": "https://www.gravatar.com/avatar/111d68d06e2d317b5a59c2c6c5bad808?s=80&d=identicon",
12      "web_url": "http://localhost:3000/user1"
13    },
14    "created_at": "2017-09-05T08:01:32.068Z",
15    "updated_at": "2017-09-05T08:01:32.068Z",
16    "system": false,
17    "noteable_id": 22,
18    "noteable_type": "Issue",
19    "project_id": 6,
20    "noteable_iid": 2
21  }
22]

项目搜索 API#

在指定的项目中搜索一个术语。

如果用户不是项目的成员且项目是私有的，则对该项目的 GET 请求会导致 404 状态码。

plaintext
GET /projects/:id/search

属性	类型	必需	描述
id	integer or string	是	项目的 ID 或URL 编码路径。
scope	string	是	要搜索的范围。值包括 issues、merge_requests、milestones 和 users。附加的范围包括 wiki_blobs、commits、blobs 和 notes。
search	string	是	搜索术语。
confidential	boolean	否	按保密性筛选。支持 issues 范围；其他范围被忽略。
ref	string	否	要搜索的存储库分支或标签的名称。默认使用项目的默认分支。仅适用于 blobs、commits 和 wiki_blobs 范围。
order_by	string	否	允许的值仅为 created_at。如果未设置，结果将按基本搜索中的 created_at 降序排列，或按高级搜索中最相关的文档排列。
sort	string	否	允许的值仅为 asc 或 desc。如果未设置，结果将按基本搜索中的 created_at 降序排列，或按高级搜索中最相关的文档排列。
state	string	否	按状态筛选。支持 issues 和 merge_requests 范围；其他范围被忽略。

响应取决于请求的范围。

范围：issues#

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/12/search?scope=issues&search=file"

示例响应：

json
1[
2  {
3    "id": 83,
4    "iid": 1,
5    "project_id": 12,
6    "title": "Add file",
7    "description": "Add first file",
8    "state": "opened",
9    "created_at": "2018-01-24T06:02:15.514Z",
10    "updated_at": "2018-02-06T12:36:23.263Z",
11    "closed_at": null,
12    "labels":[],
13    "milestone": null,
14    "assignees": [{
15      "id": 20,
16      "name": "Ceola Deckow",
17      "username": "sammy.collier",
18      "state": "active",
19      "avatar_url": "https://www.gravatar.com/avatar/c23d85a4f50e0ea76ab739156c639231?s=80&d=identicon",
20      "web_url": "http://localhost:3000/sammy.collier"
21    }],
22    "author": {
23      "id": 1,
24      "name": "Administrator",
25      "username": "root",
26      "state": "active",
27      "avatar_url": "https://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",
28      "web_url": "http://localhost:3000/root"
29    },
30    "assignee": {
31      "id": 20,
32      "name": "Ceola Deckow",
33      "username": "sammy.collier",
34      "state": "active",
35      "avatar_url": "https://www.gravatar.com/avatar/c23d85a4f50e0ea76ab739156c639231?s=80&d=identicon",
36      "web_url": "http://localhost:3000/sammy.collier"
37    },
38    "user_notes_count": 0,
39    "upvotes": 0,
40    "downvotes": 0,
41    "due_date": null,
42    "confidential": false,
43    "discussion_locked": null,
44    "web_url": "http://localhost:3000/h5bp/7bp/subgroup-prj/issues/1",
45    "time_stats": {
46      "time_estimate": 0,
47      "total_time_spent": 0,
48      "human_time_estimate": null,
49      "human_total_time_spent": null
50    }
51  }
52]

`assignee` 列已弃用，现显示为单个大小的数组 `assignees`，以符合极狐GitLab EE API。

范围：merge_requests#

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/6/search?scope=merge_requests&search=file"

示例响应：

json
1[
2  {
3    "id": 56,
4    "iid": 8,
5    "project_id": 6,
6    "title": "Add first file",
7    "description": "This is a test MR to add file",
8    "state": "opened",
9    "created_at": "2018-01-22T14:21:50.830Z",
10    "updated_at": "2018-02-06T12:40:33.295Z",
11    "target_branch": "main",
12    "source_branch": "jaja-test",
13    "upvotes": 0,
14    "downvotes": 0,
15    "author": {
16      "id": 1,
17      "name": "Administrator",
18      "username": "root",
19      "state": "active",
20      "avatar_url": "https://www.gravatar.com/avatar/e64c7d89f26bd1972efa854d13d7dd61?s=80&d=identicon",
21      "web_url": "http://localhost:3000/root"
22    },
23    "assignee": {
24      "id": 5,
25      "name": "Jacquelyn Kutch",
26      "username": "abigail",
27      "state": "active",
28      "avatar_url": "https://www.gravatar.com/avatar/3138c66095ee4bd11a508c2f7f7772da?s=80&d=identicon",
29      "web_url": "http://localhost:3000/abigail"
30    },
31    "source_project_id": 6,
32    "target_project_id": 6,
33    "labels": [
34      "ruby",
35      "tests"
36    ],
37    "draft": false,
38    "work_in_progress": false,
39    "milestone": {
40      "id": 13,
41      "iid": 3,
42      "project_id": 6,
43      "title": "v2.0",
44      "description": "Qui aut qui eos dolor beatae itaque tempore molestiae.",
45      "state": "active",
46      "created_at": "2017-09-05T07:58:29.099Z",
47      "updated_at": "2017-09-05T07:58:29.099Z",
48      "due_date": null,
49      "start_date": null
50    },
51    "merge_when_pipeline_succeeds": false,
52    "merge_status": "can_be_merged",
53    "sha": "78765a2d5e0a43585945c58e61ba2f822e4d090b",
54    "merge_commit_sha": null,
55    "squash_commit_sha": null,
56    "user_notes_count": 0,
57    "discussion_locked": null,
58    "should_remove_source_branch": null,
59    "force_remove_source_branch": true,
60    "web_url": "http://localhost:3000/twitter/flight/merge_requests/8",
61    "time_stats": {
62      "time_estimate": 0,
63      "total_time_spent": 0,
64      "human_time_estimate": null,
65      "human_total_time_spent": null
66    }
67  }
68]

范围：milestones#

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/12/search?scope=milestones&search=release"

示例响应：

json
1[
2  {
3    "id": 44,
4    "iid": 1,
5    "project_id": 12,
6    "title": "next release",
7    "description": "Next release milestone",
8    "state": "active",
9    "created_at": "2018-02-06T12:43:39.271Z",
10    "updated_at": "2018-02-06T12:44:01.298Z",
11    "due_date": "2018-04-18",
12    "start_date": "2018-02-04"
13  }
14]

范围：users {#scope-users}#

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/6/search?scope=users&search=doe"

示例响应：

json
1[
2  {
3    "id": 1,
4    "name": "John Doe1",
5    "username": "user1",
6    "state": "active",
7    "avatar_url": "http://www.gravatar.com/avatar/c922747a93b40d1ea88262bf1aebee62?s=80&d=identicon",
8    "web_url": "http://localhost/user1"
9  }
10]

范围：wiki_blobs {#scope-wiki_blobs}#

Tier: Professional, Ultimate

此范围仅在启用高级搜索时可用。

此范围可用的过滤器如下：

filename
path
extension

要使用过滤器，请将其包含在查询中。例如：a query filename:some_name*。您可以使用通配符 (*) 进行全局匹配。Wiki blobs 搜索是在文件名和内容上进行的。搜索结果：

在文件名中找到的结果显示在内容中找到的结果之前。
可能包含同一 blob 的多个匹配项，因为搜索字符串可能在文件名和内容中都找到，或者可能在内容中多次出现。

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/6/search?scope=wiki_blobs&search=bye"

示例响应：

json
1[
2  {
3    "basename": "home",
4    "data": "hello\n\nand bye\n\nend",
5    "path": "home.md",
6    "filename": "home.md",
7    "id": null,
8    "ref": "main",
9    "startline": 5,
10    "project_id": 6,
11    "group_id": 1
12  }
13]

`filename` 已被弃用，建议使用 `path`。两者都返回文件在存储库内的完整路径，但将来 `filename` 仅打算是文件名而不是完整路径。

范围：commits {#scope-commits}#

Tier: Professional, Ultimate

此范围仅在启用高级搜索时可用。

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/6/search?scope=commits&search=bye"

示例响应：

json
1[
2  {
3  "id": "4109c2d872d5fdb1ed057400d103766aaea97f98",
4  "short_id": "4109c2d8",
5  "title": "goodbye $.browser",
6  "created_at": "2013-02-18T22:02:54.000Z",
7  "parent_ids": [
8    "59d05353ab575bcc2aa958fe1782e93297de64c9"
9  ],
10  "message": "goodbye $.browser\n",
11  "author_name": "angus croll",
12  "author_email": "anguscroll@gmail.com",
13  "authored_date": "2013-02-18T22:02:54.000Z",
14  "committer_name": "angus croll",
15  "committer_email": "anguscroll@gmail.com",
16  "committed_date": "2013-02-18T22:02:54.000Z",
17  "project_id": 6
18  }
19]

范围：blobs {#scope-blobs}#

Tier: Professional, Ultimate

此范围仅在启用高级搜索时可用。

此范围可用的过滤器如下：

filename
path
extension

要使用过滤器，请将其包含在查询中。例如：a query filename:some_name*。您可以使用通配符 (*) 进行全局匹配。Blobs 搜索是在文件名和内容上进行的。搜索结果：

在文件名中找到的结果显示在内容中找到的结果之前。
可能包含同一 blob 的多个匹配项，因为搜索字符串可能在文件名和内容中都找到，或者可能在内容中多次出现。

shell
curl --request GET --header "PRIVATE-TOKEN: <your_access_token>" https://gitlab.example.com/api/v4/projects/6/search?scope=blobs&search=keyword%20filename:*.py

示例响应：

json
1[
2  {
3    "basename": "README",
4    "data": "```\n\n## Installation\n\nQuick start using the [pre-built",
5    "path": "README.md",
6    "filename": "README.md",
7    "id": null,
8    "ref": "main",
9    "startline": 46,
10    "project_id": 6
11  }
12]

`filename` 已被弃用，建议使用 `path`。两者都返回文件在存储库内的完整路径，但将来 `filename` 仅打算是文件名而不是完整路径。

范围：notes {#scope-notes}#

Tier: Professional, Ultimate

shell
curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/6/search?scope=notes&search=maxime"

示例响应：

json
1[
2  {
3    "id": 191,
4    "body": "Harum maxime consequuntur et et deleniti assumenda facilis.",
5    "attachment": null,
6    "author": {
7      "id": 23,
8      "name": "User 1",
9      "username": "user1",
10      "state": "active",
11      "avatar_url": "https://www.gravatar.com/avatar/111d68d06e2d317b5a59c2c6c5bad808?s=80&d=identicon",
12      "web_url": "http://localhost:3000/user1"
13    },
14    "created_at": "2017-09-05T08:01:32.068Z",
15    "updated_at": "2017-09-05T08:01:32.068Z",
16    "system": false,
17    "noteable_id": 22,
18    "noteable_type": "Issue",
19    "project_id": 6,
20    "noteable_iid": 2
21  }
22]