ApifyIntel Node.js SDK

Official Node.js/TypeScript client for ApifyIntel — discover, analyze, and monitor 3,000+ Apify actors with historical data and market intelligence.

Installation

npm install apifyintel

Quick Start

import { ApifyIntel } from 'apifyintel'

const ai = new ApifyIntel()

// Search for actors
const { data: actors } = await ai.listActors({ search: 'instagram', limit: 10 })
console.log(actors)

// Get actor details with 30-day history
const detail = await ai.getActor('apify/instagram-scraper')
console.log(detail.data.actor.actorScore)

No API key required for public endpoints. Browse actors at apifyintel.com.

Usage

List Actors

Search, paginate, and filter the full actor database.

// Search by keyword
const results = await ai.listActors({ search: 'web scraper', limit: 20 })

// Filter by developer
const devActors = await ai.listActors({ developer: 'apify' })

// Paginate
const page2 = await ai.listActors({ page: 2, limit: 50 })
console.log(page2.total)  // total actors matching
console.log(page2.hasMore) // true if more pages exist

Get Actor Details

Retrieve full details for a single actor, including 30-day performance history.

const { data } = await ai.getActor('apify/instagram-scraper')

console.log(data.actor.title)          // Actor title
console.log(data.actor.actorScore)     // 0-100 quality score
console.log(data.actor.bookmarkCount)  // Community bookmarks
console.log(data.history)              // 30-day snapshot history
console.log(data.developerProfile)     // Developer info

Get Market Stats

Aggregated statistics across the entire Apify ecosystem.

const stats = await ai.getStats()

console.log(stats.data.overview)       // Total actors, avg rating, etc.
console.log(stats.data.categories)     // Category breakdown
console.log(stats.data.topByBookmarks) // Most popular actors
console.log(stats.data.recentlyAdded)  // Newest actors

Get Trends

Market movers, rising stars, price changes, and category trends.

// Last 7 days (default)
const trends = await ai.getTrends()

// Last 30 days
const monthly = await ai.getTrends({ period: '30d' })

console.log(trends.topMovers)       // Biggest gainers/losers
console.log(trends.risingStars)     // New actors gaining traction
console.log(trends.priceChanges)    // Recent pricing changes
console.log(trends.categoryTrends)  // Category-level movements

Error Handling

import { ApifyIntel, ApifyIntelError } from 'apifyintel'

try {
  await ai.getActor('nonexistent-actor')
} catch (err) {
  if (err instanceof ApifyIntelError) {
    console.log(err.status)  // 404
    console.log(err.message) // 'Actor not found'
  }
}

Configuration

const ai = new ApifyIntel({
  // Override the base URL (useful for testing)
  baseUrl: 'http://localhost:3000',
  // Provide a custom fetch implementation
  fetch: myCustomFetch,
})

API Reference

| Method | Description | |--------|-------------| | listActors(options?) | Search and browse actors with pagination | | getActor(id) | Get actor details with 30-day history | | getStats() | Aggregated ecosystem statistics | | getTrends(options?) | Market movers and category trends |

Requirements

• Node.js 18+ (uses native fetch)

Links

• ApifyIntel — Apify actor analytics and market intelligence
• Apify — Web scraping and automation platform

License

MIT

Built by SIÁN Agency