| Search any keyword in the US, Canada, Australia, New Zealand, Japan, Thailand, Indonesia, Vietnam, Malaysia or Singapore, go past the first page of results through Lemon8's related posts (up to 5,000 per keyword), and monitor a search over time with incremental mode that returns only new and changed posts. |
skincare, matcha latte or gym outfit. Used only when Start URLs is empty.
## `startUrls` (type: `array`):
Paste Lemon8 discover links instead of a Search Term, e.g. https://www.lemon8-app.com/discover/coffee?region=jp. The keyword and region are read from each link. Takes precedence over Search Term when set.
## `region` (type: `string`):
Pick the Lemon8 region to search. Links in Start URLs use the region in the link and fall back to this one.
## `limit` (type: `integer`):
Maximum number of posts to extract for each Search Term or link (1 to 5,000). Search results come first, then posts Lemon8 lists as related to them.
## `getDetails` (type: `boolean`):
Open each post for its full text, hashtags, related topics, location, all images, the video file link and the comment thread with replies. Turn off for a faster pass over the listings only. The price per post is the same.
## `detailsLimit` (type: `integer`):
Fetch detailed data for only the first N posts of each Search Term or link. Leave empty to get details for every post.
## `commentExpansionTimeout` (type: `integer`):
Seconds to spend loading one post's comments and replies before moving on (10 to 300). commentStats.complete shows whether the whole thread was loaded.
## `incrementalMode` (type: `boolean`):
Turn on for recurring runs: each post is marked NEW, UPDATED, UNCHANGED, REAPPEARED or EXPIRED compared with earlier runs of the same search. Only NEW, UPDATED and REAPPEARED posts are returned by default.
## `stateKey` (type: `string`):
Name for this monitoring campaign, e.g. streetwear-sg-daily. Runs with the same key share history. Leave empty to derive one from the search terms and regions.
## `emitUnchanged` (type: `boolean`):
Also return (and pay for) UNCHANGED posts on every run.
## `emitExpired` (type: `boolean`):
Also return (and pay for) tracked posts that no longer appear in a search's results. Only checked when the search finishes without being stopped by the spending limit.
## `resumeFromRunId` (type: `string`):
Enter the ID of an interrupted run (or its dataset) of this Actor. Posts already saved there are skipped and not charged again; they still count toward Post Limit.
## `proxy` (type: `object`):
Lemon8 limits how many post pages one IP can open, so Apify Proxy is recommended. Left completely empty (for example in a bare API call), the Actor connects directly and moves to Apify Proxy if Lemon8 starts refusing requests.
## `dev_transform_fields` (type: `array`):
Return only the listed fields per post, e.g. id, author.name, statistics.likesCount, images.0.src. Use a dot path for nested objects and a number for array items. Each path becomes a column named after it.
## `dev_dataset_name` (type: `string`):
Save results into a named dataset in your account instead of the run's default dataset. Supports {ACTOR}, {DATE} and {TIME} placeholders, e.g. lemon8-{DATE}. Leave empty or default for the default dataset.
## `dev_dataset_clear` (type: `boolean`):
Delete everything in the named dataset before this run adds new posts.
## Actor input object example
```json
{
"searchTerm": "skincare",
"region": "us",
"limit": 10,
"getDetails": true,
"commentExpansionTimeout": 30,
"incrementalMode": false,
"emitUnchanged": false,
"emitExpired": false,
"proxy": {
"useApifyProxy": true
},
"dev_dataset_clear": false
}
```
# Actor output Schema
## `dataset` (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 '