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.

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

Main fields the Traveloka indonesia lodging skill returns
FieldWhat it is
nameName
locationLocation
starRatingStar Rating
userRatingUser Rating
numReviewsNum Reviews
imageUrlImage 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.

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.

Skill updated 2026-11-16