This document describes the enum values, distribution, and usage of tags in search results.
Tag overview
This feature provides tags for sites and URL paths. Tags are applied to URLs using regular expression (regex) patterns to help users understand and filter search results.
Because some search results may lack tags, or a query might return no tagged results, follow these filtering principles:
Prioritize exclusion logic. Use a
blocklistto filter results. This approach minimizes the risk of unintentionally excluding results that lack tags.Configure a fallback strategy. If you use an inclusion-based filter, implement a
fallback solution.Define fallback triggers. When the number of filtered results is zero or falls below a predefined threshold, the system automatically reverts to
full recallmode, which disables all tag-based filtering.
Tag list
Tag | Parameter | Type | Description |
genre | content type | Enum | Identifies the webpage's content type, such as News Portal, Blog, Social Media, or Video Site. |
isUgc | is UGC | Bool | Indicates whether the content is user-generated content (UGC). |
ugcType | UGC type | Enum | When |
industry | industry classification | Enum | Identifies the content's industry, such as Automotive, Finance, Medical, Government, or Travel. |
isListPage | is list page | Bool | Indicates whether the page is a list page. |
Enum values and examples
The coverage of various tags changes continuously as indexed sites and paths are updated. Tag coverage for links is currently about 89%.
genre (content type)
Value | Description | Url example |
| News Portal | |
| Blog | |
| Forum UGC | |
| Commerce | |
| Encyclopedia | |
| Social Media | |
| Video Site |
isUgc (is UGC)
Value | Description | Url example |
| User-generated content | |
| Not user-generated content |
ugcType (UGC type)
The ugcType tag is only meaningful when isUgc is true.
Value | Description | Url example |
| Media Article | |
| Blog Post | |
| Structured Q&A | |
| Note Share | |
| Resource Aggregation | |
| Tech Tutorial | |
| Short Feed | |
| Forum Post | |
| Review and Evaluation |
industry (industry classification)
Value | Description | Url example |
| General/Other | |
| General News | |
| Finance | |
| Education & Training | |
| Entertainment & Leisure | |
| Technology | |
| Travel | |
| Automotive | |
| Government | |
| Medical & Health | |
| Recruitment |
isListPage (is list page)
Value | Description | Url example |
| Detail page | https://tianqi.moji.com/forecast10/china/zhejiang/hangzhou |
| List page |
Usage and recommendations
The UnifiedSearch API returns tags within the tags object for each pageItem in the response. The API does not support filtering by tags in the request, so you must filter the results you receive.
Sample request
curl -X POST https://cloud-iqs.aliyuncs.com/search/unified \
--header "Authorization: Bearer $API_KEY" \
--header "Content-Type: application/json" \
--data '{
"query": "Hangzhou weather",
"engineType": "LiteAdvanced",
"contents": {
"mainText": true,
"markdownText":false,
"summary": false,
"rerankScore": true
}
}'
Response
{
"requestId": "c7ca543a-6fc3-4563-a39a-720ffb134978",
"pageItems": [
{
"title": "Weather forecast for Hangzhou, Zhejiang on March 15, 2026",
"link": "https://tianqi.moji.com/forecast10/china/zhejiang/hangzhou",
......
"tags": {
"genre": "Official",
"isUgc": "false",
"industry": "General",
"isListPage": "false",
}
},
....
]
}Recommendations
Use tag exclusion whenever possible. This helps prevent empty result sets that can occur when filtering for a small number of included tags.
Combine multiple tags for exclusion to achieve more precise filtering.
Identify tag combinations that consistently produce undesirable results for your use case, and add them to your blocklist.
Use cases
1. Automotive: Exclude low-authority and UGC sites
Query:
Difference between the three Li Auto L7 modelsNumber of results: 20
Filter code:
def should_exclude(tags: dict) -> bool: """ Determines whether to exclude a result. A result is excluded if any of the following conditions are met: 1. tags.ugcType is one of ("StructuredQA", "NoteShare", "ForumPost") 2. tags.isUgc is "true" and tags.genre is "ForumUgc" """ exclude_ugc_types = ("StructuredQA", "NoteShare", "ForumPost") ugc_type = tags.get("ugcType", "") genre = tags.get("genre", "") is_ugc = tags.get("isUgc", "") # Condition 1: ugcType is in the exclusion list if ugc_type in exclude_ugc_types: return True # Condition 2: Content is UGC and the genre is ForumUgc if is_ugc == "true" and genre == "ForumUgc": return True return FalseExcluded URLs:
ugcTypein ("StructuredQA", "NoteShare")genreis "ForumUgc" andisUgcis "true"
2. Exclude list pages
Query:
Latest updates and product information for Huawei vehiclesNumber of results: 20
Filter condition:
isListPageis "true"Excluded URLs: