# Lemon8 Profile Scraper: Posts, Engagement, Comments & Media (`abotapi/lemon8-profile-scraper`) Actor

Scrape Lemon8 user profiles with automated multi-profile discovery. Extract profile data, detailed posts, engagement metrics, comments, and high-quality images and videos with download support. Built for influencer research, content analysis, and media archiving.

- **URL**: https://apify.com/abotapi/lemon8-profile-scraper.md
- **Developed by:** [Abot API](https://apify.com/abotapi) (community)
- **Categories:** Social media, Automation, Developer tools
- **Stats:** 49 total users, 7 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 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?

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

## Lemon8 Profile Scraper

![Lemon8 Scraper Banner](https://i.postimg.cc/CLMPG9ZY/banner.png)

Scrape Lemon8 user profiles with support for automated multi-profile discovery. Extract detailed posts, engagement stats, comments, and download high-quality images and videos. Ideal for data analysis, media archiving, and influencer research.

### Features

- **Profile Scraping** - Extract user info, bio, stats, social links
- **Post Extraction** - Scrape posts with infinite scroll support
- **Full Post Data** - Titles, content, statistics, hashtags
- **Comment Extraction** - All comments including replies (with "See more" expansion)
- **Video Detection** - Identify and extract video post data
- **Media Downloads** - Save images and videos to Key-Value Store
- **Following Profiles** - Extract list of followed users
- **10+ Regions** - Support for US, Australia, Japan, and more
- **Reliable Access** - Smart proxy rotation with automatic fallback
- **Apify Compatible** - Stable, well-defined input/output schema
- **Resume & Incremental Updates** - Continue an interrupted pull with `resumeFromRunId`, or schedule recurring runs with `incrementalMode` to get only NEW/UPDATED/REAPPEARED/EXPIRED posts instead of a full re-scrape every time

### Input Configuration

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `username` | string | required | Lemon8 username (without @) |
| `profileUrl` | string | - | Full profile URL (alternative to username) |
| `region` | string | "us" | Region code |
| `limit` | int | 100 | Max posts to extract |
| `getDetails` | bool | true | Extract full post details |
| `detailsLimit` | int | 10 | Max posts for detail extraction |
| `saveImages` | bool | false | Download images to KVS |
| `saveVideos` | bool | false | Download videos to KVS |
| `getFollowing` | bool | false | Extract following profiles |
| `followingLimit` | int | 20 | Max following profiles to extract |
| `proxy` | object | null | Proxy configuration |
| `resumeFromRunId` | string | - | Previous run/dataset ID to continue an interrupted pull without re-returning (or re-charging for) posts already collected there |
| `incrementalMode` | bool | false | Recurring monitoring: remembers the previous run's posts itself and returns only NEW/UPDATED/REAPPEARED posts (plus UNCHANGED/EXPIRED if enabled below) |
| `stateKey` | string | - | Incremental mode only: name the monitoring campaign explicitly; otherwise derived from username/Profile URL/Start URLs + region + `getDetails` |
| `emitUnchanged` | bool | false | Incremental mode only: also return (and bill) posts unchanged since the last run, marked `UNCHANGED` |
| `emitExpired` | bool | false | Incremental mode only: also return (and bill) posts no longer found, marked `EXPIRED` — only once a run fully scans every tracked profile |

#### Resume & recurring updates

Two distinct features, both off by default:

- **Resume** (`resumeFromRunId`) continues ONE specific interrupted run — paste the previous run ID or dataset ID and this run skips posts already collected there.
- **Incremental mode** (`incrementalMode`) is for scheduling this actor on the same profile(s) again and again (e.g. daily). It keeps its own state (keyed by username/Profile URL/Start URLs, region, and `getDetails`) and classifies every post as `NEW`, `UPDATED`, `UNCHANGED`, `REAPPEARED`, or `EXPIRED` against the previous run. Each dataset row gains `changeType`, `changedFields`, `firstSeenAt`, and `lastSeenAt` fields. `UNCHANGED` posts are suppressed (not returned or billed) unless `emitUnchanged` is on; `EXPIRED` posts are only ever produced when `emitExpired` is on **and** the run fully scanned every tracked profile (not capped by Post Limit, not a resumed run).

Both fields live in the **Resume & recurring updates** input section — normal (non-incremental) runs are completely unaffected and never see these extra fields.

#### Example Input

```json
{
  "username": "sydneydelreyy",
  "region": "us",
  "limit": 50,
  "getDetails": true,
  "detailsLimit": 10,
  "saveImages": false,
  "saveVideos": false,
  "getFollowing": false,
  "followingLimit": 20
}
```

### Regions

`us`, `au`, `nz`, `jp`, `th`, `id`, `vn`, `my`, `sg`, `ca`

### Send results into your apps (MCP connectors)

Optionally pipe the scraped results into the apps you already use, via Model Context Protocol (MCP) connectors. This is an extra delivery step **after** the scrape — the Apify dataset is never changed.

**What gets written to the connector:** a condensed, human-readable **summary** of each record — not the full JSON. Each item becomes one entry with a **title** and its key fields flattened to plain text. The **complete record always stays in the Apify dataset**.

1. Authorize a connector once under **Apify → Settings → Integrations** (Notion, Linear, Airtable, or Apify).
2. Select it in the **"Pipe results into your apps"** input field. (If the picker is empty, you haven't authorized a connector yet.)
3. For **Notion**, also set `notionParentPageUrl` to the page where items should be created.

The connection is mediated by Apify's MCP proxy, so this actor never sees your third-party credentials. Leave the field empty to skip.

### Output Format

Each dataset row is a post (shape below). In **incremental mode** only, every row also carries `changeType` (`NEW`/`UPDATED`/`UNCHANGED`/`REAPPEARED`/`EXPIRED`), `changedFields`, `firstSeenAt`, and `lastSeenAt` — see [Resume & recurring updates](#resume--recurring-updates) above. These fields never appear on a normal (non-incremental) run.

```json
{
  "userInfo": {
    "name": "sydney del rey",
    "bio": "amazon storefront...",
    "followers": "28.4K",
    "following": "34",
    "likesAndSaves": "152.8K",
    "profileImageUrl": "https://.../",
    "profileUrl": "/@sydneydelreyy",
    "socialLinks": ["sydneydelrey"]
  },
  "posts": [
    {
      "id": "7518008729997099534",
      "author": {
        "name": "sydney del rey",
        "profileUrl": "/@sydneydelreyy",
        "profileImageUrl": "https://.../"
      },
      "title": "Built in pad tank!",
      "content": "In my basics amazon list...",
      "postUrl": "https://.../",
      "statistics": {
        "savedCount": "1382",
        "likesCount": "5619",
        "commentsCount": "67"
      },
      "images": [...],
      "isVideo": false,
      "details": {
        "fullContent": "...",
        "hashtags": ["#amazonfashion", ...],
        "videoData": {...}
      },
      "allComments": [...],
      "commentStats": {
        "totalComments": 39,
        "totalReplies": 15
      }
    }
  ],
  "following": [...],
  "metadata": {
    "profileUrl": "https://.../",
    "username": "sydneydelreyy",
    "region": "us",
    "totalScraped": 50,
    "scrollsPerformed": 15,
    "videoPostsFound": 5,
    "detailedPostsScraped": 10,
    "followingProfilesScraped": 0
  }
}
```

# Actor input Schema

## `username` (type: `string`):

Lemon8 username to scrape, without the '@'. Ignored if a Profile URL is provided below.

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

Lemon8 profile URLs to scrape, e.g. https://www.lemon8-app.com/@username?region=us . When provided, these take precedence over Username and Profile URL: each URL is scraped (up to Post Limit posts per profile). Leave empty to scrape a single profile via Username or Profile URL.

## `profileUrl` (type: `string`):

Full profile URL for a SINGLE profile, e.g. https://www.lemon8-app.com/@username?region=us. Takes precedence over Username. Ignored if Start URLs is provided.

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

Target region for Lemon8 content

## `limit` (type: `integer`):

Maximum number of posts to extract per profile (max 500)

## `getDetails` (type: `boolean`):

Navigate to individual post pages to extract full content and all comments

## `detailsLimit` (type: `integer`):

Maximum number of posts to get detailed data for

## `commentExpansionTimeout` (type: `integer`):

Maximum time in seconds to spend expanding comments on each post. Posts with many comments may timeout.

## `resumeFromRunId` (type: `string`):

Paste a previous run ID or dataset ID to continue a large pull of posts without returning or charging for posts already collected there. Use this after an interrupted run, or when continuing a pull for the same profile(s) in another run. For recurring daily monitoring of the same profile(s), use Incremental mode below instead.

## `incrementalMode` (type: `boolean`):

Turn this on for daily or recurring monitoring. The first run returns all matching posts as NEW. Later runs normally return only NEW, UPDATED, and REAPPEARED posts. Turn on "Emit unchanged" or "Emit expired" only when you also want those posts returned (and billed). State is kept separately for each username/Profile URL/Start URLs set, region, and Get Detailed Post Data setting; use State key when you want to name or deliberately share a monitoring campaign. To continue one specific interrupted run instead, use Resume from a previous run above.

## `stateKey` (type: `string`):

Optional. Name this monitoring campaign to keep its state stable, or to deliberately share state across differently-configured runs. Leave empty to let the actor derive a key automatically from the username/Profile URL/Start URLs, region, and Get Detailed Post Data setting — different profile setups then never mix state with each other.

## `emitUnchanged` (type: `boolean`):

Off by default. Turn on to also return posts that have not changed since the last run, marked UNCHANGED. This returns — and bills — extra rows you already have, so leave it off unless you specifically want the full snapshot every run.

## `emitExpired` (type: `boolean`):

Off by default. Turn on to also return posts that were present in a previous run but are no longer found, marked EXPIRED. Only produced once a run has fully scanned every tracked profile — not when Post Limit capped it, or when Resume was used. This returns — and bills — extra synthetic rows, so leave it off unless you need expiry tracking.

## `getFollowing` (type: `boolean`):

Automatically scrape profiles that the main user is following

## `followingLimit` (type: `integer`):

Maximum number of following profiles to scrape

## `saveImages` (type: `boolean`):

Download post images locally

## `saveVideos` (type: `boolean`):

Download videos from video posts

## `proxy` (type: `object`):

Proxy for requests. Defaults to Apify datacenter (US); if the datacenter tunnel is unavailable or gets blocked, the actor automatically falls back to a backup proxy pool.

## `dev_transform_fields` (type: `array`):

Transform the resulting output. Select only needed fields. For nested object use DOT (e.g., 'statistics.rating'). For nested array use NUMBER as array index (e.g., 'comments.0.text').

## `dev_dataset_name` (type: `string`):

Save results into custom named Dataset. Use masks to customize: {ACTOR} = actor name, {DATE} = date (YYYYMMDD), {TIME} = time (HHMMSS). Example: 'lemon8-{DATE}' will create 'lemon8-20250519'.

## `dev_dataset_clear` (type: `boolean`):

Clear Dataset before inserting new data

## Actor input object example

```json
{
  "username": "sydneydelreyy",
  "startUrls": [],
  "region": "us",
  "limit": 5,
  "getDetails": true,
  "detailsLimit": 5,
  "commentExpansionTimeout": 30,
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "getFollowing": false,
  "followingLimit": 2,
  "saveImages": false,
  "saveVideos": false,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyCountry": "US"
  },
  "dev_transform_fields": [],
  "dev_dataset_name": "default",
  "dev_dataset_clear": false
}
```

# Actor output Schema

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

Main post records with author, URL, content preview, and engagement counts.

## `images` (type: `string`):

Image-focused view for scraped Lemon8 posts.

## `videos` (type: `string`):

Video post records and video metadata where available.

## `authors` (type: `string`):

Author profile fields collected from post records.

## `comments` (type: `string`):

Comments and expanded comment data when detail scraping is enabled.

## `detailedContent` (type: `string`):

Full post content, hashtags, related topics, and detail fields.

## `engagement` (type: `string`):

Saved, likes, comments, and detailed engagement fields.

## `followingProfiles` (type: `string`):

Profiles followed by the scraped account when following-profile scraping is enabled.

## `completeOutput` (type: `string`):

Profile-level output stored in the default key-value store.

## `metadata` (type: `string`):

Run metadata with profile count, post count, and scraping summary fields.

# 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 = {
    "username": "sydneydelreyy",
    "incrementalMode": false,
    "emitUnchanged": false,
    "emitExpired": false,
    "proxy": {
        "useApifyProxy": true,
        "apifyProxyCountry": "US"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("abotapi/lemon8-profile-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 = {
    "username": "sydneydelreyy",
    "incrementalMode": False,
    "emitUnchanged": False,
    "emitExpired": False,
    "proxy": {
        "useApifyProxy": True,
        "apifyProxyCountry": "US",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("abotapi/lemon8-profile-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 '{
  "username": "sydneydelreyy",
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "proxy": {
    "useApifyProxy": true,
    "apifyProxyCountry": "US"
  }
}' |
apify call abotapi/lemon8-profile-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,abotapi/lemon8-profile-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/G7J1sfnPZrlfchGa9/builds/H4ZZTafCXnmGVE1it/openapi.json