Chinese Wikivoyage Destination Search
Search Chinese Wikivoyage for destinations and travel guides. Use the returned page key to retrieve a guide. Credit Wikivoyage contributors and link to the source when reusing excerpts.
- Selected price
- $0 / callPublished pricing
- Providers / implementations
- 1 / 1
- Requests · 30d
- —Loading...
- Success rate · 30d
- —Loading...
| Provider | Price / call | Requests · 30d | Performance | Access |
|---|---|---|---|---|
wikivoyageCurrent Chinese Wikivoyage Destination Search · GET | $0 / call | — | —successP50— |
Statistics use persisted gateway logs from the last 30 days up to now, including today.
Success rate = successful requests / all requests;
P50 = median latency of successful requests.
Prices reflect the published API contract. Contract revision: 2. Price update time: not supplied.
Playground
Run sends a real API request. Charges follow the published API contract.
curl \
'https://api.openany.si/v1/agent-apis/wikivoyage/zh/search?limit=3&q=%E4%BA%AC%E9%83%BD' \
-X GET \
-H "Authorization: Bearer $OPENANY_API_KEY" \
-H 'Content-Type: application/json'- Method
- GET
- Endpoint
https://api.openany.si/v1/agent-apis/wikivoyage/zh/search- Content type
- application/json
- Authentication
Authorization: Bearer $OPENANY_API_KEY
curl \
'https://api.openany.si/v1/agent-apis/wikivoyage/zh/search?limit=3&q=%E4%BA%AC%E9%83%BD' \
-X GET \
-H "Authorization: Bearer $OPENANY_API_KEY" \
-H 'Content-Type: application/json'Input parameters
Fields in this listing; additional options and input encoding can vary by provider.
| Parameter | Location | Type | Required | Description |
|---|---|---|---|---|
q | URL query parametersquery | string | Yes | Destination or travel topic keywords. minLength: 1 · maxLength: 256 |
limit | URL query parametersquery | integer | No | Maximum number of results to return. OpenAny accepts 1 to 20. Omit this parameter to use the upstream default. minimum: 1 · maximum: 20 |
Required markers inside a nested object or variant apply when that object or variant is used.
Sample response
Published response example · Documented HTTP 200; not a live result. Published documentation example. Verify the actual response after an approved call.
{
"pages": [
{
"anchor": null,
"description": "位於日本西部近畿地方京都府南部的城市",
"excerpt": "<span class=\"searchmatch\">京都</span>是一个拥有多个區的特大城市,您可以将景点、餐馆、住宿和夜生活的資訊一并打印。 <span class=\"searchmatch\">京都</span>(Kyotō,きょうと)是日本的千年古都,享有最美丽城市的声誉。不过,游客或许会惊异于当地人为了展现<span class=\"searchmatch\">京都</span>美丽一面所付出的努力。大多数人对城市的第一印象<span class=\"searchmatch\">京都</span>市中心的城市扩张,其周围的超现代玻璃钢铁火车站成为城市悠久传",
"id": 10126,
"key": "京都",
"matched_title": null,
"thumbnail": {
"duration": null,
"height": 49,
"mimetype": "image/png",
"url": "//thumb.wikimedia.org/wikipedia/commons/thumb/9/92/%E4%BA%AC%E9%83%BD%E5%88%86%E5%8C%BA%E5%9B%BE.png/60px-%E4%BA%AC%E9%83%BD%E5%88%86%E5%8C%BA%E5%9B%BE.png?utm_source=zh.wikivoyage.org&utm_campaign=rest&utm_content=thumbnail",
"width": 60
},
"title": "京都"
},
{
"anchor": null,
"description": "日本本州中西部地理區域,又稱關西地方",
"excerpt": "其他同名地点的条目,请见關西 (消歧义)。 关西 (関西,かんさい) 是日本本州岛西侧的一个地区,是日本仅次于关东人口第二多的地区。因为靠近古都奈良和<span class=\"searchmatch\">京都</span>,这里也被称为近畿地方,这里的三大城市大阪、<span class=\"searchmatch\">京都</span>和神户组成了京板神都会区。 关西和关东(以东京为主的东部区域)直接的差异不大但是众多。关西人说着独特的日语方言,烹饪时使用浅",
"id": 3327,
"key": "關西地方",
"matched_title": null,
"thumbnail": {
"duration": null,
"height": 45,
"mimetype": "image/jpeg",
"url": "//thumb.wikimedia.org/wikipedia/commons/thumb/d/db/Todaiji_Daibutsuden.JPG/60px-Todaiji_Daibutsuden.JPG?utm_source=zh.wikivoyage.org&utm_campaign=rest&utm_content=thumbnail",
"width": 60
},
"title": "關西地方"
},
{
"anchor": null,
"description": "日本第一級行政區劃",
"excerpt": "<span class=\"searchmatch\">京都</span>府(日語:<span class=\"searchmatch\">京都</span>府, きょうとふ, Kyōto-hu)是位于日本本州岛中西部的一个府,距大阪40多公里。它位于<span class=\"searchmatch\">京都</span>盆地北端,东、北、西三面环山,林木苍郁,层峦叠嶂,南面则是渠道纵横,沃土成片。 <span class=\"searchmatch\">京都</span>市 - 府廳所在地 綾部市 城陽市 福知山市 亀岡市 木津川市 京丹後市 京田邊市 舞鶴市 宮津市 向日市",
"id": 1377,
"key": "京都府",
"matched_title": null,
"thumbnail": {
"duration": null,
"height": 77,
"mimetype": "image/png",
"url": "//thumb.wikimedia.org/wikipedia/commons/thumb/6/67/Japan_kyoto_map_small.png/60px-Japan_kyoto_map_small.png?utm_source=zh.wikivoyage.org&utm_campaign=rest&utm_content=thumbnail",
"width": 60
},
"title": "京都府"
}
]
}Agent integration
Copy the resource contract without sharing an API key.
View API Markdown
# Chinese Wikivoyage Destination Search
Search Chinese Wikivoyage for destinations and travel guides. Use the returned page key to retrieve a guide. Credit Wikivoyage contributors and link to the source when reusing excerpts.
Documentation: https://openany.si/apis/14fd3a7f-3756-420b-891e-7436a66df3c2
Method: GET
Endpoint: https://api.openany.si/v1/agent-apis/wikivoyage/zh/search
Price: $0 / call
Provider: wikivoyage
Contract revision: 2
Price source: selected implementation in the OpenAny public API catalog. Price update time: not supplied.
Use OPENANY_API_KEY from the environment. API Key calls use your shared balance.
## Prepared request
```bash
curl \
'https://api.openany.si/v1/agent-apis/wikivoyage/zh/search?limit=3&q=%E4%BA%AC%E9%83%BD' \
-X GET \
-H "Authorization: Bearer $OPENANY_API_KEY" \
-H 'Content-Type: application/json'
```
## API contract
```json
{
"resource_type": "api",
"name": "Chinese Wikivoyage Destination Search",
"endpoint": "https://api.openany.si/v1/agent-apis/wikivoyage/zh/search",
"method": "GET",
"content_type": "none",
"execution_mode": "sync",
"authentication": {
"type": "bearer",
"environment_variable": "OPENANY_API_KEY"
},
"inputs": [
{
"description": "Destination or travel topic keywords.",
"location": "query",
"max_length": 256,
"min_length": 1,
"name": "q",
"nullable": false,
"required": true,
"type": "string"
},
{
"description": "Maximum number of results to return. OpenAny accepts 1 to 20. Omit this parameter to use the upstream default.",
"location": "query",
"maximum": "20",
"minimum": "1",
"name": "limit",
"nullable": false,
"required": false,
"type": "integer"
}
],
"billing": {
"currency": "USD",
"mode": "fixed",
"priceMicroUsd": "0",
"rounding": null,
"unit": "call",
"unitQuantity": null
},
"examples": [
{
"http_status": 200,
"name": "Documentation example",
"request": {
"body": null,
"headers": {},
"path": {},
"query": {
"limit": 3,
"q": "京都"
}
},
"response_body": {
"pages": [
{
"anchor": null,
"description": "位於日本西部近畿地方京都府南部的城市",
"excerpt": "<span class=\"searchmatch\">京都</span>是一个拥有多个區的特大城市,您可以将景点、餐馆、住宿和夜生活的資訊一并打印。 <span class=\"searchmatch\">京都</span>(Kyotō,きょうと)是日本的千年古都,享有最美丽城市的声誉。不过,游客或许会惊异于当地人为了展现<span class=\"searchmatch\">京都</span>美丽一面所付出的努力。大多数人对城市的第一印象<span class=\"searchmatch\">京都</span>市中心的城市扩张,其周围的超现代玻璃钢铁火车站成为城市悠久传",
"id": 10126,
"key": "京都",
"matched_title": null,
"thumbnail": {
"duration": null,
"height": 49,
"mimetype": "image/png",
"url": "//thumb.wikimedia.org/wikipedia/commons/thumb/9/92/%E4%BA%AC%E9%83%BD%E5%88%86%E5%8C%BA%E5%9B%BE.png/60px-%E4%BA%AC%E9%83%BD%E5%88%86%E5%8C%BA%E5%9B%BE.png?utm_source=zh.wikivoyage.org&utm_campaign=rest&utm_content=thumbnail",
"width": 60
},
"title": "京都"
},
{
"anchor": null,
"description": "日本本州中西部地理區域,又稱關西地方",
"excerpt": "其他同名地点的条目,请见關西 (消歧义)。 关西 (関西,かんさい) 是日本本州岛西侧的一个地区,是日本仅次于关东人口第二多的地区。因为靠近古都奈良和<span class=\"searchmatch\">京都</span>,这里也被称为近畿地方,这里的三大城市大阪、<span class=\"searchmatch\">京都</span>和神户组成了京板神都会区。 关西和关东(以东京为主的东部区域)直接的差异不大但是众多。关西人说着独特的日语方言,烹饪时使用浅",
"id": 3327,
"key": "關西地方",
"matched_title": null,
"thumbnail": {
"duration": null,
"height": 45,
"mimetype": "image/jpeg",
"url": "//thumb.wikimedia.org/wikipedia/commons/thumb/d/db/Todaiji_Daibutsuden.JPG/60px-Todaiji_Daibutsuden.JPG?utm_source=zh.wikivoyage.org&utm_campaign=rest&utm_content=thumbnail",
"width": 60
},
"title": "關西地方"
},
{
"anchor": null,
"description": "日本第一級行政區劃",
"excerpt": "<span class=\"searchmatch\">京都</span>府(日語:<span class=\"searchmatch\">京都</span>府, きょうとふ, Kyōto-hu)是位于日本本州岛中西部的一个府,距大阪40多公里。它位于<span class=\"searchmatch\">京都</span>盆地北端,东、北、西三面环山,林木苍郁,层峦叠嶂,南面则是渠道纵横,沃土成片。 <span class=\"searchmatch\">京都</span>市 - 府廳所在地 綾部市 城陽市 福知山市 亀岡市 木津川市 京丹後市 京田邊市 舞鶴市 宮津市 向日市",
"id": 1377,
"key": "京都府",
"matched_title": null,
"thumbnail": {
"duration": null,
"height": 77,
"mimetype": "image/png",
"url": "//thumb.wikimedia.org/wikipedia/commons/thumb/6/67/Japan_kyoto_map_small.png/60px-Japan_kyoto_map_small.png?utm_source=zh.wikivoyage.org&utm_campaign=rest&utm_content=thumbnail",
"width": 60
},
"title": "京都府"
}
]
}
}
]
}
```Error handling
| Status | Next step |
|---|---|
400 | Check the offering and request fields. |
401 / 403 | Verify your credentials and access permissions. |
402 | Inspect the selected access mode and returned payment requirements. |
429 | Respect the returned rate limit and retry guidance. |
5xx | Inspect the error and usage record before retrying a paid operation. |
Documentation example
Published documentation example. Verify the actual response after an approved call.
Prepare your environment
Use a terminal with cURL installed.
Use an OpenAny API key with shared-balance access. Confirm availability and price before running; a call may charge your balance.
Set the key in your terminal using the hidden prompt below. Keep its value out of source files and logs.
Terminal · macOS / Linuxprintf 'OpenAny API key: ' read -r -s OPENANY_API_KEY export OPENANY_API_KEY printf '\n'Run the request
Paste the complete command below into your terminal.
Values to replace before running 2
Review these request fields before running. Keep the published provider and request method unchanged.
q- Destination or travel topic keywords.
limit- Maximum number of results to return. OpenAny accepts 1 to 20. Omit this parameter to use the upstream default.
Terminal · cURLcurl \ 'https://api.openany.si/v1/agent-apis/wikivoyage/zh/search?limit=3&q=%E4%BA%AC%E9%83%BD' \ -X GET \ -H "Authorization: Bearer $OPENANY_API_KEY" \ -H 'Content-Type: application/json'Check the response
Published response example · Documented HTTP 200; not a live result.
Sample response · not a live result{ "pages": [ { "anchor": null, "description": "位於日本西部近畿地方京都府南部的城市", "excerpt": "<span class=\"searchmatch\">京都</span>是一个拥有多个區的特大城市,您可以将景点、餐馆、住宿和夜生活的資訊一并打印。 <span class=\"searchmatch\">京都</span>(Kyotō,きょうと)是日本的千年古都,享有最美丽城市的声誉。不过,游客或许会惊异于当地人为了展现<span class=\"searchmatch\">京都</span>美丽一面所付出的努力。大多数人对城市的第一印象<span class=\"searchmatch\">京都</span>市中心的城市扩张,其周围的超现代玻璃钢铁火车站成为城市悠久传", "id": 10126, "key": "京都", "matched_title": null, "thumbnail": { "duration": null, "height": 49, "mimetype": "image/png", "url": "//thumb.wikimedia.org/wikipedia/commons/thumb/9/92/%E4%BA%AC%E9%83%BD%E5%88%86%E5%8C%BA%E5%9B%BE.png/60px-%E4%BA%AC%E9%83%BD%E5%88%86%E5%8C%BA%E5%9B%BE.png?utm_source=zh.wikivoyage.org&utm_campaign=rest&utm_content=thumbnail", "width": 60 }, "title": "京都" }, { "anchor": null, "description": "日本本州中西部地理區域,又稱關西地方", "excerpt": "其他同名地点的条目,请见關西 (消歧义)。 关西 (関西,かんさい) 是日本本州岛西侧的一个地区,是日本仅次于关东人口第二多的地区。因为靠近古都奈良和<span class=\"searchmatch\">京都</span>,这里也被称为近畿地方,这里的三大城市大阪、<span class=\"searchmatch\">京都</span>和神户组成了京板神都会区。 关西和关东(以东京为主的东部区域)直接的差异不大但是众多。关西人说着独特的日语方言,烹饪时使用浅", "id": 3327, "key": "關西地方", "matched_title": null, "thumbnail": { "duration": null, "height": 45, "mimetype": "image/jpeg", "url": "//thumb.wikimedia.org/wikipedia/commons/thumb/d/db/Todaiji_Daibutsuden.JPG/60px-Todaiji_Daibutsuden.JPG?utm_source=zh.wikivoyage.org&utm_campaign=rest&utm_content=thumbnail", "width": 60 }, "title": "關西地方" }, { "anchor": null, "description": "日本第一級行政區劃", "excerpt": "<span class=\"searchmatch\">京都</span>府(日語:<span class=\"searchmatch\">京都</span>府, きょうとふ, Kyōto-hu)是位于日本本州岛中西部的一个府,距大阪40多公里。它位于<span class=\"searchmatch\">京都</span>盆地北端,东、北、西三面环山,林木苍郁,层峦叠嶂,南面则是渠道纵横,沃土成片。 <span class=\"searchmatch\">京都</span>市 - 府廳所在地 綾部市 城陽市 福知山市 亀岡市 木津川市 京丹後市 京田邊市 舞鶴市 宮津市 向日市", "id": 1377, "key": "京都府", "matched_title": null, "thumbnail": { "duration": null, "height": 77, "mimetype": "image/png", "url": "//thumb.wikimedia.org/wikipedia/commons/thumb/6/67/Japan_kyoto_map_small.png/60px-Japan_kyoto_map_small.png?utm_source=zh.wikivoyage.org&utm_campaign=rest&utm_content=thumbnail", "width": 60 }, "title": "京都府" } ] }
Loading related APIs…
Common questions
Do I need a separate key for every provider?
Use your OpenAny API key for standard API access. Read it from OPENANY_API_KEY in your environment and keep it out of prompts, source code and logs.
Are these providers interchangeable?
No. Each offering has its own inputs, pricing and response contract. Selecting a catalog offering does not establish automatic routing or fallback. Confirm the service contract before calling.
How is this API billed?
API-key calls use your shared balance at the selected implementation's published rate. Check the billing unit and request-specific pricing rules before making a paid call. Recorded usage determines the final charge under that contract.
Where do the price and contract come from?
The selected implementation publishes its provider, request contract, revision and billing rules through OpenAny's public API catalog. A revision number identifies a contract version, not a price update date. A price update timestamp is not supplied; do not treat a page date as one.
How do OpenAny Balance and x402 differ?
OpenAny Balance uses an API key and one shared balance. Card, USDC and x402 top-ups, card auto top-up and USDC subscriptions fund that balance; available routes appear on the Credits page. Direct x402 is a separate pay-per-request flow, available only on listings that show it and requiring an authorized payment client.
Does Playground send a paid request?
Yes. After you sign in, Run sends a real API request using an active OpenAny API key. Charges follow the published API contract and use your shared balance. Selecting an implementation, editing inputs and viewing sample responses do not send requests.