Traveloka indonesia lodging skill for AI agents
Get guest house and hostel listings across Indonesia's major cities and resort areas with ratings and reviews, plus Traveloka Xperience travel-guide articles with author, publish date, and full article text.
What the skill does
It tells your agent when a request fits the Traveloka Indonesia Lodging & Xperience Articles Actor, which input to send and which fields come back (name, location, star rating, user rating and 3 more). The agent runs it through the Apify API with your token and gets JSON rows.
Skill files updated 2026-11-16.Install by hand
Save the five files into a folder named traveloka-indonesia-lodging-and-xperience-articles: ~/.claude/skills/traveloka-indonesia-lodging-and-xperience-articles/ for Claude Code, ~/.agents/skills/traveloka-indonesia-lodging-and-xperience-articles/ for Codex and most other agents.
- SKILL.mdWhen to use the skill, the input and the fields it returns, 4.8 KB
- scripts/run.mjsRuns the Actor with your token (Node 18 or later), 1.2 KB
- references/example-input.jsonA starter input that passes the Actor's schema, 81 bytes
- references/input-schema.jsonEvery input setting the Actor accepts, 5.0 KB
- references/output-fields.jsonEvery field the Actor declares, 703 bytes
The same five files as one download: traveloka-indonesia-lodging-and-xperience-articles.zip (4.9 KB).
Run it
Ask your agent in plain words, for example "Traveloka indonesia lodging", and it picks the skill from its description. Or run the script yourself:
export APIFY_TOKEN=your_apify_token
cd traveloka-indonesia-lodging-and-xperience-articles # the skill folder
node scripts/run.mjs # the example input
node scripts/run.mjs my-input.json # your own input Without an argument the script uses references/example-input.json. It waits for the run and prints the rows as JSON; for long runs SKILL.md shows the async API calls.
What it returns
| Field | What it is |
|---|---|
| name | Name |
| location | Location |
| starRating | Star Rating |
| userRating | User Rating |
| numReviews | Num Reviews |
| imageUrl | Image Url |
Read SKILL.md
Show the whole file (4.8 KB)
---
name: traveloka-indonesia-lodging-and-xperience-articles
description: "Get guest house and hostel listings across Indonesia's major cities and resort areas with ratings and reviews, plus Traveloka Xperience travel-guide articles with author, publish date, and full article text. Output fields: name, location, starRating, userRating, numReviews and more, as JSON rows. Use it for requests like \"Traveloka indonesia lodging\", or a CSV/JSON export of public Traveloka data."
---
# Traveloka Indonesia Lodging & Xperience Articles
Get guest house and hostel listings across Indonesia's major cities and resort areas with ratings and reviews, plus Traveloka Xperience travel-guide articles with author, publish date, and full article text.
- Actor: https://apify.com/nimbryxo-studio/traveloka-indonesia-lodging-and-xperience-articles (ID `nimbryxo-studio~traveloka-indonesia-lodging-and-xperience-articles`)
- n8n workflow for the same Actor: https://scraperfinder.com/n8n/traveloka-indonesia-lodging-and-xperience-articles/
- Example input: `references/example-input.json`
- Input schema: `references/input-schema.json`
- Output fields: `references/output-fields.json`
## When to use
Use this skill when the user wants:
- Traveloka indonesia lodging
- a repeatable export of public Traveloka data as CSV or JSON
Do not use it for private, login-protected or paywalled data.
## What it returns
One JSON row per result. Columns from the Actor's dataset schema:
- `name`: Name
- `location`: Location
- `starRating`: Star Rating
- `userRating`: User Rating
- `numReviews`: Num Reviews
- `imageUrl`: Image Url
All 7 declared fields: `references/output-fields.json`.
## Inputs
| Field | Type | Required | Default | Notes |
|---|---|---|---|---|
| `mode` | string | yes | search | What to fetch. |
| `searchQuery` | string | no | yogyakarta | City or travel keyword (mode=search), e.g. `yogyakarta`, `bali`, `bandung`, `travel`. City queries return hotels; other keywords match explore-article titles. |
| `citySlug` | string | no | | Traveloka accommodation page to scrape. |
| `startUrls` | array | no | [] | traveloka.com URLs to scrape (mode=byUrl) — accommodation/find pages, /explore pages, or explore article pages. |
| `minRating` | integer | no | | Only hotels with a user rating of at least this (0-10). |
| `minStarRating` | integer | no | | Only hotels with at least this many stars. |
| `minReviewCount` | integer | no | | Only hotels with at least this many reviews. |
| `containsKeyword` | string | no | | Only emit hotels whose name contains this text (case-insensitive). |
| `sortBy` | string | no | relevance | Applied to the fetched page in the output order. |
| `includeArticles` | boolean | no | false | In search mode, also emit every explore article (not just keyword-matching ones). |
| `maxItems` | integer | no | 50 | Hard cap on emitted records. |
| `proxyConfiguration` | object | no | | Optional Apify proxy. Only used lazily if Traveloka blocks the direct request (403/429). Leave empty for the zero-cost default. |
Example (`references/example-input.json`):
```json
{
"proxyConfiguration": {
"useApifyProxy": false
},
"mode": "search"
}
```
The input passes the Actor's input schema (checked at every publish). First run: `maxItems` = 50, small enough for the 300-second sync wait; raise it once the rows look right.
## Run it
Set `APIFY_TOKEN`, then call the synchronous endpoint for small and medium runs (it waits up to 300 seconds):
```bash
curl -s -X POST "https://api.apify.com/v2/acts/nimbryxo-studio~traveloka-indonesia-lodging-and-xperience-articles/run-sync-get-dataset-items" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d @references/example-input.json > output.json
```
Or with Node 18+: `node scripts/run.mjs [input.json]`.
For large runs, start an async run and read its dataset when it finishes:
```bash
RUN=$(curl -s -X POST "https://api.apify.com/v2/acts/nimbryxo-studio~traveloka-indonesia-lodging-and-xperience-articles/runs" \
-H "Authorization: Bearer $APIFY_TOKEN" -H "Content-Type: application/json" \
-d @references/example-input.json)
RUN_ID=$(echo "$RUN" | jq -r '.data.id'); DATASET=$(echo "$RUN" | jq -r '.data.defaultDatasetId')
curl -s "https://api.apify.com/v2/actor-runs/$RUN_ID?waitForFinish=60" -H "Authorization: Bearer $APIFY_TOKEN" | jq -r '.data.status'
curl -s "https://api.apify.com/v2/datasets/$DATASET/items?format=json" -H "Authorization: Bearer $APIFY_TOKEN" > output.json
```
## Cost and limits
- Apify bills the Actor's usage on your account; the Actor's Pricing tab shows the current price.
- Keep the limit in the input small for a first run.
## Guardrails
- Public data only. Do not pass cookies, sessions or private account data.
- Do not use the output for spam, harassment or unlawful discrimination.
- Check the target site's terms and local law before running at scale.
Same Actor, other ways
- The traveloka indonesia lodging n8n workflow: the same job as a scheduled n8n workflow, imported from a URL.
- Traveloka Indonesia Lodging & Xperience Articles: fields, inputs and price per plan.
- Traveloka Indonesia Lodging & Xperience Articles in the Apify Store.
Questions people ask
Which agents can use this skill?
Any agent that reads Agent Skills folders: Claude Code, Codex, Cursor, Gemini CLI and the other agents the skills CLI installs into. The skill is a SKILL.md file plus a small Node script, so an agent without skill support can still follow the file by hand.
Does the skill cost anything?
The skill is free. Running it starts the Traveloka Indonesia Lodging & Xperience Articles Actor on your own Apify account, which bills the run at the Actor's Store price; the Apify Free plan includes $5 of usage a month.
What does npx skills add install?
The whole folder: SKILL.md, scripts/run.mjs and the three reference files, downloaded from this site and checked against the SHA-256 digest in scraperfinder.com/.well-known/agent-skills/index.json. Add -g to install it for every project.