SearchSkills - Cloud Skills Portal - Alibaba Cloud Documentation Center

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request syntax

GET /openapi/skills HTTP/1.1

Request parameters

Parameter	Type	Required	Description	Example
keyword	string	No	The search keyword.	ecs
categoryCode	string	No	The skill category code. Separate multiple codes with commas. For a second-level category, use the format: first-level category.second-level category.	compute.serverless,network
nextToken	string	No	The token for the next query. Set this to the NextToken value returned by the previous API call.	AAAAAZjtYxxxxxxxx
maxResults	integer	No	The maximum number of entries per page for a paged query. Maximum value: 100. Default value: 20.	20
skip	integer	No	The number of entries to skip for pagination.	10
searchMode	string	No	Specifies the search mode. Set this to semantic to enable vector search.	semantic

Response elements

Element	Type	Description	Example
	object	Schema of Response
requestId	string	Id of the request	53EAEBC0-4DEC-5AF4-AA21-3923D5A819C3
nextToken	string	The NextToken value used to retrieve more results.	AAAAAZjtYxxxxxxxx
maxResults	integer	The maximum number of entries per page for a paged query. Maximum value: 100. Default value: 20.	20
totalCount	integer	The total number of records.	22
data	array	The list of skills returned.
	Skill	The details of the skill returned.

Examples

Success response

JSON format

{
  "requestId": "53EAEBC0-4DEC-5AF4-AA21-3923D5A819C3",
  "nextToken": "AAAAAZjtYxxxxxxxx",
  "maxResults": 20,
  "totalCount": 22,
  "data": [
    {
      "skillName": "deploy-to-vercel",
      "displayName": "ECS 实例管理",
      "description": "ECS 实例管理",
      "categoryCode": "compute",
      "categoryName": "计算",
      "subCategoryCode": "ecs",
      "subCategoryName": "弹性计算",
      "likeCount": 128,
      "installCount": 1024,
      "createdAt": "2026-01-01T00:00:00Z",
      "updatedAt": "2026-03-17T00:00:00Z",
      "descriptionEn": "",
      "nameEn": "",
      "categoryNameEn": "",
      "subCategoryNameEn": "",
      "githubPath": ""
    }
  ]
}

Error codes

HTTP status code	Error code	Error message	Description
400	InvalidParam.NextToken	The specified NextToken is not valid.
400	NextTokenParameterMismatch	The request uses the same nextToken as the previous request, but with different parameters. NextTokens should not be reused across non-identical requests. Each unique request must have a distinct nextToken.
500	InternalServerError	The request has failed due to a temporary failure of the server.	The request failed due to a temporary server failure.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.