Apify Skill

Apify Web Scraping Skill

Run pre-built web scrapers (Actors) to extract data from websites and social media platforms.

How It Works

This skill provides instructions for the Apify Actor tool node. Connect the Apify Actor node to Zeenie's input-tools handle to enable web scraping capabilities.

apify_run_actor Tool

Run any Apify actor and retrieve scraped results.

Schema Fields

Popular Actors

Response Format

jsonCopy code
{
  "run_id": "abc123xyz",
  "actor_id": "apify/instagram-scraper",
  "status": "SUCCEEDED",
  "items": [
    { "id": "123", "text": "Post content...", "likes": 500 }
  ],
  "item_count": 50,
  "dataset_id": "dataset-id-here",
  "compute_units": 0.5,
  "started_at": "2026-02-23T10:00:00Z",
  "finished_at": "2026-02-23T10:02:30Z"
}

Examples

Scrape Instagram profile:

jsonCopy code
{
  "actor_id": "apify/instagram-scraper",
  "input_json": "{\"directUrls\": [\"https://instagram.com/natgeo\"], \"resultsLimit\": 50}",
  "max_results": 50
}

Search TikTok hashtag:

jsonCopy code
{
  "actor_id": "clockworks/tiktok-scraper",
  "input_json": "{\"hashtags\": [\"trending\", \"fyp\"], \"resultsPerPage\": 30}",
  "max_results": 30
}

Search Twitter/X:

jsonCopy code
{
  "actor_id": "apidojo/tweet-scraper",
  "input_json": "{\"searchTerms\": [\"AI automation\"], \"maxItems\": 100}",
  "max_results": 100
}

Google Search:

jsonCopy code
{
  "actor_id": "apify/google-search-scraper",
  "input_json": "{\"queries\": \"best AI tools 2026\", \"maxPagesPerQuery\": 3}",
  "max_results": 30
}

Crawl website content:

jsonCopy code
{
  "actor_id": "apify/website-content-crawler",
  "input_json": "{\"startUrls\": [{\"url\": \"https://docs.example.com\"}], \"maxCrawlDepth\": 2, \"maxCrawlPages\": 50}",
  "max_results": 50
}

Scrape Google Maps places:

jsonCopy code
{
  "actor_id": "apify/google-maps-scraper",
  "input_json": "{\"searchStringsArray\": [\"restaurants in San Francisco\"], \"maxCrawledPlaces\": 20}",
  "max_results": 20
}

Common Input Parameters by Actor

Instagram Scraper

TikTok Scraper

Twitter/X Scraper

Google Search Scraper

Website Content Crawler

Error Responses

Actor not found:

jsonCopy code
{
  "success": false,
  "error": "Actor 'invalid/actor-id' not found"
}

Timeout:

jsonCopy code
{
  "success": false,
  "error": "Actor run timed out after 300 seconds"
}

Run failed:

jsonCopy code
{
  "success": false,
  "error": "Actor run failed with status FAILED"
}

Run Status Values

Use Cases

Guidelines

1. Actor IDs: Use format username/actor-name from Apify Store
2. Input JSON: Must be valid JSON string with actor-specific parameters
3. Timeouts: Default 300 seconds, configurable on the node
4. Max Results: Limits items returned (not items scraped)
5. Memory: Higher memory = faster execution, higher cost

Pricing Notes

Apify uses compute units (CU) based on memory and duration:

• CU = Memory (GB) x Duration (hours)
• Free tier: $5/month credits
• Check actor pricing on Apify Store before large scrapes

Setup Requirements

1. Connect the Apify Actor node to Zeenie's input-tools handle
2. Configure your Apify API token in Credentials Modal
3. Select an actor or enter custom actor ID
4. Provide actor-specific input as JSON

Security Notes

1. Respect website terms of service
2. Use reasonable scraping rates to avoid IP bans
3. Don't scrape personal data without consent
4. Store scraped data securely
5. Comply with GDPR and data protection laws