# Social Media API

> One skill for ScraperSocial's public social media and web data API — discover every documented endpoint across 33 sources (social networks plus Amazon, Google, app stores, review sites and prediction markets) and call any of them by path. Personal-contact endpoints are excluded.

- Skill: `nikhonit/social-media-api` (Agent Skill, multi-file: 5 files)
- Install (CLI): `npx get-skill add nikhonit/social-media-api`
- Raw SKILL.md: https://api.skillmd.com/api/skills/nikhonit/social-media-api/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- License: MIT-0
- Author: nikhonit (https://skillmd.com/u/nikhonit)
- Updated: 2026-11-18
- Page: https://skillmd.com/skills/nikhonit/social-media-api

---


# Social media & web data API skill

One skill that reaches every source ScraperSocial covers. Most are social networks (TikTok, Instagram, LinkedIn, YouTube, X, Reddit, Threads, Facebook and more); the catalogue also includes public web data that is not social media: Amazon products and reviews, Google Search, Maps, News, Trends, Finance and Shopping, the App Store and Google Play, Tripadvisor, Trustpilot and Polymarket. Instead of installing a skill per platform, this one lists the whole documented catalogue and calls any entry by path. Endpoints that return a person's contact details are deliberately not callable from here; see Personal data below.

`list_endpoints.js` reads a bundled snapshot, so discovery is free and works without an API key. Only `call_endpoint.js` spends credits.

This skill reaches **225 of the 227 documented endpoints across 33 sources** in one place, instead of one skill per platform. The 2 endpoints that return personal contact details are listed but not callable from here.

## When to use this skill

- You do not know which platform a request will need until you see it.
- You want one tool in the agent's context rather than 33.
- You need an endpoint that has no dedicated script in its platform skill.
- You are exploring what the API can do before committing to a specific skill.

### Do not use this skill when

- **You already know the platform.** The dedicated skill has argument validation, section flags and platform-specific guidance on what not to do. Prefer `tiktok-api` over this for TikTok work.
- **You want guidance on cost or privacy for a specific platform.** That lives in the per-platform skill, where it can be specific.
- **You are looping over many endpoints to see what sticks.** Every call costs credits. Use `list_endpoints.js` — which is free — to decide first.

## Setup

```bash
export SCRAPERSOCIAL_KEY=sk_live_...   # https://scrapersocial.com/app/keys
```

## Permissions and scope

These scripts do exactly three things and nothing else: read one environment variable (`SCRAPERSOCIAL_KEY`), send HTTPS requests to `https://api.scrapersocial.com` (the host is a constant in the code, not configurable), and print JSON. They run as `node scripts/<name>.js` with no other shell use, no file writes and no persistence. `call_endpoint.js` accepts only paths present in the bundled `endpoints.json` catalogue, never the personal-contact endpoints below, and refuses anything else before a request is made.

## Personal data

Two catalogue entries return a named person's contact details: `/v1/google_maps/contacts` and `/v1/linkedin/profile-contact`. This skill refuses to call them, and it drops the `include_email` parameter that some profile endpoints accept, so no request made from here returns an email address or phone number. They remain visible in `list_endpoints.js` output with `personalData: true` so an agent can explain why a request was declined. Anyone with a lawful basis to process a specific person's contact data should use the platform skill (for example `linkedin-api`), which documents the requirement and the cost. Everything else this skill returns is public data.

## Scripts

| Script | What it does | Credits |
|---|---|---|
| `list_endpoints.js` | List every endpoint, filterable by platform or keyword | free, no key needed |
| `call_endpoint.js` | Call any documented endpoint by path (personal-contact endpoints excluded) | the endpoint's own cost |

```bash
node skills/social-media-api/scripts/list_endpoints.js --search transcript
node skills/social-media-api/scripts/call_endpoint.js /v1/github/profile --handle torvalds
```

## Platforms

| Platform | Path segment | Endpoints |
|---|---|---|
| Amazon | `/v1/amazon/` | 4 |
| App Store | `/v1/app_store/` | 6 |
| Bluesky | `/v1/bluesky/` | 3 |
| Facebook | `/v1/facebook/` | 23 |
| GitHub | `/v1/github/` | 11 |
| Google | `/v1/google/` | 5 |
| Google Finance | `/v1/google_finance/` | 3 |
| Google Maps | `/v1/google_maps/` | 4 |
| Google News | `/v1/google_news/` | 1 |
| Google Play | `/v1/google_play/` | 4 |
| Google Shopping | `/v1/google_shopping/` | 1 |
| Google Trends | `/v1/google_trends/` | 2 |
| Hacker News | `/v1/hackernews/` | 4 |
| Instagram | `/v1/instagram/` | 23 |
| Kwai | `/v1/kwai/` | 3 |
| LinkedIn | `/v1/linkedin/` | 38 |
| Linkme | `/v1/linkme/` | 1 |
| Linktree | `/v1/linktree/` | 1 |
| Naver | `/v1/naver/` | 4 |
| Pinterest | `/v1/pinterest/` | 3 |
| Polymarket | `/v1/polymarket/` | 1 |
| Reddit | `/v1/reddit/` | 8 |
| Snapchat | `/v1/snapchat/` | 1 |
| Spotify | `/v1/spotify/` | 6 |
| Threads | `/v1/threads/` | 5 |
| TikTok | `/v1/tiktok/` | 16 |
| TikTok Shop | `/v1/tiktokshop/` | 5 |
| Tripadvisor | `/v1/tripadvisor/` | 2 |
| Trustpilot | `/v1/trustpilot/` | 1 |
| Truth Social | `/v1/truthsocial/` | 2 |
| Twitch | `/v1/twitch/` | 3 |
| X (Twitter) | `/v1/twitter/` | 7 |
| YouTube | `/v1/youtube/` | 26 |

## FAQ

### How do I find the right endpoint?

`list_endpoints.js --search transcript` filters by keyword, `--platform tiktok` filters by platform. It reads a local snapshot, so it costs nothing and needs no key.

### How do I call an endpoint?

`call_endpoint.js /v1/github/profile --handle torvalds`. Any flag after the path is passed through as a query parameter, so `--limit`, `--cursor`, `--fields`, `--format` and `--fresh` all work.

### Is the bundled endpoint list always current?

It is a snapshot generated from the live OpenAPI spec when the repo was last built. `call_endpoint.js` only accepts paths that are in that snapshot, so an endpoint added to the API after the last build is refused until the repo is rebuilt. That is intentional: the callable surface is exactly what this file documents.

### Can this skill fetch someone's email or phone number?

No. The two endpoints that return personal contact details (`/v1/linkedin/profile-contact` and `/v1/google_maps/contacts`) are excluded from `call_endpoint.js`, and the `include_email` parameter is stripped before any request is sent. If you have a lawful basis to process a specific person's contact data, use the `linkedin-api` skill, which documents the requirements and the cost; this skill will not do it.

### Should I use this or the per-platform skills?

Per-platform when you know the platform — they carry the guardrails. This one when you do not, or when you need an endpoint no script wraps.

## Disclaimer

ScraperSocial is an independent product and is not affiliated with, endorsed by, or sponsored by any platform named in this repository. All product names, logos and brands are property of their respective owners. These skills return only publicly available data.

