Skills/Site Scrapers/Social media

Social media

~60 credits / run (up to 5000)

Pulls posts, profiles, comments, hashtags, or trends from social platforms including Instagram, TikTok, X/Twitter, Reddit, Facebook, Threads, and Pinterest. Returns structured records with engagement metrics, timestamps, and author details.

Use when

You want structured social content or engagement metrics from a named platform, profile, hashtag, or post.

Not for

Video platforms (use the video operation), or sites that require your own login.

Cost

~60 credits / run (up to 5000)

A small, capped pull is the usual case; larger pulls cost more as the record count rises.

Estimated; the actual charge depends on your input and is shown in the response.

What it accepts

Set these inside the intent when you run it.

targetoptional

A profile URL, post URL, or handle to scrape when you know the specific account.

queryoptional

A keyword, hashtag, or search term to discover posts when you do not have a specific URL.

platformoptional

The social platform to scrape (Instagram, TikTok, Twitter, Reddit, Facebook, Threads, Pinterest).

limitoptional

Roughly how many records to return; a small number is recommended to control cost.

What you get back

A list of structured social content records (posts, profiles, or comments) with engagement data.

Run it

Run this sub-skill directly: pin it with operation and pass its inputs in the intent. (Omit operation and the Site Scrapers skill will route from your intent instead.)

curl -X POST "https://skill.askfaro.com/skills/site-scrapers/run" \
  -H "Authorization: Bearer $FARO_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"intent":{"operation":"social_media","target":"https://www.instagram.com/natgeo/","query":"#sustainablefashion","platform":"Instagram","limit":"25"}}'

Example requests

  • Get the last 20 posts from this Instagram account
  • Find tweets mentioning this hashtag from the past week
  • Pull the trending TikTok hashtags in the US right now