social-media-research

Social media research

Look up public profiles, posts, and engagement, run keyword/hashtag search, and track trending topics across nine social platforms — all as normalized JSON from the Crawlora API, no app scraping or unofficial client libraries.

When to use this skill

• "What's 's profile / follower count / recent posts on ?"
• "Pull this post's engagement (likes, comments, shares)."
• "Search for posts about ."
• "What's trending on right now?"
• Competitor social-listening, influencer research, or brand-mention monitoring.

Setup (one-time)

• Get a free Crawlora API key (2,000 credits/mo, no card) at https://crawlora.net.
• export CRAWLORA_API_KEY=sk_your_key_here
• All requests: x-api-key: $CRAWLORA_API_KEY against https://api.crawlora.net/api/v1. Missing/invalid key → 401.

How it works

Pick the platform, then the job:

1. Profile — /instagram/profile/{username}, /tiktok/profile/{handler}, /threads/profile/{username}, /bluesky/profile, /x/profile/{username}, /pinterest/user/{username}, /linkedin/company/{id}, /facebook/{page}, /reddit/user/{username}/posts.
2. Posts / feed — /instagram/reels/{id}, /tiktok/posts, /threads/profile/{username}/posts, /bluesky/author-feed, /x/profile/{username}/posts, /pinterest/user/{username}/pins, /reddit/subreddit/{subreddit}/posts.
3. One post/pin/pin detail — /instagram/post/{id}/{post_id}, /tiktok/post/{id}, /threads/post/{username}/{code} (+ /replies), /bluesky/post-thread, /x/post/{id}, /pinterest/pin/{id}, /reddit/post/{id} (+ /reddit/comments/{id}).
4. Search & discovery — /tiktok/search, /tiktok/search_hashtag, /bluesky/search-actors, /pinterest/search, /reddit/search, /facebook/marketplace/search (listings, not social posts).
5. Trending — /tiktok/trending, /tiktok/creative-center/hashtags, /bluesky/trending-topics, /reddit/trends, /reddit/subreddits/posts (multi-subreddit hot feed).

Full endpoint list, methods, and params: reference/endpoints.md.

Calling the API

# Profile + posts:
scripts/crawlora.sh /tiktok/profile/nasa | jq '.'
scripts/crawlora.sh /reddit/user/spez/posts | jq '.'

# Search:
scripts/crawlora.sh /tiktok/search keyword="ai agents" | jq '.'
scripts/crawlora.sh /reddit/search q="web scraping" | jq '.'

# Trending:
scripts/crawlora.sh /tiktok/trending | jq '.'
scripts/crawlora.sh /bluesky/trending-topics | jq '.'

Raw curl fallback:

curl -fsS -H "x-api-key: $CRAWLORA_API_KEY" \
  "https://api.crawlora.net/api/v1/reddit/subreddit/programming/posts" | jq '.'

Endpoint reference

See reference/endpoints.md for every Instagram, TikTok, Threads, Bluesky, X, Pinterest, LinkedIn, Facebook, and Reddit endpoint this skill uses.

Examples

• Competitor social audit: pull profile + recent posts on each platform a competitor is active on, compare follower counts and post cadence.
• Brand-mention sweep: /reddit/search, /tiktok/search, and /pinterest/search for the same brand/product name, aggregate volume and sentiment cues from captions/comments.
• Influencer vetting: profile + recent posts to check follower count, engagement rate (likes/comments per post), and posting consistency before a partnership.
• Trending-topic scan: /tiktok/trending + /bluesky/trending-topics + /reddit/trends for a same-day cross-platform snapshot.

Notes & limits

• Credits / pay-on-success: billed only on 2xx; free tier 2,000 credits/mo. Key at https://crawlora.net.
• Public data only — public profiles/posts; no login, no private content. Respect each platform's terms.
• Security: key lives in CRAWLORA_API_KEY only — never hardcode, query-param, or commit it.
• Coverage varies by platform: X and Instagram expose a narrower public surface (profile + recent posts) than TikTok or Reddit (full search + trending); check reference/endpoints.md before assuming an endpoint exists.
• List endpoints are cursor- or page-paginated — follow the returned cursor to walk beyond the first page.