# Apify API
> Pay-per-call access to Apify Store actor discovery and Apify Actor runs over x402/MPP.

## Workflow
1. POST /api/actors/list to search Apify Store actors. Use `search` for broad discovery, or `username` + `actorName` for one actor.
2. POST /api/actors/call with `{ "actorId": "username/name", "input": {...} }` to start a run, OR POST /api/actors/{username}/{name}/call with `{ "input": {...} }` for one of the curated top-100 actors listed below. Both return `{ token, run }`; save the token.
3. POST /api/actors/status with `{ "token": "..." }` to poll the run's status. Free, SIWX-authenticated. Repeat every 15–30s until `status` is SUCCEEDED, FAILED, TIMED-OUT, or ABORTED.
4. POST /api/actors/results with `{ "token": "..." }` once the run is terminal to fetch dataset items. The first call from a wallet pays via x402 proportional to the run's Apify usage; subsequent calls from the same wallet replay free with a SIWX signature (pagination, second look, etc.).

## Endpoints
- POST /api/actors/list ($0.005): Search/list public Apify Store actors. Supports `search`, `limit`, `offset`, `category`, `username`, and `actorName`.
- POST /api/actors/call ($0.01): Start a run on any Store actor by `actorId`. Optional run options: `build`, `memory`, `timeout`, and `maxItems`.
- POST /api/actors/{username}/{name}/call ($0.01): Curated per-actor endpoints for the top 100 actors by recent usage. Body is `{ input?, options? }` (no `actorId` — it's in the URL). Each curated endpoint advertises the actor's full input schema (field names, types, defaults, descriptions) through OpenAPI — call `check_endpoint_schema` to inspect it before sending input. See the catalog below; for the long tail of ~21k actors use /api/actors/call instead.
- POST /api/actors/status (SIWX, free): Poll the run summary (status, statusMessage, exitCode, usageTotalUsd). Use this to wait for a terminal status before fetching paid results.
- POST /api/actors/results (.upTo, SIWX-replay): Fetch items from the run's default dataset. Body supports `limit`, `offset`, `clean`, `fields`, `omit`, `desc`, and `unwind`. Charged proportionally to the run's Apify usage (1.5x markup, $0.01 floor, $1.00 cap) on the first call per wallet; subsequent calls from the same wallet replay free with SIWX. Returns 409 if the run is not yet terminal — poll /api/actors/status first.

Actor inputs are actor-specific. Prefer listing/getting the Store actor first and reading its input schema/documentation before calling. Long-running actors may remain RUNNING for minutes; poll /api/actors/status every 15-30 seconds until the run status is terminal.

If a run FAILS, inspect `run.statusMessage` and `run.exitCode` in the /api/actors/status or /api/actors/results response — the actor's failure reason is bubbled through (e.g. invalid input shape, target site blocked the request).

## Normalized inputs (server-side normalization)
Some curated actors have a brittle native input shape, so the server accepts a simpler shape and builds the native input for you. You can still POST the actor's native shape — normalizers pass it through unchanged. Send these fields directly inside `input`:

### maxcopell/zillow-scraper — Zillow Search
The actor's native `searchUrls[].url` MUST contain a URL-encoded `?searchQueryState=...` JSON object. Instead, send:
```json
{
  "input": {
    "bbox": { "west": -73.953, "east": -73.937, "south": 40.7105, "north": 40.7150 },
    "listingType": "for_rent",
    "extractionMethod": "MAP_MARKERS",
    "sort": "globalrelevanceex",
    "extraFilterState": { "price": { "min": 500000, "max": 2000000 } },
    "maxItems": 60
  }
}
```
- `bbox` (required unless you pass `searchUrls`): map bounds. Server builds the searchQueryState URL.
- `listingType`: `"for_sale"` (default) | `"for_rent"` | `"sold"`.
- `extractionMethod`: `"MAP_MARKERS"` (default, fastest, ~500 marker cap) | `"PAGINATION"` | `"PAGINATION_WITH_ZOOM_IN"`.
- `extraFilterState`: merged into the searchQueryState filterState (price, beds, etc.).
- `maxItems`: lifted into run `options.maxItems`.

### maxcopell/zillow-detail-scraper — Zillow Details
Native `startUrls` works, but you can also send `urls` (array of strings) or `zpids` (array of property IDs):
```json
{ "input": { "zpids": ["446985440", "450447341"] } }
```
The server expands zpids to `https://www.zillow.com/homedetails/{zpid}_zpid/`.

## Curated top-100 actor catalog
The following actors are exposed as dedicated `/api/actors/{username}/{name}/call` endpoints, ranked by 30-day active users on Apify Store.

- /api/actors/compass/crawler-google-places/call — Google Maps Scraper
- /api/actors/apify/instagram-scraper/call — Instagram Scraper
- /api/actors/apify/rag-web-browser/call — RAG Web Browser
- /api/actors/apify/instagram-profile-scraper/call — Instagram Profile Scraper
- /api/actors/clockworks/tiktok-scraper/call — TikTok Scraper
- /api/actors/curious_coder/linkedin-jobs-scraper/call — Linkedin Jobs Scraper
- /api/actors/apify/google-search-scraper/call — Google Search Results Scraper
- /api/actors/apify/facebook-posts-scraper/call — Facebook Posts Scraper
- /api/actors/apify/instagram-post-scraper/call — Instagram Post Scraper
- /api/actors/harvestapi/linkedin-profile-scraper/call — LinkedIn Profile Scraper + Email ✅ No Cookies
- /api/actors/apify/website-content-crawler/call — Website Content Crawler
- /api/actors/streamers/youtube-scraper/call — YouTube Scraper
- /api/actors/apify/instagram-reel-scraper/call — Instagram Reel Scraper
- /api/actors/apify/instagram-hashtag-scraper/call — Instagram Hashtag Scraper
- /api/actors/code_crafter/leads-finder/call — ✨Leads Finder - $1.5/1k leads with Emails [Apollo Alternative]
- /api/actors/apidojo/tweet-scraper/call — 🏯 Tweet Scraper V2 - X / Twitter Scraper
- /api/actors/dev_fusion/Linkedin-Profile-Scraper/call — ✨Mass Linkedin Profile Scraper with Email 📧 (No Cookies)
- /api/actors/compass/Google-Maps-Reviews-Scraper/call — Google Maps Reviews Scraper
- /api/actors/harvestapi/linkedin-profile-posts/call — LinkedIn Profile Posts Scraper (No Cookies)
- /api/actors/apify/web-scraper/call — Web Scraper
- /api/actors/trudax/reddit-scraper-lite/call — Reddit Scraper Lite
- /api/actors/curious_coder/facebook-ads-library-scraper/call — Facebook Ad Library Scraper
- /api/actors/apify/facebook-pages-scraper/call — Facebook Pages Scraper
- /api/actors/apify/facebook-groups-scraper/call — Facebook Groups Scraper
- /api/actors/apify/instagram-comment-scraper/call — Instagram Comments Scraper
- /api/actors/clockworks/free-tiktok-scraper/call — TikTok Data Extractor
- /api/actors/clockworks/tiktok-profile-scraper/call — TikTok Profile Scraper
- /api/actors/supreme_coder/linkedin-post/call — Linkedin Post Scraper ✅ No cookies · $1 per 1k
- /api/actors/apify/facebook-ads-scraper/call — Facebook Ads Library Scraper
- /api/actors/apify/facebook-comments-scraper/call — Facebook Comments Scraper
- /api/actors/kaitoeasyapi/twitter-x-data-tweet-scraper-pay-per-result-cheapest/call — Tweet Scraper|$0.25/1K Tweets | Pay-Per Result | No Rate Limits
- /api/actors/lukaskrivka/google-maps-with-contact-details/call — 📩📍 Google Maps Email Extractor
- /api/actors/clockworks/tiktok-comments-scraper/call — TikTok Comments Scraper
- /api/actors/harvestapi/linkedin-post-search/call — Linkedin Post Search Scraper (No Cookies)
- /api/actors/worldunboxer/rapid-linkedin-scraper/call — ⚡️Rapid Linkedin Jobs Scraper
- /api/actors/pintostudio/youtube-transcript-scraper/call — Youtube Transcript Scraper
- /api/actors/compass/google-maps-extractor/call — Google Maps Extractor
- /api/actors/apidojo/twitter-scraper-lite/call — Twitter (X.com) Scraper Unlimited: No Limits
- /api/actors/misceres/indeed-scraper/call — Indeed Scraper
- /api/actors/apimaestro/linkedin-profile-posts/call — Profile Posts Scraper for LinkedIn [No Cookies]
- /api/actors/streamers/youtube-channel-scraper/call — Fast YouTube Channel Scraper
- /api/actors/one-api/skip-trace/call — Skip Trace
- /api/actors/harvestapi/linkedin-company/call — Linkedin Company Details Scraper (No Cookies) ✅ Bulk
- /api/actors/valig/indeed-jobs-scraper/call — 💡 Indeed Jobs Scraper
- /api/actors/borderline/indeed-scraper/call — 🚀 Indeed jobs scraper [PPR]
- /api/actors/vdrmota/contact-info-scraper/call — Contact Details Scraper
- /api/actors/apimaestro/linkedin-profile-detail/call — Profile Details Scraper for LinkedIn + EMAIL (No Cookies)
- /api/actors/harvestapi/linkedin-company-posts/call — LinkedIn Company Posts Scraper (No Cookies)
- /api/actors/apify/cheerio-scraper/call — Cheerio Scraper
- /api/actors/danek/facebook-search-ppr/call — Facebook Search PPR
- /api/actors/apimaestro/linkedin-posts-search-scraper-no-cookies/call — Posts Search Scraper for LinkedIn | No Cookies
- /api/actors/starvibe/youtube-video-transcript/call — YouTube Video Transcript
- /api/actors/clockworks/tiktok-hashtag-scraper/call — TikTok Hashtag Scraper
- /api/actors/apify/instagram-search-scraper/call — Instagram Search Scraper
- /api/actors/streamers/youtube-comments-scraper/call — YouTube Comments Scraper
- /api/actors/apify/puppeteer-scraper/call — Puppeteer Scraper
- /api/actors/scraperlink/google-search-results-serp-scraper/call — Google Search Results (~$0.05/1K Results)
- /api/actors/streamers/youtube-shorts-scraper/call — YouTube Shorts Scraper
- /api/actors/apify/instagram-api-scraper/call — Instagram API Scraper
- /api/actors/apimaestro/linkedin-company-posts/call — Company Posts Scraper for LinkedIn – No Cookies
- /api/actors/peakydev/leads-scraper-ppe/call — Leads Scraper ✅ $1/1k with EMAILS ✅ Apollo | LinkedIn Profile
- /api/actors/junglee/Amazon-crawler/call — Amazon Product Scraper
- /api/actors/apimaestro/linkedin-profile-batch-scraper-no-cookies-required/call — Profile Details Batch Scraper for LinkedIn + EMAIL (No Cookies)
- /api/actors/apify/playwright-scraper/call — Playwright Scraper
- /api/actors/harvestapi/linkedin-post-comments/call — LinkedIn Post Comments Scraper (No Cookies) ✅ (No Cookies)
- /api/actors/scraping_solutions/instagram-scraper-followers-following-no-cookies/call — Instagram Scraper Followers / Following ✅ No cookies ✅
- /api/actors/apify/google-trends-scraper/call — Google Trends Scraper
- /api/actors/maxcopell/zillow-detail-scraper/call — Zillow Detail Scraper
- /api/actors/harshmaur/reddit-scraper/call — Reddit Scraper - MCP, AI, PPR
- /api/actors/apimaestro/linkedin-post-comments-replies-engagements-scraper-no-cookies/call — Post Comments & Engagements Scraper for LinkedIn | No Cookies
- /api/actors/pipelinelabs/lead-scraper-apollo-zoominfo-lusha-ppe/call — 🎉Leads Scraper ✅ $1/1k Leads ✅ 50K/Run With EMAILS✅Like Apollo
- /api/actors/apidojo/tiktok-scraper/call — 🏯 Tiktok Scraper (Pay Per Result)
- /api/actors/apify/facebook-marketplace-scraper/call — Facebook Marketplace Scraper
- /api/actors/karamelo/youtube-transcripts/call — Youtube Transcripts
- /api/actors/clockworks/tiktok-video-scraper/call — TikTok Video Scraper
- /api/actors/anchor/linkedin-profile-enrichment/call — LinkedIn Profile Scraper for cheap lead enrichment ✅
- /api/actors/scraptik/tiktok-api/call — Full TikTok API Scraper
- /api/actors/cheap_scraper/linkedin-job-scraper/call — LinkedIn Jobs Scraper | Remove Duplicate Jobs | Pay Per Result
- /api/actors/topaz_sharingan/Youtube-Transcript-Scraper-1/call — YouTube Transcript Ninja ⚡️🥷⚡
- /api/actors/neatrat/upwork-job-scraper/call — Upwork Job Scraper
- /api/actors/fantastic-jobs/career-site-job-listing-api/call — Career Site Job Listing API
- /api/actors/apify/e-commerce-scraping-tool/call — E-commerce Scraping Tool
- /api/actors/fantastic-jobs/advanced-linkedin-job-search-api/call — Advanced LinkedIn Job Search API
- /api/actors/apidojo/instagram-scraper/call — 🏯 Instagram Scraper (Pay Per Result)
- /api/actors/apify/facebook-search-scraper/call — Facebook Search Scraper
- /api/actors/apify/screenshot-url/call — Website Screenshot Generator
- /api/actors/valig/linkedin-jobs-scraper/call — 🏆 LinkedIn Jobs Scraper
- /api/actors/junglee/free-amazon-product-scraper/call — Amazon Scraper
- /api/actors/maxcopell/tripadvisor-reviews/call — Tripadvisor Reviews Scraper
- /api/actors/apimaestro/linkedin-company-employees-scraper-no-cookies/call — Company Employees Scraper for LinkedIn | No Cookies
- /api/actors/voyager/booking-scraper/call — Booking Scraper
- /api/actors/maxcopell/zillow-scraper/call — Zillow Search Scraper
- /api/actors/web_wanderer/amazon-reviews-extractor/call — Amazon Reviews Scraper
- /api/actors/apify/instagram-followers-count-scraper/call — Instagram Followers Count Scraper
- /api/actors/apidojo/twitter-user-scraper/call — Fast Twitter (X) User Scraper API | Extract Profiles, Followers
- /api/actors/lukaskrivka/google-sheets/call — Google Sheets Import & Export
- /api/actors/harvestapi/linkedin-post-reactions/call — LinkedIn Post Reactions Scraper (No Cookies) ✅ (No Cookies)
- /api/actors/apidojo/youtube-scraper/call — 🏯 Youtube Scraper (Pay Per Result)
- /api/actors/braveleads/leads-finder-linkedin-apollo-leads-generator/call — Leads ✅ Finder | Similar to Apollo LinkedIn Leads Generator
- /api/actors/lukaskrivka/article-extractor-smart/call — Smart Article Extractor