Instagram Highlights Scraper for Openclaw

Extract story items from public Instagram Highlight URLs through Apify, with validated inputs, transparent pricing, and explicit approval before each paid run.

datavoyantlab
v1.0.1
Oct 6, 2026
0
144
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install instagram-highlights-scraper

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install instagram-highlights-scraper using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Instagram Highlights Scraper?

Instagram Highlights Scraper is an Openclaw Skills integration for retrieving story media and available metadata from public Instagram Highlight URLs using DataVoyantLab's Apify Actor. It accepts Highlight URLs—not profile URLs or usernames—and returns the complete dataset items, grouped or counted by submitted URL without stripping raw fields.

The workflow is designed for safe, cost-aware extraction: it validates and normalizes URLs, checks current Actor pricing, calculates a maximum charge, and requires the user to approve that exact cap before any billable run. A paid Apify account or approved DataVoyantLab Free-user entitlement is required.

Instagram Highlights Scraper Use Cases

  • Extract story items from one or more public Instagram Highlights when a user provides instagram.com/stories/highlights/ URLs.
  • Collect available media and metadata from Highlight collections for research or reporting.
  • Process batches of Highlight URLs while reviewing results by submitted URL.
  • Check the current Apify pricing and present a precise spending cap before starting an extraction.
  • Identify successful empty results, which may indicate an unavailable, private, expired, or empty Highlight.
  • Do not use for current 24-hour Stories, profile URLs, usernames, followers, following lists, posts, or comments.

How Instagram Highlights Scraper Works

  1. Require APIFY_TOKEN and keep it secret; use it only with the documented Apify API.
  2. Accept only HTTPS Instagram URLs with a path beginning /stories/highlights/ followed by a numeric Highlight ID. Remove fragments and tracking parameters, normalize trailing slashes, deduplicate links, and reject invalid URLs.
  3. Build the Actor input with the normalized links and skill metadata: skill: true, skillName: instagram-highlights-scraper, and skillVersion: 1.0.1.
  4. Fetch the Actor's active pricing information and read the Actor-start price and per-link link-request event price. Do not proceed if the active pricing or required events are missing.
  5. Calculate the charge cap as Actor-start price plus the number of unique links multiplied by the per-link price, plus $0.01; round up to the next cent.
  6. Before every billable run, tell the user the Actor, unique-link count, current prices, exact maxTotalChargeUsd cap, and that the Apify account linked to the token will be billed. Proceed only after explicit approval of that exact cap; recalculate and request approval again if inputs or pricing change.
  7. For up to 10 links, call the synchronous run-and-fetch endpoint. For larger batches, start an asynchronous run, poll to terminal status, and fetch its default dataset.
  8. Return all dataset items, the maximum authorized charge, and run and dataset identifiers when available. Group or count items by submitted Highlight URL, retain raw fields, and report empty successful results without inventing data.

Instagram Highlights Scraper Setup

  1. Create or access an Apify account with paid access or an approved DataVoyantLab Free-user entitlement.
  2. Configure APIFY_TOKEN in the agent's environment. The skill also requires curl and jq to be available. Never display or persist the token.
  3. Confirm the Actor's active pricing through the documented Apify API before each run; pricing must include both the Actor-start and per-link link-request events.
  4. Obtain the user's explicit approval of the calculated maximum charge before sending a run request. A request to extract Highlights alone is not payment authorization.
# Set the token securely in your environment; do not paste it into logs or output.
export APIFY_TOKEN="<your-apify-token>"

# Confirm required command-line tools are installed.
command -v curl
command -v jq

Actor ID: sUluczVbvIYrxH5n7. Actor store page: https://apify.com/datavoyantlab/instagram-highlights-scraper-api-by-url. If Apify rejects an unapproved Free account, request access by emailing [email protected] with the Apify user ID.

Instagram Highlights Scraper Data Schema & Taxonomy

Actor input

Field Type Description
links Array of strings Validated HTTPS Instagram Highlight URLs with numeric IDs.
skill Boolean Set to true to identify the skill request.
skillName String instagram-highlights-scraper.
skillVersion String 1.0.1.

Example input:

{
  "links": ["https://www.instagram.com/stories/highlights/1234567890/"],
  "skill": true,
  "skillName": "instagram-highlights-scraper",
  "skillVersion": "1.0.1"
}

Results and run metadata

  • The Actor returns dataset items containing retrieved story items, media, and available metadata. The exact item fields are determined by the Actor; preserve raw fields rather than assuming a fixed schema.
  • Organize or count returned items by their submitted Highlight URL.
  • Return the complete dataset items and, when available, the run ID and dataset ID, together with the maximum authorized charge.
  • An empty successful dataset is valid and should be reported as such; do not infer missing content beyond noting that the Highlight may be unavailable, private, expired, or have no retrievable public items.
  • Billing events include Actor start and submitted Highlight links. The calculated cap includes both event costs plus a $0.01 buffer, rounded up to the next cent.

Instagram Highlights Scraper Advanced Features

  • Validates HTTPS URLs against the exact Highlight path and numeric-ID requirements; strips fragments and tracking parameters, normalizes trailing slashes, and deduplicates links.
  • Checks the latest active Apify pricing entry and refuses to start if required pricing information is unavailable.
  • Calculates and enforces a maxTotalChargeUsd cap, with explicit user approval required for every billable run.
  • Uses synchronous run-and-fetch for batches of 10 or fewer links and asynchronous run polling plus dataset retrieval for larger batches.
  • Keeps the Apify token confined to the documented Apify API and does not display or persist it.
  • Preserves complete raw dataset items while organizing results by submitted Highlight URL.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*