# Carousell Scraper - Listings, Prices & Seller Leads (`scrapesage/carousell-scraper`) Actor

Scrape Carousell listings, prices, conditions, photos, meet-up locations and seller leads across Singapore, Malaysia, the Philippines and Hong Kong. Pure HTTP, no browser, so runs are fast and never time out. Includes GPS coordinates, seller verification and a 0-100 lead score.

- **URL**: https://apify.com/scrapesage/carousell-scraper.md
- **Developed by:** [Scrape Sage](https://apify.com/scrapesage) (community)
- **Categories:** E-commerce, Lead generation, Agents
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.09 / 1,000 listing scrapeds

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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Carousell Scraper - Listings, Prices & Seller Leads

> **Disclaimer:** This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Carousell or any of its subsidiaries. All trademarks mentioned are the property of their respective owners. "Carousell" is referenced only to describe the publicly available website this Actor collects data from.

Scrape **Carousell** listings, prices, conditions, photos, meet-up locations and seller leads across **Singapore, Malaysia, the Philippines and Hong Kong** - fast, over plain HTTP, with no browser and no login.

Carousell is Southeast Asia's largest consumer marketplace. This actor turns any category, listing or seller profile into a clean, richly-populated dataset.

***

### Why this scraper

Most Carousell scrapers drive a headless browser per page. That is why they time out - measurably: across the public Carousell actors on the Store, one leader logs **308 FAILED + 780 ABORTED runs out of 4,306**. This actor takes a different route.

Carousell server-renders its **entire application state** into the page. We parse that state directly, so:

- **No browser.** ~1-2 s per page instead of 15-30 s. No Chromium, no memory spikes.
- **No timeouts by construction.** The run reads its own `ACTOR_TIMEOUT_AT` deadline, stops starting work ~60 s before the platform would kill it, pushes what it has and exits **Succeeded** with a status message. A run can never end TIMED-OUT.
- **Never throws.** A transient rate-limit ends the run Succeeded with 0 items and an explanatory message - it does not fail, and pay-per-event means you are not charged for it.
- **Richer records.** The state blob carries fields the rendered page never shows: exact meet-up **GPS coordinates**, postal codes, seller verification flags, follower counts and the positive/neutral/negative review split.

We parse JSON, not CSS classes. Carousell's class names are obfuscated build hashes that rotate on every deploy - class-based scrapers rot within weeks.

***

### What you get

**Listing records** - title, numeric + formatted price, condition, full description, likes, buyer-protection badge, images, category, seller handle, and an always-present `listedAt` timestamp.

**Enriched listing details** (`fetchDetails`) - 50+ fields including brand, availability, offers/comments counts, full category path, **meet-up address with postal code**, **latitude/longitude**, deal methods, and the complete seller profile.

**Seller leads** (`includeSellerLeads`) - one de-duplicated record per seller: verification flags (email / mobile / ID / Facebook), followers, feedback score, positive-rate, tenure in years, response rate, and a **0-100 `leadScore`** ranking commercial reachability.

#### Deep pagination, solved

Carousell returns only **48 results per URL** - there is no `?page=` parameter and no infinite-scroll endpoint (verified: 12 scrolls, 0 requests fired). This actor partitions the inventory by **price band and sort order**, subdividing any saturated band recursively, then de-duplicates by listing ID.

> Measured: **481 unique listings from a single starting point in 12 requests.**

#### Category browsing (and why not keyword search)

Carousell's `robots.txt` disallows `/search/`, and the site enforces it - the search route returns an unresolved shell with no results to non-approved clients. Category pages are SEO-critical, explicitly crawlable, and always resolve. So this actor **browses categories** - the lane Carousell sanctions - and applies your keyword filter itself, *while crawling*, so filtering never starves your item limit.

If you point it at a category that is only a navigation hub (or a slug that does not exist in that region), it automatically falls back to that region's working subcategories rather than returning an empty run.

***

### Input

| Field | Description |
|---|---|
| `region` | `sg`, `my`, `ph`, `hk`. The proxy is auto-pinned to the matching country. |
| `categoryUrls` | Category pages to scrape - full URL or bare slug. **Slugs are region-specific** (see below). |
| `keywords` | Optional. Keep only listings whose title/description matches. Filtering happens during the crawl. |
| `startUrls` | Any Carousell URL - category, listing (`/p/...`) or seller profile (`/u/...`). |
| `sellerUsernames` | Pull public listings from specific sellers. |
| `maxItems` | Record cap. `0` = no limit (still exits safely before timeout). |
| `fetchDetails` | Open each listing for the full 50+ field record. |
| `includeSellerLeads` | Emit de-duplicated seller lead records. |
| `deepPagination` | Price-band + sort partitioning. On by default. |
| `sortBy`, `minPrice`, `maxPrice` | Standard filters. |

**Verified category slugs** (ids differ per region - a Singapore slug will not work on Philippines):

| Region | Working slugs |
|---|---|
| Singapore | `computers-tech-213`, `womens-fashion-4`, `men-s-fashion-3`, `luxury-20`, `video-gaming-264`, `furniture-home-living-13`, `toys-collectibles-12` |
| Malaysia | `women-s-fashion-4`, `hobbies-toys-6245`, `cars-32`, `property-102` |
| Philippines | `luxury-20`, `womens-fashion-4`, `toys-board-games-12` |
| Hong Kong | `luxury-20`, `womens-fashion-4`, `furniture-home-living-13`, `toys-collectibles-12` |

Run it with **no input at all** and it browses a sample category so you always see real data.

```json
{
  "region": "sg",
  "categoryUrls": ["luxury-20"],
  "maxItems": 100,
  "fetchDetails": true,
  "includeSellerLeads": true
}
```

### Output (abridged)

```json
{
  "type": "listingDetail",
  "listingId": "1451172552",
  "title": "HP Pavilion x360 Convertible Laptop",
  "price": 340,
  "priceFormatted": "S$340",
  "currency": "SGD",
  "condition": "Lightly used",
  "brand": "HP",
  "categoryPath": ["Computers Tech", "Laptops Notebooks"],
  "locationAddress": "439B Bukit Batok West Avenue 8, 652439",
  "latitude": 1.357249,
  "longitude": 103.739253,
  "dealMethods": ["meetup"],
  "sellerUsername": "collectors88",
  "sellerFeedbackScore": 5,
  "sellerFollowers": 14,
  "sellerIsVerified": true
}
```

### Use cases

- **Price intelligence** - track second-hand pricing for any category across four markets.
- **Resale arbitrage** - spot underpriced listings the moment they appear, filtered by condition and price band.
- **Seller lead generation** - build a ranked list of high-volume, verified Carousell sellers with `leadScore`.
- **Market research** - measure supply, condition mix and price distribution by category.
- **Geographic analysis** - map listing density using real meet-up coordinates.

### Use with AI assistants (MCP)

This actor works as a tool for AI assistants through the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp). Point your assistant at it and ask for Carousell data in natural language.

