---
name: stablesocial.dev
description: stablesocial.dev provides read-only social media data retrieval across Facebook and TikTok via an asynchronous job-token pattern. Agents submit a request and receive a signed JWT token, which must be used in a subsequent polling step to retrieve the actual data. Currently supports fetching paginated Facebook posts and TikTok profile lookups.
host: stablesocial.dev
---

# stablesocial.dev

stablesocial.dev is a lightweight social data API targeting agents that need to pull structured content or profile information from Facebook and TikTok. It serves use cases like social monitoring, profile research, and content aggregation. Its defining characteristic is an async job-token architecture: every request returns a token rather than immediate data, requiring a follow-up polling call. It does not support posting, streaming, or real-time data delivery.

## When to use this host

Use stablesocial.dev when an agent needs to retrieve Facebook post history or TikTok profile data and can handle a two-step async flow (submit request, poll with token). Do not use this host if you need synchronous, single-call data responses — the job-token pattern requires a polling step not handled by these skills alone. Do not use for writing, publishing, or modifying any social content; both skills are strictly read-only. For platforms beyond Facebook and TikTok (e.g., Instagram, Twitter/X, LinkedIn), this host offers no coverage and an alternative social data provider should be used. If real-time or streaming social data is required, this host is not suitable.

## Capabilities

### Social Profile and Content Retrieval

Fetches read-only data from Facebook pages/profiles and TikTok accounts, covering both post content and user profile information via an async token-based retrieval pattern.

- **`fetch-facebook-posts`** — Retrieves paginated posts from a Facebook user or page profile, returning a signed JWT token that encodes the job parameters for async result retrieval.
- **`fetch-tiktok-profile`** — Submits a TikTok username to the StableSocial API and returns a signed job token for asynchronous retrieval of that account's profile data.

## Skill reference

### `fetch-facebook-posts`

**Stable Social Facebook Posts** — Retrieves paginated posts from a Facebook user or page profile, returning a signed JWT token that encodes the job parameters for async result retrieval.

*Use when:* Use when an agent needs to collect recent posts from a Facebook profile or page by profile ID, with control over sort order, post count, and page size.

*Not for:* Do not use for creating or publishing new Facebook posts; this endpoint is read-only. Not suitable for real-time streaming of posts — this is a paginated, single-shot request.

**Inputs:**

- `profile_id` (string, required) — Facebook profile ID or username to fetch posts from.
- `max_posts` (integer) — Maximum total number of posts to collect. Defaults to 50, maximum 300.
- `order_by` (string) — Sort order for returned posts. One of: date_desc, date_asc, id_desc.
- `max_page_size` (integer) — Number of results per page. Defaults to 50.
- `cursor` (string) — Pagination cursor for fetching the next page of results.

**Returns:** Returns a signed JWT token string encoding the feed job parameters (profile path, page size, sort order, wallet) for subsequent async retrieval of the requested posts.

**Example:** `{"profile_id": "facebook", "max_posts": 5, "order_by": "date_desc", "max_page_size": 3, "cursor": ""}`

---

### `fetch-tiktok-profile`

**TikTok Profile Lookup** — Submits a TikTok username to the StableSocial API and returns a signed job token for asynchronous retrieval of that account's profile data.

*Use when:* Use when an agent needs to look up a TikTok user's profile information by handle and can follow up with a polling step using the returned job token.

*Not for:* Do not use if you need synchronous, immediate profile field data in a single response; the API returns a job token requiring a subsequent polling call to retrieve the actual profile fields.

**Inputs:**

- `handle` (string, required) — TikTok username without the @ symbol.

**Returns:** Returns a JSON object with a single `token` field containing a signed JWT that identifies the queued profile lookup job for subsequent polling.

**Example:** `{"handle": "nasa"}`

---