content.search
GET/content/search
Searches every published piece in one locale, ignoring diacritics. One result per piece, best match first, with the matching section. No key needed. Pieces you may read match on titles, summaries, tags, section titles and full text and carry a passage of up to 400 characters; the rest match only on what the catalog already shows (title, summary, tags, section titles and opening), are locked, and the response adds an upgrade hint.
Parameters
| Parameter | In | Description |
|---|---|---|
locale | query | Required. vi or en. |
q | query | Required. Search terms, 1 to 200 characters. |
limit | query | Optional. Number of results, 1 to 20, default 8. |
Request
curl "https://api.modernengineer.dev/content/search?locale=vi&q=fallback"Response
{
"items": [
{
"access": "subscriber",
"kind": "guide",
"locale": "vi",
"locked": true,
"route": "/vi/library/omp-model-routing-guide",
"section": "Vai trò chỉ là bí danh, fallback là một lớp khác",
"slug": "omp-model-routing-guide",
"title": "Định tuyến model trong Oh-my-pi (OMP): vai trò, fallback và cách biết model nào đang chạy"
}
],
"upgrade": {
"message": "Kết quả bị khoá dành cho người đăng ký. Đăng ký để đọc đoạn trích và toàn văn bằng content_get.",
"url": "/vi/pricing"
}
}Errors
| Status | Error | When |
|---|---|---|
| 403 | forbidden | No key, or the key does not belong to a registered account. |
| 400 | invalid_input | A parameter is missing or invalid, for example a locale other than vi or en. |
| 429 | too_many_requests | The results carry passages and the account is over 1,000 reads in 24 hours, shared with content.get. |