### Agent-ready: autonomous payments (x402 & Skyfire)

This actor is **agent-ready** - AI agents can discover it, run it, and **pay for it autonomously**, with no Apify account and no human in the loop. It uses [pay-per-event](https://docs.apify.com/platform/actors/publishing/monetize/pay-per-event) pricing and [limited permissions](https://docs.apify.com/platform/actors/development/permissions), so it qualifies for Apify's agentic-payment standards:

- **[x402](https://docs.apify.com/platform/integrations/x402)** - an open, HTTP-native payment protocol. Agents pay per run in USDC on the Base network directly through the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp) - no account, no API key.
- **[Skyfire](https://docs.apify.com/platform/integrations/skyfire)** - agent-to-service payments for fully autonomous AI-agent workflows.

Building an AI agent, MCP tool, or autonomous data pipeline? This scraper is ready to plug in and pay as it goes.

### Pricing

Pay-per-event - you pay only for records you receive:

| Event | Price |
|---|---|
| Listing scraped | $0.003 |
| Listing detail enriched | $0.006 |
| Seller lead | $0.008 |

### Notes

Only **public** Carousell data is collected - the same information any visitor sees without logging in. No accounts, no private messages, no personal data behind authentication. Taiwan (`carousell.tw`) is not supported: that site server-renders no listings, so it is deliberately excluded rather than shipped as a region that returns nothing. Please use the output in line with Carousell's terms and applicable law.

### Automate & schedule

Run this Actor on autopilot and pull results into your own stack:

- **[Apify API](https://docs.apify.com/api/v2)** - start runs, fetch datasets and manage schedules over REST.
- **[apify-client for JavaScript](https://docs.apify.com/api/client/js/)** and **[apify-client for Python](https://docs.apify.com/api/client/python/)** - official SDKs.
- **[Schedules](https://docs.apify.com/platform/schedules)** - run it hourly, daily or weekly and keep your dataset current.
- **[Webhooks](https://docs.apify.com/platform/integrations/webhooks)** - trigger downstream actions (CRM import, Slack alert, email sequence) the moment a run finishes.

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

const client = new ApifyClient({ token: 'MY_APIFY_TOKEN' });

const run = await client.actor('scrapesage/carousell-scraper').call({
    "region": "sg",
    "categoryUrls": [
        "womens-fashion-4"
    ],
    "maxItems": 100,
    "fetchDetails": false,
    "deepPagination": true
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(`Got ${items.length} records`);
```

### Integrate with any app

Connect the dataset to thousands of apps - no code required:

- **[Make](https://docs.apify.com/platform/integrations/make)** - multi-step automation scenarios.
- **[Zapier](https://docs.apify.com/platform/integrations/zapier)** - push new records straight into your CRM or spreadsheet.
- **[Slack](https://docs.apify.com/platform/integrations/slack)** - get notified when a scheduled run finds something new.
- **[Google Drive / Sheets](https://docs.apify.com/platform/integrations/drive)** - auto-export every run to a spreadsheet.
- **[Airbyte](https://docs.apify.com/platform/integrations/airbyte)** - pipe results into your data warehouse.
- **[GitHub](https://docs.apify.com/platform/integrations/github)** - trigger runs from commits or releases.

### More scrapers from scrapesage

Related Actors in the same category:

- **[Taobao & Tmall Scraper](https://apify.com/scrapesage/taobao-scraper)** - Products, Prices, Sellers & Reviews
- **[Kompass Scraper](https://apify.com/scrapesage/kompass-scraper)** - Global B2B Company & Supplier Leads
- **[Faire Scraper](https://apify.com/scrapesage/faire-scraper)** - Wholesale Brands, Supplier Leads & Products
- **[AliExpress Scraper](https://apify.com/scrapesage/aliexpress-scraper)** - Products, Prices, Orders & Supplier Leads
- **[GetYourGuide Scraper](https://apify.com/scrapesage/getyourguide-scraper)** - Tours, Activities, Prices & Reviews

### FAQ

**How is this Actor billed?** Pay-per-event: you pay only for the results it delivers, with no monthly rental and no start fee. The per-event price is shown on the Pricing tab.

**Can I schedule it and get results automatically?** Yes - create a [Schedule](https://docs.apify.com/platform/schedules) and add a [webhook](https://docs.apify.com/platform/integrations/webhooks) or an integration (Google Sheets, Slack, Make, Zapier) to push each run's dataset wherever you need it.

**Which export formats are available?** Every run's dataset can be downloaded as JSON, CSV, Excel (XLSX), XML, HTML or RSS from the Apify Console or the API.

**Can I run it from code or an AI agent?** Yes - through the [Apify API](https://docs.apify.com/api/v2) and client libraries, or from Claude, ChatGPT and other assistants via the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp).

**Is it legal to scrape Carousell?** This Actor collects publicly available data only. You are responsible for using the output in compliance with applicable laws (including data-protection law where personal data is involved) and the source's terms. See **Data & lawful use** and the **Disclaimer** below.

**Is this an official Carousell tool?** No. It is an independent, third-party Actor with no affiliation to, endorsement by or sponsorship from Carousell. See the **Disclaimer** below.

### Data & lawful use

This Actor reads public listings and the seller information shown on them. Sellers on Carousell include private individuals, so seller names, usernames and any contact details are personal data. If you are in the EU or UK you are the data controller for what you do with them: have a lawful basis, use the data for market research, price monitoring or lawful sourcing, honour deletion requests, and do not send private sellers unsolicited marketing.

Under [Apify's Standard Actor Contract](https://docs.apify.com/legal/standard-actor-contract), which governs your use of this Actor, you are the controller of any personal data in your input and output and scrapesage acts only as your processor: that data is processed solely to run your job, written only to your own Apify storage, never used for any other purpose and never shared onward. If you need help with a data-subject request that involves this Actor's output, open an issue on the Issues tab.

### Disclaimer

**This Actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Carousell or any of its subsidiaries. All trademarks mentioned are the property of their respective owners.**

"Carousell" and any related marks are the property of their respective owners and are used here only in a descriptive, nominative sense - to identify the publicly accessible website from which this Actor collects data. This Actor is not an official Carousell product, is not authorised or certified by Carousell, and does not distribute Carousell software. It collects only publicly available information; you are responsible for ensuring your use of that data complies with applicable laws, regulations and the terms of the source website.

### Need help?

Open an issue on the Actor's **Issues** tab, or visit the [Apify help center](https://help.apify.com/). Feature requests are welcome - this Actor is actively maintained.

# Actor input Schema

## `region` (type: `string`):

Which Carousell marketplace to scrape. The proxy is automatically pinned to the matching country.

## `categoryUrls` (type: `array`):

Category pages to scrape. Paste a full URL (https://www.carousell.sg/categories/computers-tech-213/) or just the slug (computers-tech-213). NOTE: slugs are region-specific. Verified working - Singapore: computers-tech-213, womens-fashion-4, luxury-20, video-gaming-264, furniture-home-living-13, men-s-fashion-3, toys-collectibles-12. Malaysia: women-s-fashion-4, hobbies-toys-6245, cars-32, property-102. Philippines: luxury-20, womens-fashion-4, toys-board-games-12. Hong Kong: luxury-20, womens-fashion-4, furniture-home-living-13, toys-collectibles-12. If a slug returns nothing, the scraper automatically falls back to that region's verified categories. Each category is deep-paginated by price band and sort order.

## `keywords` (type: `array`):

Keep only listings whose title or description contains one of these words, e.g. "iphone 15". Filtering runs while crawling, so the scraper keeps paginating until your item limit is met. Leave empty to keep every listing. If you give keywords but no category, five popular categories are scanned.

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

Any Carousell URL - a category page, a single listing (/p/...), or a seller profile (/u/...). Categories are deep-paginated; listings are scraped in full detail.

## `sellerUsernames` (type: `array`):

Carousell usernames (without @) to pull public listings from, e.g. "collectors88".

## `maxItems` (type: `integer`):

Maximum records to return. Set 0 for no limit (the run still stops safely before its timeout).

## `fetchDetails` (type: `boolean`):

Open each listing to add the full description, brand, exact meet-up address + GPS coordinates, deal methods, offer/comment counts, category path and full seller profile. Slower, and billed per enriched listing.

## `includeSellerLeads` (type: `boolean`):

Emit one de-duplicated seller record per seller found, with verification flags, followers, positive/negative review split, tenure, response rate and a 0-100 leadScore. Requires "Fetch full listing details".

## `deepPagination` (type: `boolean`):

Carousell returns only 48 results per URL. When enabled, the scraper partitions the inventory by price band and sort order to reach far more unique listings (measured: 481 from one starting point). Disable for a single fast page.

## `sortBy` (type: `string`):

Result ordering. Leave empty for Carousell's default.

## `minPrice` (type: `integer`):

Minimum price in the region's local currency. Leave empty for no minimum.

## `maxPrice` (type: `integer`):

Maximum price in the region's local currency. Leave empty for no maximum.

## `requestDelayMs` (type: `integer`):

Politeness delay between requests. Raise it for very large runs.

## `proxyConfiguration` (type: `object`):

Defaults to Apify residential proxies pinned to the selected region's country, which is what Carousell requires - datacenter IPs are refused. You may supply your own proxy URLs instead. Any Apify-proxy selection you make here is honored exactly as chosen - a non-residential choice usually returns 0 results.

## `urlsFromFile` (type: `string`):

Paste a list of URLs (one per line), OR one link to a .txt/.csv file, Google Sheet or Google Drive file containing them. Lets you import many Start URLs at once instead of typing each. Google Sheet/Drive share links are handled automatically.

## Actor input object example

```json
{
  "region": "sg",
  "categoryUrls": [
    "computers-tech-213"
  ],
  "maxItems": 100,
  "fetchDetails": false,
  "includeSellerLeads": false,
  "deepPagination": true,
  "requestDelayMs": 700,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `listings` (type: `string`):

All scraped records: listings, enriched listing details and seller leads.

## `sellerLeads` (type: `string`):

De-duplicated sellers with verification, reputation and lead score.

# 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 = {
    "region": "sg",
    "categoryUrls": [
        "computers-tech-213"
    ],
    "maxItems": 100,
    "fetchDetails": false,
    "includeSellerLeads": false,
    "deepPagination": true,
    "requestDelayMs": 700,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    },
    "urlsFromFile": ""
};

// Run the Actor and wait for it to finish
const run = await client.actor("scrapesage/carousell-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 = {
    "region": "sg",
    "categoryUrls": ["computers-tech-213"],
    "maxItems": 100,
    "fetchDetails": False,
    "includeSellerLeads": False,
    "deepPagination": True,
    "requestDelayMs": 700,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
    "urlsFromFile": "",
}

# Run the Actor and wait for it to finish
run = client.actor("scrapesage/carousell-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 '{
  "region": "sg",
  "categoryUrls": [
    "computers-tech-213"
  ],
  "maxItems": 100,
  "fetchDetails": false,
  "includeSellerLeads": false,
  "deepPagination": true,
  "requestDelayMs": 700,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  },
  "urlsFromFile": ""
}' |
apify call scrapesage/carousell-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,scrapesage/carousell-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/5O4RgTEWLHIXIRv3f/builds/euLlOuWeo9dHHag2j/openapi.json