Social Fetch

Apify

Run Social Fetch lookups as pay-per-event Apify Store Actors — dataset export, schedules, and Apify-native billing without pasting an API key.

Run Social Fetch on Apify as Store Actors under @social-fetch. Each Actor maps 1:1 to a documented REST route, writes results to the default dataset, and bills via Apify pay-per-event (PPE). Sign in with your Apify token only — no Social Fetch API key in Actor input.

What you'll need

  • A free Apify account.
  • An Apify API token for the Console, apify-client, REST API, or schedules.
  • Billing through Apify PPE (per dataset row) — not Social Fetch credits.

Quick start

  1. Open the @social-fetch Store page and pick an Actor.
Apify Store @social-fetch page, cropped to the Public Actors section. Pink rounded-rect highlight (n8n style, ~3px stroke) around the actor card grid. Step badge 1 on the highlight corner. Optional callout label: Pick an Actor.
Each Actor maps to one Social Fetch API route — open any card to try it.
  1. Click Try for free, paste handles or URLs on the Input tab, and click Start.
Apify Console Input tab (JSON mode), cropped tight like n8n credential shots — trim sidebar if needed. Pink highlight around the handles JSON block. Step badge 2. Optional callout: Paste @handles.
Input is JSON — for profile Actors, pass an array of @handles.
  1. Open the run Output tab when the Actor finishes. Each dataset row matches the REST API { data, meta } envelope. Export as JSON, CSV, or Excel from Export.
Apify Console Output tab with JSON view, cropped to the result panel. Pink highlight around the dataset JSON row (lookupStatus, profile fields). Step badge 3. Optional callout: One row per lookup.
One row per completed lookup — same response shape as the REST API.

Results

Each completed lookup becomes one dataset item. HTTP 200 does not always mean data was found — check lookupStatus on each item when present. See Errors.

Pricing

$1.98 per 1,000 dataset rows on all Actors, plus a small per-run start fee on Apify. You are charged for completed lookups, including not_found. See each Actor's Store page for the live pricing table.

Programmatic runs

Trigger runs with apify-client, the Apify REST API, schedules, or webhooks.

import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: "YOUR_APIFY_TOKEN" });
const run = await client.actor("social-fetch/tiktok-profile-scraper").call({
  handles: ["mrbeast"],
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Troubleshooting

SymptomWhat to check
Run fails with auth errorApify token missing or invalid — regenerate in Console → Settings → Integrations.
Empty datasetInvalid handle or URL in input. Check the run log for per-item errors.
lookupStatus: not_found or privateLookup completed successfully but nothing was found — still billed as a row. See Errors.
Rate limit (429)Wait and retry; use smaller batches.
Higher cost than expectedPPE charges per dataset row. Profile-videos emits one row per video, including not_found.

Next steps

On this page