# Muscat Where To Scraper (`aboo.script/muscatwhereto-scraper`) Actor

⚡ Fast Muscat Where To scraper. No login, no API key. Get events and offers in Muscat, Oman: brunches, happy hours, staycations, pool passes and more by keyword or URL, with dates, weekly days, OMR prices, venue GPS, booking links and contacts.

- **URL**: https://apify.com/aboo.script/muscatwhereto-scraper.md
- **Developed by:** [Aboo Script](https://apify.com/aboo.script) (community)
- **Security:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.80 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Muscat Where To Scraper

![Muscat Where To Scraper](https://i.ibb.co/9kSsgGSf/muscatwhereto-banner.png)

**Muscat Where To Scraper** extracts events and offers in Muscat and across Oman from [Muscat Where To](https://muscatwhereto.com/) into clean, structured data you can download as JSON, CSV, Excel, or HTML. Paste a Muscat Where To page URL or type a few keywords, and get the title, dates, weekly schedule, venue, prices in OMR, categories, booking link, and contact details for every listing. No account or login required.

### Introduction

[Muscat Where To](https://muscatwhereto.com/) is a popular city guide for Muscat, Oman. It lists what's on in the city: concerts, parties and festivals, plus hotel and restaurant offers such as brunches, happy hours, pool day passes, staycations, spa deals, and kids' activities.

This actor collects the same public information you see in your browser and turns it into a ready-to-use dataset. You can run it once, schedule it to run daily, or connect it to your own tools.

### What data can you extract from Muscat Where To?

- 🏷️ Title, listing type (event or offer), short and full description
- 📅 Start and end dates, weekly recurring days, opening times, and the schedule text shown on the page
- 💲 Prices in OMR: every price line from the listing, plus lowest and highest price
- 🗂️ Categories and features (for example Brunch, Pool, Kids Friendly, Live Entertainment)
- 📍 Venue name and description, city, country, latitude, longitude, and Google Maps link
- 🎟️ Booking link, booking button text and booking type (website or WhatsApp)
- 📞 Phone, WhatsApp, email, website, Facebook and Instagram of the venue
- 🖼️ Main image, featured image and extra photos
- 🔗 Direct URL to each listing, trending flag, and created/updated dates

### Use Cases

- 📈 **Market research**: follow brunch, happy hour and staycation prices across Muscat hotels and restaurants.
- 🕵️ **Competitor monitoring**: see which offers other venues publish, on which days, and at what price.
- 🤝 **Lead generation**: build a list of venues with phone, email, WhatsApp and social links.
- 🗂️ **Database building**: create your own calendar of events and deals in Oman.
- 🤖 **AI and automation**: feed clean, structured data into spreadsheets, dashboards, or AI workflows.

### How to scrape Muscat Where To step by step

1. Paste one or more Muscat Where To URLs into **Start URLs**, or type keywords into **Search queries**.
2. Set **Maximum number of results** to how many results you want per URL or per query.
3. Click **Start** and wait for the run to finish.
4. Download your data in JSON, CSV, Excel, or HTML from the **Output** tab.

### Input

- **Start URLs**: Muscat Where To URLs to scrape. Supported pages: upcoming events, what's on, offers, category pages (such as Eat & Drink, Staycation or Pool & Beach), search result pages, and single event or offer pages. Filters you apply on the website (search keyword, day of the week, date, subcategory) are kept in the results.
- **Search queries**: keywords to search events and offers, one per line. Each query is scraped separately.
- **Maximum number of results**: how many results to collect for each start URL or search query. Use 0 for no limit.
- **Category**: search only inside one category. Applies to search queries only.
- **Day of the week**: only listings available on that day. Applies to search queries only.
- **Date**: only listings running on that date. Applies to search queries only.

You can use start URLs, search queries, or both in the same run.

### Input Examples

Scrape all current offers:

```json
{
  "startUrls": [{ "url": "https://muscatwhereto.com/offers" }],
  "maxResults": 5
}
```

Search by keywords:

```json
{
  "searchQueries": ["pool"],
  "maxResults": 5
}
```

### Output

Each result is saved as one item in the dataset. Here is an example of a single item:

```json
{
  "url": "https://muscatwhereto.com/events/oktoberfest-bubbly-brunch-at-butter-buns",
  "id": "67615c7512fa7b39304c72c4",
  "type": "event",
  "title": "Oktoberfest Bubbly Brunch at Butter Buns",
  "shortDescription": "German theme buffet",
  "description": "Celebrate Oktoberfest with an exciting bubbly brunch at Butter Buns, featuring a curated spread of signature dishes and soft drinks, complete with kids' activit...",
  "schedule": "Friday, October 30\n13:00 - 17:00",
  "dateType": "dateRange",
  "startDate": "2026-10-30T09:00:00.000Z",
  "endDate": "2026-10-30T13:42:00.000Z",
  "recurringDays": [],
  "startTime": null,
  "endTime": null,
  "categories": ["Brunch", "Oktoberfest"],
  "features": ["Brunch", "Buffet", "International Cuisine", "Kids Friendly", "Oktoberfest"],
  "priceText": "OMR 23 net per person\nOMR 15 net per person | for special beverages\nLive DJ Entertainment\nKids Activities at Family by JW\nInclusive of Pool Access from 12 PM",
  "prices": [
    { "label": "OMR 23 net per person", "price": 23, "currency": "OMR" },
    { "label": "OMR 15 net per person | for special beverages", "price": 15, "currency": "OMR" }
  ],
  "priceMin": 15,
  "priceMax": 23,
  "currency": "OMR",
  "venueName": "JW Marriott Hotel Muscat",
  "venueDescription": "A new 5-star hotel in Muscat, Oman, JW Marriott Muscat welcomes you to a luxury destination in the city. Overlooking ins...",
  "city": "Muscat",
  "country": "Oman",
  "latitude": 23.569336826121784,
  "longitude": 58.32821846008301,
  "googleMapsUrl": "https://www.google.com/maps/search/?api=1&query=23.569336826121784,58.32821846008301",
  "bookingUrl": "https://wa.me/96899412703",
  "bookingText": "BOOK NOW",
  "bookingType": "whatsapp",
  "phone": "96899412703",
  "whatsapp": "96899412703",
  "email": "jwmuscat.fnb@marriott.com",
  "website": "https://www.marriott.com/en-us/dining/restaurant-bar/mctmj-jw-marriott-hotel-muscat/6608519-butter-buns.mi",
  "facebook": "https://www.facebook.com/JWMarriottMuscat/",
  "instagram": "https://www.instagram.com/butterbunsmct",
  "image": "https://muscat-media.nyc3.cdn.digitaloceanspaces.com/mwt/media2/events/display-photos/event_display_67615c7512fa7b39304c72c4_1792579403762.jpg",
  "featuredImage": "https://muscat-media.nyc3.cdn.digitaloceanspaces.com/mwt/media2/events/featured-photos/event_featured_67615c7512fa7b39304c72c4_1792579403762.jpg",
  "images": [],
  "trending": true,
  "createdAt": "2024-12-17T11:11:49.397Z",
  "updatedAt": "2026-10-21T10:50:07.485Z"
}
```

You can download the dataset in JSON, CSV, Excel, XML, or HTML, or access it through the Apify API.

### Notes

- Business directory pages (Dining, Wellness & Beauty, Shopping & Fashion, Culture & Entertainment, Experiences, Discover) are not events or offers and are skipped.
- Prices are read from the price lines written in each listing, so `prices` holds every amount mentioned (for example adult, kids and beverage packages). Listings without a written price return empty prices.
- Offers that repeat every week have `dateType` set to `recurring` and list their days in `recurringDays`; one-off events have a start and end date.
- Dates and times are returned in UTC. Oman time is UTC+4.
- Each listing appears only once per start URL or search query, even when the website shows it on many days.
- Some venues do not publish an email, website or social link, so those fields are returned as `null`.

### Why use the Muscat Where To Scraper?

- ✅ **No login needed**: works with public data only, so there is no account to manage.
- 🎯 **Keeps your filters**: paste any category or search URL from your browser and get exactly what you see there.
- 🧹 **Clean data**: prices are real numbers, dates use one standard format, and text is free of HTML.
- 💸 **Pay for what you need**: set a result limit per URL or query and keep every run small and cheap.
- 🔄 **Ready for automation**: schedule runs, export to Google Sheets, or connect to Make, Zapier, and n8n.

### FAQ

#### How many results can I scrape?

You can set any number in **Maximum number of results**, or 0 for no limit. The actor keeps going until it reaches your limit or runs out of listings.

#### Do I need a Muscat Where To account?

No. The actor only collects publicly available data. You do not need to log in or provide any account details.

#### Can I scrape data on a schedule?

Yes. Use Apify Schedules to run the actor every hour, day, or week, and get fresh events and offers automatically.

#### Why are some fields empty?

Some listings simply do not show every piece of information. When a field is not available on the website, it is returned as `null`.

#### Can I request a new feature or filter?

Yes. Right now the actor supports start URLs, search queries, and category, day and date filters. If you need other filters, such as features like "Pool" or "Kids Friendly", get in touch and they can be added.

#### Can I get a custom or private version?

Yes. The actor can be customized for your workflow, delivered as a private version, or a new scraper can be built for a different website. Use the contact details below.

### Need to scrape other events platforms?

- [The Agenda Scraper - Dubai Concerts & Shows](https://apify.com/aboo.script/theagenda-scraper): Dubai concerts and live shows with dates and venues.
- [Webook Scraper - Events & Experiences](https://apify.com/aboo.script/webook-scraper): events, concerts, matches and experiences across the Gulf.
- [Etihad Arena Scraper](https://apify.com/aboo.script/etihadarena-ae-scraper): events at Etihad Arena in Abu Dhabi.
- [Virgin Megastore Tickets Scraper](https://apify.com/aboo.script/tickets-virginmegastore-me-scraper): concerts, shows and sports tickets in the Middle East.
- [Fever Scraper - Events & Experiences](https://apify.com/aboo.script/feverup-scraper): events and experiences by city, category or keyword.

***

**Need help or want a custom solution?**

- 📧 Email: aboo.script@gmail.com
- 🧩 More scrapers: [Apify profile](https://apify.com/aboo.script)

### Image Credit

Image credit: [Muscat Where To](https://muscatwhereto.com/)

# Actor input Schema

## `startUrls` (type: `array`):

Muscat Where To URLs: upcoming events, what's on, offers, category pages (filters in the URL such as search, day, date and subcategory are kept), and event or offer detail pages.

## `searchQueries` (type: `array`):

Keywords to search events and offers on Muscat Where To, e.g. "brunch" or "pool". Each query is scraped separately.

## `maxResults` (type: `integer`):

Maximum number of events and offers to scrape per start URL or search query. Use 0 for no limit.

## `category` (type: `string`):

Search only inside this category. Applies to search queries only; start URLs keep their own filters.

## `day` (type: `string`):

Only listings available on this day of the week. Applies to search queries only; start URLs keep their own filters.

## `date` (type: `string`):

Only listings running on this date (YYYY-MM-DD). Applies to search queries only; start URLs keep their own filters.

## Actor input object example

```json
{
  "startUrls": [
    {
      "url": "https://muscatwhereto.com/offers"
    }
  ],
  "searchQueries": [
    "pool"
  ],
  "maxResults": 5
}
```

# Actor output Schema

## `overview` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "startUrls": [
        {
            "url": "https://muscatwhereto.com/offers"
        }
    ],
    "searchQueries": [
        "pool"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("aboo.script/muscatwhereto-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "startUrls": [{ "url": "https://muscatwhereto.com/offers" }],
    "searchQueries": ["pool"],
}

# Run the Actor and wait for it to finish
run = client.actor("aboo.script/muscatwhereto-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "startUrls": [
    {
      "url": "https://muscatwhereto.com/offers"
    }
  ],
  "searchQueries": [
    "pool"
  ]
}' |
apify call aboo.script/muscatwhereto-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,aboo.script/muscatwhereto-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/Wvcj6k5P6DEos66Us/builds/CZUfpeCMYvyXo4Nh9/openapi.json
