# LTK Scraper - Creators, Posts, Products & Affiliate Links (`abotapi/shopltk-com-scraper`) Actor

Scrape LTK (shopltk.com) creator shops by handle or URL. Extract creator profiles, posts, linked products, retailer names, rstyle affiliate links and product images. Supports recurring monitoring to track content and product changes.

- **URL**: https://apify.com/abotapi/shopltk-com-scraper.md
- **Developed by:** [Abot API](https://apify.com/abotapi) (community)
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.40 / 1,000 records

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

## LTK Scraper - Creator Shops, Posts & Linked Products

LTK Scraper turns LTK (shopltk.com, formerly rewardStyle/liketoknow.it) into a clean data API. Scope it by creator shops, keyword searches (summer dress) or the site's own categories (sale alerts, finds under $100, finds under $50) and get structured records for creator profiles, curated collections, every matched post with its tags and video, and every linked product with its name, price, brand and images - then export to JSON, CSV or Excel, or pull the results straight into your app through the API.

### Why This Scraper?

- **Three scopes in, records out.** Paste creator handles or links; or run keyword searches and category feeds (salealert, findsunder100, findsunder50) across all creators. Every scope emits the same record kinds.
- **Product details.** Name, price, brand, availability, the retailer and the full image set on every product, straight from the shop catalog. Turn off for lightweight creator-page product cards instead.
- **Retailer mapping.** Every product carries the retailer display name and the affiliate link the creator earns from.
- **Post-to-product graph.** Every post carries its caption hashtags as `tags`, its video (URL, length, size, preview) when it is one, and the full **Shop this post** list - each product with name, price, currency, brand, availability and the affiliate link.
- **Creator profiles.** Display and full names, Instagram handle, blog, bio, avatar, follower count, height and body shapes on every creator record.
- **Change kinds.** Filter the dataset by record kind (creator, collection, post, product) to feed exactly the downstream job you have.
- **Built for schedules.** Incremental mode returns only new and changed records on recurring runs, and a refused run fails loudly instead of returning an empty dataset.

### Use Cases

- **Who:** affiliate-intelligence teams - track which creators link which retailers and how their shop catalogs evolve.
- **Who:** trend researchers - collect creator post captions and product retailers for trend and market studies.
- **Who:** creator-marketing teams - profile a creator's shop size, posting cadence and retailer mix before outreach.

### Data You Get

> Sample shape: one row per record (creator, collection, post or linked product).

| Field | Example |
|---|---|
| `recordId` | shopltk:creator:amberfillerup |
| `kind` | creator / collection / post / product |
| `handle` | amberfillerup |
| `displayName` | amberfillerup |
| `followerCount` | 40710 |
| `heightCm` | 162.56 |
| `bodyShapes` | \["Petite", "Athletic / fit"] |
| `itemCount` | 3 |
| `caption` | post caption text |
| `tags` | \["#LTKOver40", "#LTKHome"] |
| `shopThePost` | \[{name, price, currency, brand, …}] per post |
| `isVideo` | true |
| `videoUrl` | https://stream.mux.com/…/capped-1080p.mp4 |
| `postId` | the post a product appears in |
| `name` | Khaite Jett Leather Miniskirt in Black at Nordstrom, Size 12 |
| `price` | 1680 |
| `brand` | Nordstrom |
| `imageUrls` | \["https://product-images-cdn.liketoknow.it/…", "…"] |
| `retailer` | Revolve Clothing (Global) |
| `link` | https://rstyle.me/+… |
| `postCount` | 54 |
| `productCount` | 181 |
| `collectionCount` | 5 |
| `url` | https://www.shopltk.com/explore/amberfillerup |
| `changeType` | NEW |

### How to Use

1. Pick the mode in **What to scrape**: **Search** (keywords like summer dress across all creators) or **Links** - paste any LTK link, URL path or bare handle (creator pages or just the handle, posts, liketk.it share links, collection pages, category links or paths like /categories/salealert, search links or paths like /search?keyword=summer+dress) and each routes to its own walk. Leave the links empty to walk one example of every type (including the deals feeds).
2. Set **Max items** for the run cap (20 by default; 0 runs until the walk ends naturally). **Product details** is on by default: products carry name, price, brand and every image.
3. Run the actor and export the dataset, or select an MCP connector to send records into your apps.

**Mode: Links - creators, posts, categories, anything:**

```json
{"urls": ["amberfillerup", "https://liketk.it/5XXza", "https://www.shopltk.com/categories/salealert"], "maxItems": 100}
```

**Mode: Search (or Categories):**

```json
{"mode": "search", "searchQueries": ["summer dress"], "maxItems": 100}
```

**Watch a creator on a schedule (Links mode):**

```json
{"urls": ["amberfillerup"], "incrementalMode": true, "stateKey": "ltk-watch", "maxItems": 0}
```

#### Run it from your code

**Run it from Python:**

```python
from apify_client import ApifyClient
client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("abotapi/shopltk-com-scraper").call(run_input={
    "creators": ["amberfillerup"],
    "maxItems": 20,
})
items = client.dataset(run["defaultDatasetId"]).list_items().items
```

**Run it from JavaScript:**

```js
import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });
const run = await client.actor('abotapi/shopltk-com-scraper').call({
  creators: ['amberfillerup'], maxItems: 20,
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
```

#### Tips

- Each creator yields four kinds of rows: one `creator` profile row, one row per curated `collection`, one row per shop `post`, and one row per linked `product`. Filter the dataset by `kind`.
- Creator scopes emit rows per creator in this order: **profile, products (newest first), posts, collections**. A capped run returns the head of that order - so the default 20 yields the profile and the 19 newest products with prices; raise **Max items** (or set 0) to include posts and collections.
- Search and category scopes emit **matched posts first, then their products with prices**, each row carrying `matchedQuery` or `matchedCategory` so you can tell which scope produced it.
- With **Product details** on (default), each product carries its name, price, brand, availability and every image from the shop catalog.
- Video posts carry the video URL (MP4 and HLS), length, size and a preview image; image posts carry the hero image with its pixel dimensions.

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

Optionally send records into the apps you already use through MCP connectors: set **MCP connectors** (for example a Notion database) and cap the export with **Max items to export per connector**. The export is a gated side channel: it never changes the dataset.

| Field | What it does |
|---|---|
| `mcpConnectors` | Connector ids to export to (empty = no export). |
| `notionParentPageUrl` | URL or id of the Notion parent page (required for the Notion connector). |
| `maxNotifyListings` | Cap on records written to each connector per run. |

### Input Parameters

| Parameter | Type | Default | Description |
|---|---|---|---|
| `mode` | select | `urls` | What to scrape: `search` or `urls` (links). |
| `searchQueries` | array | - | Keyword searches across all creator posts (e.g. `summer dress`). |
| `urls` | array | one of each type | Any LTK link, URL path or bare handle, one per entry - creators, posts, liketk.it links, collections, categories, search links. Empty in Links mode = a walk of every type. |
| `maxItems` | integer | `20` | The single cap on the run: stop after this many records. |
| `fetchDetails` | boolean | `true` | Products carry full shop details (name, price, brand, all images). Off = lightweight creator-page product cards. |
| `proxy` | object | shared datacenter | Leave the default for the cheapest run. Use residential if runs fail. |
| `resumeFromRunId` | string | - | Paste a previous run ID or dataset ID to continue a large crawl without returning or charging for records already collected there. |
| `incrementalMode` | boolean | `false` | Track changes across scheduled runs; suppress and never bill unchanged records. |
| `stateKey` | string | - | Optional name for the incremental baseline. |
| `emitUnchanged` | boolean | `false` | Also return unchanged records, marked and billed. |
| `emitExpired` | boolean | `false` | Also return disappeared records, marked and billed. |
| `ignoreFieldsForChanges` | array | - | Extra top-level fields excluded from change detection. |
| `mcpConnectors` | array | - | Connector ids to export to (empty = no export). |
| `notionParentPageUrl` | string | - | URL or id of the Notion parent page (required for the Notion connector). |
| `maxNotifyListings` | integer | `50` | Cap on records written to each connector per run. |

### Output Example

> Sample shape: the creator profile row, from a live record.

**Live record: amberfillerup**

```json
{
  "recordId": "shopltk:creator:amberfillerup",
  "kind": "creator",
  "handle": "amberfillerup",
  "displayName": "amberfillerup",
  "fullName": "Amber Fillerup",
  "blogName": "Barefoot Blonde",
  "followerCount": 40710,
  "postCount": 54,
  "productCount": 181,
  "collectionCount": 5,
  "url": "https://www.shopltk.com/explore/amberfillerup"
}
```

### Plan Requirement

This actor runs on any Apify plan. The default shared connection keeps costs low; if runs fail with connection errors, switch the proxy group to residential and try again.

### FAQ

#### How much does it cost?

The actor is pay per event: a start fee per run, a per-record fee for every creator, collection, post or product returned, and a smaller product-details fee for every product returned with full shop details (turn **Product details** off to skip it). Exact prices are on the actor's Pricing tab. `Max items` is the cost lever: a run's record count is bounded by it.

#### Is it legal to scrape LTK?

The actor reads the public creator-shop pages of the LTK website: the same profile, post and linked-product data any visitor sees without an account. It does not access accounts, orders or checkout. You are responsible for using the data in line with the site's terms of use, privacy law such as GDPR or CCPA, and applicable regulations; personal data of identifiable individuals requires a lawful basis.

#### Can I get only new or changed items on a schedule?

Yes. Turn on **Incremental mode** and schedule the actor. The first run returns everything matching as NEW; later runs return only NEW and UPDATED records. New posts, removed products, collection updates and caption edits all count as changes. Use **State key** to keep a monitoring campaign stable, and **Emit unchanged** or **Emit expired** only if you also want those rows (they return and bill extra rows).

#### Why did a run return fewer results than the site shows?

The run stops at **Max items**, which defaults to 20. Raise it or set it to 0 to walk the full creator shops.

#### Why did my run fail instead of returning an empty dataset?

A run whose creator page requests all failed fails loudly with a connection message instead of reporting an empty catalog. If a creator handle does not exist, the run names it and finishes with whatever matched.

#### Can I use it with AI agents or MCP?

Yes. Every record is plain JSON over the dataset API, and the MCP connector export sends rows straight into tools like Notion. Point an agent at the dataset items endpoint with the input above.

### 🔗 More scrapers you might like

Pair this actor with these related scrapers from the same team:

<table>
<tr><td>📱 <a href="https://apify.com/abotapi/lemon8-profile-scraper"><b>Lemon8 Profile Scraper</b></a><br>Scrape Lemon8 user profiles with automated multi-profile discovery. Extract profile data...</td><td>🧩 <a href="https://apify.com/abotapi/commentsold-com-scraper"><b>CommentSold Scraper</b></a><br>Scrape CommentSold boutique shops by name or URL. Extract product catalogs, descriptions...</td></tr>
<tr><td>📱 <a href="https://apify.com/abotapi/lemon8-media-scraper"><b>Lemon8 Media Scraper</b></a><br>Lightweight Lemon8 scraper for extracting image and video URLs from posts, with optional...</td><td>🤖 <a href="https://apify.com/abotapi/suno-music-scraper"><b>Suno Scraper</b></a><br>Collect public Suno music data: songs with lyrics, style tags, model version, play and...</td></tr>
<tr><td>📱 <a href="https://apify.com/abotapi/lemon8-discover-scraper"><b>Lemon8 Search Scraper</b></a><br>Scrape Lemon8 posts by keyword across multiple regions. Extract posts, images, videos...</td><td>🛒 <a href="https://apify.com/abotapi/depop-scraper"><b>Depop Scraper</b></a><br>From $1/1K. Scrape Depop search results, listings, shops, and reviews to JSON, CSV, or...</td></tr>
</table>

👉 [Browse all abotapi scrapers](https://apify.com/abotapi)

### 💬 Support

- 🐞 **Found a bug or a missing field?** Open a ticket on the [Issues tab](https://apify.com/abotapi/shopltk-com-scraper/issues/open). We usually reply within hours.
- 🛠️ **Need another site, extra fields or a private build?** Email <contact@abotapi.com>.
- ⭐ **Enjoying it?** A quick review on the actor page helps other users find it.

# Actor input Schema

## `mode` (type: `string`):

Search: run the keyword searches below across all creators. Links: walk any LTK links - creator pages, bare creator handles, posts, liketk.it share links, collection pages, category links (salealert, findsunder100, findsunder50) or search links. Defaults to the LTK deals links.

## `urls` (type: `array`):

Any LTK link, URL path or bare handle, one per entry - creator pages (/explore/<handle> or just amberfillerup), posts (/explore/<handle>/posts/<id> or liketk.it share links), collections (/explore/<handle>/collections/<id>), category links or paths (/categories/salealert, #salealert or salealert as a bare fallback), search links or paths (/search?keyword=summer+dress). Leave empty in Links mode to walk one example of every type.

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

Keyword searches across all creator posts (for example summer dress or finds under 50). Each result emits its matched posts with tags and video, plus the linked products with prices.

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

The single cap on the run: stop after collecting this many records. Set 0 for no cap.

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

On by default: products carry the full shop details - name, price, brand, availability and every image. Turn off to return the lightweight creator-page product cards instead.

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

Leave the default for the cheapest run: the catalog serves the ordinary shared connection. If runs fail with connection errors, switch to residential.

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

Paste a previous run ID or dataset ID to continue that interrupted run without returning or charging for records already collected there. For recurring monitoring of the same creators, use Recurring updates below instead.

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

Turn this on for daily or recurring monitoring. The first run returns all matching records as NEW. Later runs return only NEW and UPDATED records.

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

Optional. Name this monitoring campaign to keep its memory stable. Leave empty to key the memory on this run setup automatically.

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

Off by default. Turn on to also return records that have not changed since the last run, marked UNCHANGED. This returns and bills extra rows you already have.

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

Off by default. Turn on to also return records that were present before but are no longer found, marked EXPIRED. Only produced when a run covered its whole creator list.

## `ignoreFieldsForChanges` (type: `array`):

Output field names that should NOT mark a record as UPDATED. scrapedAt is always ignored because it is stamped fresh on every fetch.

## `mcpConnectors` (type: `array`):

Optionally send records into the apps you already use through MCP connectors. Empty means no export.

## `notionParentPageUrl` (type: `string`):

URL or id of the Notion page under which record pages are created. Required to enable the Notion connector.

## `maxNotifyListings` (type: `integer`):

Cap on records written to each connector per run. Does not affect the dataset.

## Actor input object example

```json
{
  "mode": "urls",
  "urls": [
    "https://www.shopltk.com/explore/amberfillerup",
    "https://liketk.it/5XXza",
    "https://www.shopltk.com/explore/chrisellelim/posts/35cf770f-19a8-11f1-b2f3-0242ac11001a",
    "https://www.shopltk.com/explore/chrisellelim/collections/11f0820026ce9c87be560242ac110021",
    "https://www.shopltk.com/categories/salealert",
    "https://www.shopltk.com/categories/findsunder100",
    "https://www.shopltk.com/categories/findsunder50",
    "/search?keyword=summer+dress"
  ],
  "searchQueries": [
    "summer dress"
  ],
  "maxItems": 20,
  "fetchDetails": true,
  "proxy": {
    "useApifyProxy": true
  },
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "maxNotifyListings": 50
}
```

# Actor output Schema

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

No description

## `creators` (type: `string`):

No description

## `posts` (type: `string`):

No description

## `products` (type: `string`):

No description

## `collections` (type: `string`):

No description

## `changes` (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 = {
    "mode": "urls",
    "urls": [
        "https://www.shopltk.com/explore/amberfillerup",
        "https://liketk.it/5XXza",
        "https://www.shopltk.com/explore/chrisellelim/posts/35cf770f-19a8-11f1-b2f3-0242ac11001a",
        "https://www.shopltk.com/explore/chrisellelim/collections/11f0820026ce9c87be560242ac110021",
        "https://www.shopltk.com/categories/salealert",
        "https://www.shopltk.com/categories/findsunder100",
        "https://www.shopltk.com/categories/findsunder50",
        "/search?keyword=summer+dress"
    ],
    "searchQueries": [
        "summer dress"
    ],
    "maxItems": 20,
    "proxy": {
        "useApifyProxy": true
    },
    "incrementalMode": false,
    "emitUnchanged": false,
    "emitExpired": false,
    "maxNotifyListings": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("abotapi/shopltk-com-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 = {
    "mode": "urls",
    "urls": [
        "https://www.shopltk.com/explore/amberfillerup",
        "https://liketk.it/5XXza",
        "https://www.shopltk.com/explore/chrisellelim/posts/35cf770f-19a8-11f1-b2f3-0242ac11001a",
        "https://www.shopltk.com/explore/chrisellelim/collections/11f0820026ce9c87be560242ac110021",
        "https://www.shopltk.com/categories/salealert",
        "https://www.shopltk.com/categories/findsunder100",
        "https://www.shopltk.com/categories/findsunder50",
        "/search?keyword=summer+dress",
    ],
    "searchQueries": ["summer dress"],
    "maxItems": 20,
    "proxy": { "useApifyProxy": True },
    "incrementalMode": False,
    "emitUnchanged": False,
    "emitExpired": False,
    "maxNotifyListings": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("abotapi/shopltk-com-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 '{
  "mode": "urls",
  "urls": [
    "https://www.shopltk.com/explore/amberfillerup",
    "https://liketk.it/5XXza",
    "https://www.shopltk.com/explore/chrisellelim/posts/35cf770f-19a8-11f1-b2f3-0242ac11001a",
    "https://www.shopltk.com/explore/chrisellelim/collections/11f0820026ce9c87be560242ac110021",
    "https://www.shopltk.com/categories/salealert",
    "https://www.shopltk.com/categories/findsunder100",
    "https://www.shopltk.com/categories/findsunder50",
    "/search?keyword=summer+dress"
  ],
  "searchQueries": [
    "summer dress"
  ],
  "maxItems": 20,
  "proxy": {
    "useApifyProxy": true
  },
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false,
  "maxNotifyListings": 50
}' |
apify call abotapi/shopltk-com-scraper --silent --output-dataset

```

## MCP server setup

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