---
type: "firecrawl-provider"
description: "Public posts, comments, and searches across Reddit, Threads, Facebook, Instagram, TikTok, X, YouTube, LinkedIn, Pinterest, Bluesky, and Truth Social."
use_when: "Reddit search, subreddit posts, and post comments.\n\nThreads posts, a user's posts, and post search.\n\nPublic Facebook posts, page and group posts, reels, comments, and replies.\n\nPublic Instagram posts, a user's posts and reels, comments, reel search, and hashtag posts.\n\nTikTok videos, a user's videos, comments, replies, and keyword search.\n\nX posts, a user's posts, and community posts.\n\nYouTube videos, channel videos, comments, replies, community posts, and search.\n\nLinkedIn company posts, single posts, and post search.\n\nPinterest pins, boards, and pin search.\n\nBluesky posts and a user's posts.\n\nTruth Social posts and a user's posts."
categories: "Social"
capabilities: 43
pricing: "2 credits per billed unit; see each capability for its unit and maximum."
---
# ScrapeCreators on Firecrawl Alexandria

Public posts, comments, and searches across Reddit, Threads, Facebook, Instagram, TikTok, X, YouTube, LinkedIn, Pinterest, Bluesky, and Truth Social.

- Categories: Social
- Category index: [Social category](https://alexandria.firecrawl.dev/agents/categories/social)
- Provider key: `scrapecreators`
- Access: Firecrawl credits
- Cost (Reddit search): 2 credits per ScrapeCreators credit
- Cost (Reddit subreddit posts): 2 credits per ScrapeCreators credit
- Cost (Reddit post comments): 2 credits per ScrapeCreators credit
- Cost (Threads post): 2 credits per ScrapeCreators credit
- Cost (Threads posts): 2 credits per ScrapeCreators credit
- Cost (Threads search by keyword): 2 credits per ScrapeCreators credit
- Cost (Facebook group posts): 2 credits per ScrapeCreators credit
- Cost (Facebook post): 2 credits per ScrapeCreators credit
- Cost (Facebook comments): 2 credits per ScrapeCreators credit
- Cost (Facebook comment replies): 2 credits per ScrapeCreators credit
- Cost (Facebook profile posts): 2 credits per ScrapeCreators credit
- Cost (Facebook profile reels): 2 credits per ScrapeCreators credit
- Cost (Instagram post/reel info): 2 credits per ScrapeCreators credit
- Cost (Instagram posts): 2 credits per ScrapeCreators credit
- Cost (Instagram comments): 2 credits per ScrapeCreators credit
- Cost (Instagram reels): 2 credits per ScrapeCreators credit
- Cost (Instagram search reels): 2 credits per ScrapeCreators credit
- Cost (Instagram search hashtag posts): 2 credits per ScrapeCreators credit
- Cost (TikTok video info): 2 credits per ScrapeCreators credit
- Cost (TikTok profile videos): 2 credits per ScrapeCreators credit
- Cost (TikTok comments): 2 credits per ScrapeCreators credit
- Cost (TikTok comment replies): 2 credits per ScrapeCreators credit
- Cost (TikTok search by keyword): 2 credits per ScrapeCreators credit
- Cost (X user tweets): 2 credits per ScrapeCreators credit
- Cost (X tweet details): 2 credits per ScrapeCreators credit
- Cost (X community tweets): 2 credits per ScrapeCreators credit
- Cost (YouTube video/short details): 2 credits per ScrapeCreators credit
- Cost (YouTube channel videos): 2 credits per ScrapeCreators credit
- Cost (YouTube comments): 2 credits per ScrapeCreators credit
- Cost (YouTube comment replies): 2 credits per ScrapeCreators credit
- Cost (YouTube channel community posts): 2 credits per ScrapeCreators credit
- Cost (YouTube community post details): 2 credits per ScrapeCreators credit
- Cost (YouTube search): 2 credits per ScrapeCreators credit
- Cost (LinkedIn company posts): 2 credits per ScrapeCreators credit
- Cost (LinkedIn post): 2 credits per ScrapeCreators credit
- Cost (LinkedIn search posts): 2 credits per ScrapeCreators credit
- Cost (Pinterest pin): 2 credits per ScrapeCreators credit
- Cost (Pinterest search): 2 credits per ScrapeCreators credit
- Cost (Pinterest board): 2 credits per ScrapeCreators credit
- Cost (Bluesky post): 2 credits per ScrapeCreators credit
- Cost (Bluesky posts): 2 credits per ScrapeCreators credit
- Cost (Truth Social post): 2 credits per ScrapeCreators credit
- Cost (Truth Social user posts): 2 credits per ScrapeCreators credit

## More

- [Human guide](https://www.firecrawl.dev/app/alexandria/scrapecreators)
- [OpenAPI spec](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/openapi.json)

## Capabilities

- [Reddit search](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/reddit/search-posts): A list under posts, one row per item. The response also carries success, credits_remaining, credits_charged, after. Pass back as after for the next page. Fields are the vendor's own and are passed through unchanged.
- [Reddit subreddit posts](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/reddit/subreddit-posts): A list under posts, one row per item. The response also carries success, credits_remaining, credits_charged, after. Pass back as after for the next page. Fields are the vendor's own and are passed through unchanged.
- [Reddit post comments](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/reddit/post-comments): A list under comments, one row per item. The response also carries success, credits_remaining, credits_charged, post, more. Fields are the vendor's own and are passed through unchanged.
- [Threads post](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/threads/post): One object. Fields are the vendor's own and are passed through unchanged.
- [Threads posts](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/threads/user-posts): A list under posts, one row per item. The response also carries success, credits_remaining, credits_charged. Fields are the vendor's own and are passed through unchanged.
- [Threads search by keyword](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/threads/search-posts): A list under posts, one row per item. The response also carries success, credits_remaining, credits_charged. Fields are the vendor's own and are passed through unchanged.
- [Facebook group posts](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/facebook/group-posts): A list under posts, one row per item. The response also carries success, credits_remaining, credits_charged, cursor. Pass back as cursor for the next page. Fields are the vendor's own and are passed through unchanged.
- [Facebook post](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/facebook/post): One object. Fields are the vendor's own and are passed through unchanged.
- [Facebook comments](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/facebook/post-comments): A list under comments, one row per item. The response also carries success, credits_remaining, credits_charged, cursor, has_next_page. Pass back as cursor for the next page. Fields are the vendor's own and are passed through unchanged.
- [Facebook comment replies](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/facebook/comment-replies): A list under replies, one row per item. The response also carries success, credits_remaining, credits_charged, cursor, has_next_page. Pass back as cursor for the next page. Fields are the vendor's own and are passed through unchanged.
- [Facebook profile posts](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/facebook/profile-posts): A list under posts, one row per item. The response also carries success, credits_remaining, credits_charged, cursor. Pass back as cursor for the next page. Fields are the vendor's own and are passed through unchanged.
- [Facebook profile reels](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/facebook/profile-reels): A list under reels, one row per item. The response also carries success, credits_remaining, credits_charged, cursor, next_page_id. Pass back as cursor for the next page. Fields are the vendor's own and are passed through unchanged.
- [Instagram post/reel info](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/instagram/post): One object. Fields are the vendor's own and are passed through unchanged.
- [Instagram posts](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/instagram/user-posts): A list under items, one row per item. The response also carries success, credits_remaining, credits_charged, next_max_id, num_results, more_available, user. Pass back as next_max_id for the next page. Fields are the vendor's own and are passed through unchanged.
- [Instagram comments](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/instagram/post-comments): A list under comments, one row per item. The response also carries success, credits_remaining, credits_charged, cursor. Pass back as cursor for the next page. Fields are the vendor's own and are passed through unchanged.
- [Instagram reels](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/instagram/user-reels): A list under items, one row per item. The response also carries success, credits_remaining, credits_charged, max_id. Pass back as max_id for the next page. Fields are the vendor's own and are passed through unchanged.
- [Instagram search reels](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/instagram/search-reels): A list under reels, one row per item. The response also carries success, credits_remaining, credits_charged. Fields are the vendor's own and are passed through unchanged.
- [Instagram search hashtag posts](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/instagram/hashtag-posts): A list under posts, one row per item. The response also carries success, credits_remaining, credits_charged, hashtag, media_type, cursor. Pass back as cursor for the next page. Fields are the vendor's own and are passed through unchanged.
- [TikTok video info](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/tiktok/video): One object. Fields are the vendor's own and are passed through unchanged.
- [TikTok profile videos](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/tiktok/user-videos): One object. Fields are the vendor's own and are passed through unchanged.
- [TikTok comments](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/tiktok/video-comments): A list under comments, one row per item. The response also carries success, credits_remaining, credits_charged, cursor, total. Pass back as cursor for the next page. Fields are the vendor's own and are passed through unchanged.
- [TikTok comment replies](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/tiktok/comment-replies): A list under comments, one row per item. The response also carries success, credits_remaining, credits_charged, cursor, extra, has_more, log_pb, status_code, status_msg, total. Pass back as cursor for the next page. Fields are the vendor's own and are passed through unchanged.
- [TikTok search by keyword](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/tiktok/search-videos): A list under search_item_list, one row per item. The response also carries success, credits_remaining, credits_charged, cursor. Pass back as cursor for the next page. Fields are the vendor's own and are passed through unchanged.
- [X user tweets](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/x/user-posts): A list under tweets, one row per item. The response also carries success, credits_remaining, credits_charged. Fields are the vendor's own and are passed through unchanged.
- [X tweet details](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/x/post): One object. Fields are the vendor's own and are passed through unchanged.
- [X community tweets](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/x/community-posts): A list under tweets, one row per item. The response also carries success, credits_remaining, credits_charged. Fields are the vendor's own and are passed through unchanged.
- [YouTube video/short details](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/youtube/video): One object. Fields are the vendor's own and are passed through unchanged.
- [YouTube channel videos](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/youtube/channel-videos): A list under videos, one row per item. The response also carries success, credits_remaining, credits_charged, continuationToken. Pass back as continuationToken for the next page. Fields are the vendor's own and are passed through unchanged.
- [YouTube comments](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/youtube/video-comments): A list under comments, one row per item. The response also carries success, credits_remaining, credits_charged, continuationToken. Pass back as continuationToken for the next page. Fields are the vendor's own and are passed through unchanged.
- [YouTube comment replies](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/youtube/comment-replies): A list under comments, one row per item. The response also carries success, credits_remaining, credits_charged, continuationToken. Pass back as continuationToken for the next page. Fields are the vendor's own and are passed through unchanged.
- [YouTube channel community posts](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/youtube/community-posts): A list under posts, one row per item. The response also carries success, credits_remaining, credits_charged, continuationToken. Pass back as continuationToken for the next page. Fields are the vendor's own and are passed through unchanged.
- [YouTube community post details](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/youtube/community-post): One object. Fields are the vendor's own and are passed through unchanged.
- [YouTube search](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/youtube/search): A list under videos, one row per item. The response also carries success, credits_remaining, credits_charged, channels, playlists, shorts, shelves, lives, continuationToken. Pass back as continuationToken for the next page. Fields are the vendor's own and are passed through unchanged.
- [LinkedIn company posts](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/linkedin/company-posts): A list under posts, one row per item. The response also carries success, credits_remaining, credits_charged. Fields are the vendor's own and are passed through unchanged.
- [LinkedIn post](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/linkedin/post): One object. Fields are the vendor's own and are passed through unchanged.
- [LinkedIn search posts](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/linkedin/search-posts): A list under posts, one row per item. The response also carries success, credits_remaining, credits_charged, query, cursor. Pass back as cursor for the next page. Fields are the vendor's own and are passed through unchanged.
- [Pinterest pin](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/pinterest/pin): One object. Fields are the vendor's own and are passed through unchanged.
- [Pinterest search](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/pinterest/search-pins): A list under pins, one row per item. The response also carries success, credits_remaining, credits_charged, cursor. Pass back as cursor for the next page. Fields are the vendor's own and are passed through unchanged.
- [Pinterest board](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/pinterest/board): One object. Fields are the vendor's own and are passed through unchanged.
- [Bluesky post](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/bluesky/post): One object. Fields are the vendor's own and are passed through unchanged.
- [Bluesky posts](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/bluesky/user-posts): A list under feed, one row per item. The response also carries success, credits_remaining, credits_charged, cursor. Returned by the vendor. This route takes no cursor option, so only the first page is reachable. Fields are the vendor's own and are passed through unchanged.
- [Truth Social post](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/truthsocial/post): One object. Fields are the vendor's own and are passed through unchanged.
- [Truth Social user posts](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/truthsocial/user-posts): A list under posts, one row per item. The response also carries success, credits_remaining, credits_charged, next_max_id. Pass back as next_max_id for the next page. Fields are the vendor's own and are passed through unchanged.

## 1. Choose this provider when

Reddit search, subreddit posts, and post comments.

Threads posts, a user's posts, and post search.

Public Facebook posts, page and group posts, reels, comments, and replies.

Public Instagram posts, a user's posts and reels, comments, reel search, and hashtag posts.

TikTok videos, a user's videos, comments, replies, and keyword search.

X posts, a user's posts, and community posts.

YouTube videos, channel videos, comments, replies, community posts, and search.

LinkedIn company posts, single posts, and post search.

Pinterest pins, boards, and pin search.

Bluesky posts and a user's posts.

Truth Social posts and a user's posts.

## 2. Minimal request

Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls.

```json
{
  "provider": "scrapecreators",
  "capability": "reddit/search-posts",
  "options": {
    "query": "<query>"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `query` (string, required): Search query. Example: `<query>`
- `sort` (string): Prefer relevance when you want posts matching the query. One of: relevance | new | top | comment_count. sort=new is chronological newest-first and often returns weakly related or unrelated sitewide posts (not "recent posts about X"). Brand/token queries may also match colloquial substrings under new. Comment search supports relevance, new, and top; comment_count is for post search only. Example: `relevance`
- `filter` (string): Search posts or comments. Default posts. Example: `posts`
- `timeframe` (string): Post search timeframe. One of: all | day | week | month | year. Example: `all`
- `after` (string): Pagination token from the previous response (after) to get the next page. Example: `<after>`
- `trim` (boolean): Set to true for a trimmed down version of the response. Example: `false`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "scrapecreators",
    capability: "reddit/search-posts",
    options: {
      query: "<query>",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "scrapecreators",
  "capability": "reddit/search-posts",
  "options": {
    "query": "<query>"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "scrapecreators",
    "capability": "reddit/search-posts",
    "options": {
      "query": "<query>"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'scrapecreators/reddit/search-posts' \
  --options '{"query":"<query>"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "scrapecreators",
  "capability": "reddit/search-posts",
  "options": {
    "query": "<query>"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "scrapecreators",
  "capability": "reddit/search-posts",
  "options": {
    "query": "<query>"
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "posts": [
    {
      "id": "<id>",
      "author": "<author>",
      "author_fullname": "<author_fullname>",
      "subreddit": "<subreddit>",
      "title": "<title>",
      "downs": 0,
      "name": "<name>",
      "upvote_ratio": 0,
      "ups": 0,
      "total_awards_received": 0,
      "score": 0,
      "created": 0,
      "num_comments": 0,
      "url": "<url>",
      "is_video": false,
      "created_utc": 0
    }
  ]
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Reddit search

- Capability: `reddit/search-posts`
- Description: A list under posts, one row per item. The response also carries success, credits_remaining, credits_charged, after. Pass back as after for the next page. Fields are the vendor's own and are passed through unchanged.
- Instructions: Searches across all of Reddit for posts or comments matching a query. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [Reddit search](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/reddit/search-posts)

Accepted options:
- `query` (string, required): Search query. Example: `<query>`
- `sort` (string): Prefer relevance when you want posts matching the query. One of: relevance | new | top | comment_count. sort=new is chronological newest-first and often returns weakly related or unrelated sitewide posts (not "recent posts about X"). Brand/token queries may also match colloquial substrings under new. Comment search supports relevance, new, and top; comment_count is for post search only. Example: `relevance`
- `filter` (string): Search posts or comments. Default posts. Example: `posts`
- `timeframe` (string): Post search timeframe. One of: all | day | week | month | year. Example: `all`
- `after` (string): Pagination token from the previous response (after) to get the next page. Example: `<after>`
- `trim` (boolean): Set to true for a trimmed down version of the response. Example: `false`

Response schema example:
```json
{
  "posts": [
    {
      "id": "<id>",
      "author": "<author>",
      "author_fullname": "<author_fullname>",
      "subreddit": "<subreddit>",
      "title": "<title>",
      "downs": 0,
      "name": "<name>",
      "upvote_ratio": 0,
      "ups": 0,
      "total_awards_received": 0,
      "score": 0,
      "created": 0,
      "num_comments": 0,
      "url": "<url>",
      "is_video": false,
      "created_utc": 0
    }
  ]
}
```

### Reddit subreddit posts

- Capability: `reddit/subreddit-posts`
- Description: A list under posts, one row per item. The response also carries success, credits_remaining, credits_charged, after. Pass back as after for the next page. Fields are the vendor's own and are passed through unchanged.
- Instructions: Fetches posts from a subreddit with sorting and filtering options. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [Reddit subreddit posts](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/reddit/subreddit-posts)

Accepted options:
- `subreddit` (string, required): Subreddit name. Example: `<subreddit>`
- `sort` (string): Sort order. Example: `best`
- `timeframe` (string): Timeframe to get posts from. Example: `all`
- `trim` (boolean): Set to true for a trimmed down version of the response. Example: `false`
- `after` (string): After to get more posts. Get 'after' from previous response. Example: `<after>`

Response schema example:
```json
{
  "posts": [
    {
      "id": "<id>",
      "author": "<author>",
      "author_fullname": "<author_fullname>",
      "subreddit": "<subreddit>",
      "title": "<title>",
      "link_flair_text": "<link_flair_text>",
      "selftext": "<selftext>",
      "selftext_html": "<selftext_html>",
      "downs": 0,
      "name": "<name>",
      "upvote_ratio": 0,
      "ups": 0,
      "total_awards_received": 0,
      "score": 0,
      "created": 0,
      "num_comments": 0,
      "url": "<url>",
      "subreddit_subscribers": 0,
      "is_video": false,
      "created_utc": 0
    }
  ]
}
```

### Reddit post comments

- Capability: `reddit/post-comments`
- Description: A list under comments, one row per item. The response also carries success, credits_remaining, credits_charged, post, more. Fields are the vendor's own and are passed through unchanged.
- Instructions: Retrieves comments and post details from a Reddit post by URL. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [Reddit post comments](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/reddit/post-comments)

Accepted options:
- `url` (string, required): Reddit post URL. Example: `<url>`
- `cursor` (string): One opaque cursor returned by the previous response to get more comments or replies. Do not combine multiple cursors. Example: `<cursor>`
- `trim` (boolean): Set to true for a trimmed down version of the response. Example: `false`

Response schema example:
```json
{
  "comments": [
    {
      "id": "<id>",
      "author": "<author>",
      "author_fullname": "<author_fullname>",
      "body": "<body>",
      "name": "<name>",
      "created_utc": 0,
      "created_at_iso": "<created_at_iso>",
      "parent_id": "<parent_id>",
      "url": "<url>",
      "replies": {},
      "ups": 0,
      "downs": 0,
      "score": 0
    }
  ]
}
```

### Threads post

- Capability: `threads/post`
- Description: One object. Fields are the vendor's own and are passed through unchanged.
- Instructions: Fetches a single Threads post by URL, returning the post's caption, like_count, view_counts, reshare_count, direct_reply_count, image_versions2, text_post_app_info, and taken_at. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [Threads post](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/threads/post)

Accepted options:
- `url` (string, required): The URL of the post to get. Example: `<url>`
- `trim` (boolean): Set to true for a trimmed down version of the response. Example: `false`
- `cache_max_age` (string): If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "cached_at" timestamp). Otherwise, scrape a live result (1 credit). See the Caching page for details. Example: `1d`

Response schema example:
```json
{
  "success": false,
  "credits_remaining": 0,
  "credits_charged": 0,
  "post": {},
  "comments": [],
  "threadItems": [],
  "relatedPosts": []
}
```

### Threads posts

- Capability: `threads/user-posts`
- Description: A list under posts, one row per item. The response also carries success, credits_remaining, credits_charged. Fields are the vendor's own and are passed through unchanged.
- Instructions: Fetches the most recent posts from a Threads user, returning id, caption text, code, like_count, reshare_count, direct_reply_count, repost_count, image_versions2, video_versions, and taken_at. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [Threads posts](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/threads/user-posts)

Accepted options:
- `handle` (string, required): Threads username. Example: `<handle>`
- `trim` (boolean): Set to true for a trimmed down version of the response. Example: `false`

Response schema example:
```json
{
  "posts": [
    {
      "id": "<id>",
      "pk": "<pk>",
      "caption": {},
      "code": "<code>",
      "like_count": 0,
      "taken_at": 0,
      "user": {},
      "url": "<url>"
    }
  ]
}
```

### Threads search by keyword

- Capability: `threads/search-posts`
- Description: A list under posts, one row per item. The response also carries success, credits_remaining, credits_charged. Fields are the vendor's own and are passed through unchanged.
- Instructions: Searches Threads for posts matching a keyword, returning up to 10 results with caption text, like_count, reshare_count, direct_reply_count, user info, and image_versions2. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [Threads search by keyword](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/threads/search-posts)

Accepted options:
- `query` (string, required): Keyword to search for. Example: `<query>`
- `trim` (boolean): Set to true for a trimmed down version of the response. Example: `false`

Response schema example:
```json
{
  "posts": [
    {
      "id": "<id>",
      "pk": "<pk>",
      "caption": {},
      "code": "<code>",
      "like_count": 0,
      "taken_at": 0,
      "user": {}
    }
  ]
}
```

### Facebook group posts

- Capability: `facebook/group-posts`
- Description: A list under posts, one row per item. The response also carries success, credits_remaining, credits_charged, cursor. Pass back as cursor for the next page. Fields are the vendor's own and are passed through unchanged.
- Instructions: Fetches posts from a public Facebook group, limited to 3 posts per page due to API limitations. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [Facebook group posts](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/facebook/group-posts)

Accepted options:
- `url` (string): The URL of the group. Example: `<url>`
- `group_id` (string): The ID of the group. Example: `<group_id>`
- `sort_by` (string): How to sort the posts. Defaults to CHRONOLOGICAL. Example: `TOP_POSTS`
- `cursor` (string): The cursor to paginate to the next page. Example: `<cursor>`

Response schema example:
```json
{
  "posts": [
    {
      "id": "<id>",
      "shared_post_id": "<shared_post_id>",
      "shared_post_url": "<shared_post_url>",
      "url": "<url>",
      "permalink": "<permalink>",
      "author": {},
      "reactionCount": 0,
      "commentCount": 0,
      "publishTime": 0,
      "videoDetails": {},
      "topComments": []
    }
  ]
}
```

### Facebook post

- Capability: `facebook/post`
- Description: One object. Fields are the vendor's own and are passed through unchanged.
- Instructions: Retrieves a single public Facebook post or reel by URL. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [Facebook post](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/facebook/post)

Accepted options:
- `url` (string, required): The URL of the post to get. Example: `<url>`
- `cache_max_age` (string): If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "cached_at" timestamp). Otherwise, scrape a live result (1 credit; default short AI is included; allow_long_transcription=true adds 10 credits per started minute to the existing base cost). See the Caching page for details. Example: `1d`

Response schema example:
```json
{
  "success": false,
  "credits_remaining": 0,
  "credits_charged": 0,
  "post_id": "<post_id>",
  "shared_post_id": "<shared_post_id>",
  "shared_post_url": "<shared_post_url>",
  "like_count": 0,
  "comment_count": 0,
  "share_count": 0,
  "view_count": 0,
  "description": "<description>",
  "creation_time": "<creation_time>",
  "feedback_id": "<feedback_id>",
  "url": "<url>"
}
```

### Facebook comments

- Capability: `facebook/post-comments`
- Description: A list under comments, one row per item. The response also carries success, credits_remaining, credits_charged, cursor, has_next_page. Pass back as cursor for the next page. Fields are the vendor's own and are passed through unchanged.
- Instructions: Fetches comments from a Facebook post or reel with cursor-based pagination. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [Facebook comments](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/facebook/post-comments)

Accepted options:
- `url` (string): Facebook post URL (or reel URL). Example: `<url>`
- `feedback_id` (string): Using feedback_id (instead of url) will *really* speed up the request. You can get the feedback_id when you make a request to /v1/facebook/post. Example: `<feedback_id>`
- `cursor` (string): Cursor from the previous response to get more comments. Keep the same sort on every cursor page. Example: `<cursor>`
- `sort` (string): Defaults to most_relevant, which can filter comments. Set sort=all to request Facebook's unfiltered view; this does not guarantee every counted comment is available. Example: `most_relevant`

Response schema example:
```json
{
  "comments": [
    {
      "id": "<id>",
      "text": "<text>",
      "created_at": "<created_at>",
      "reply_count": 0,
      "reaction_count": 0,
      "reactions": {},
      "author": {},
      "feedback_id": "<feedback_id>",
      "expansion_token": "<expansion_token>"
    }
  ]
}
```

### Facebook comment replies

- Capability: `facebook/comment-replies`
- Description: A list under replies, one row per item. The response also carries success, credits_remaining, credits_charged, cursor, has_next_page. Pass back as cursor for the next page. Fields are the vendor's own and are passed through unchanged.
- Instructions: Get the replies to a comment with cursor-based pagination. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [Facebook comment replies](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/facebook/comment-replies)

Accepted options:
- `feedback_id` (string, required): The *feedback_id* of the comment. Be careful, this is not the comment id. You can get the feedback_id from the /v1/facebook/post/comments endpoint. Example: `<feedback_id>`
- `expansion_token` (string, required): Pass the comment's complete, fresh expansion_token from /v1/facebook/post/comments with sort=all for unfiltered replies. Do not reuse a token from the Most relevant view. Example: `<expansion_token>`
- `cursor` (string): The cursor to paginate to the next page. Example: `<cursor>`

Response schema example:
```json
{
  "replies": [
    {
      "id": "<id>",
      "text": "<text>",
      "created_at": "<created_at>",
      "reply_count": 0,
      "reaction_count": 0,
      "reactions": {},
      "author": {},
      "feedback_id": "<feedback_id>",
      "expansion_token": "<expansion_token>"
    }
  ]
}
```

### Facebook profile posts

- Capability: `facebook/profile-posts`
- Description: A list under posts, one row per item. The response also carries success, credits_remaining, credits_charged, cursor. Pass back as cursor for the next page. Fields are the vendor's own and are passed through unchanged.
- Instructions: Returns publicly visible Facebook profile posts, limited to 3 posts per page due to API limitations. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [Facebook profile posts](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/facebook/profile-posts)

Accepted options:
- `url` (string): Facebook profile URL. Example: `<url>`
- `pageId` (string): Facebook profile page id. Example: `<pageId>`
- `cursor` (string): To paginate through the posts. Example: `<cursor>`

Response schema example:
```json
{
  "posts": [
    {
      "id": "<id>",
      "text": "<text>",
      "url": "<url>",
      "permalink": "<permalink>",
      "author": {},
      "videoDetails": {},
      "reactionCount": 0,
      "commentCount": 0,
      "publishTime": 0,
      "topComments": []
    }
  ]
}
```

### Facebook profile reels

- Capability: `facebook/profile-reels`
- Description: A list under reels, one row per item. The response also carries success, credits_remaining, credits_charged, cursor, next_page_id. Pass back as cursor for the next page. Fields are the vendor's own and are passed through unchanged.
- Instructions: Fetches up to 10 reels per request from a public Facebook page. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [Facebook profile reels](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/facebook/profile-reels)

Accepted options:
- `url` (string, required): Facebook page URL. Example: `<url>`
- `next_page_id` (string): To paginate through to the next page. Example: `<next_page_id>`
- `cursor` (string): To paginate through to the next page. Example: `<cursor>`

Response schema example:
```json
{
  "reels": [
    {
      "id": "<id>",
      "post_id": "<post_id>",
      "creation_time": "<creation_time>",
      "url": "<url>",
      "view_count": 0,
      "feedback_id": "<feedback_id>",
      "description": "<description>",
      "video_id": "<video_id>",
      "thumbnail": "<thumbnail>",
      "play_time_in_ms": 0,
      "video_url": "<video_url>",
      "music": {},
      "author": {}
    }
  ]
}
```

### Instagram post/reel info

- Capability: `instagram/post`
- Description: One object. Fields are the vendor's own and are passed through unchanged.
- Instructions: Fetches detailed metadata for a single Instagram post or reel by shortcode or URL. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [Instagram post/reel info](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/instagram/post)

Accepted options:
- `url` (string, required): Instagram post or reel URL. Example: `<url>`
- `region` (string): 2 letter country code to set the proxy in. Example: `<region>`
- `trim` (boolean): Set to true to get a trimmed response. Example: `false`
- `cache_max_age` (string): If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "cached_at" timestamp). Otherwise, scrape a live result (1 credit). See the Caching page for details. Example: `1d`
- `include_play_count` (boolean): Set to false to omit `video_play_count` and skip its additional fetch for a faster response. Defaults to true. Example: `false`

Response schema example:
```json
{
  "success": false,
  "credits_remaining": 0,
  "credits_charged": 0,
  "data": {}
}
```

### Instagram posts

- Capability: `instagram/user-posts`
- Description: A list under items, one row per item. The response also carries success, credits_remaining, credits_charged, next_max_id, num_results, more_available, user. Pass back as next_max_id for the next page. Fields are the vendor's own and are passed through unchanged.
- Instructions: Returns a paginated feed of a user's public Instagram posts, including reels, photos, videos, and carousels. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [Instagram posts](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/instagram/user-posts)

Accepted options:
- `handle` (string, required): Instagram handle. Example: `<handle>`
- `next_max_id` (string): Cursor to get next page of results. Example: `<next_max_id>`
- `trim` (boolean): Set to true to get a trimmed response. Example: `false`

Response schema example:
```json
{
  "items": [
    {
      "id": "<id>",
      "code": "<code>",
      "media_type": 0,
      "taken_at": 0,
      "caption": {},
      "play_count": 0,
      "ig_play_count": 0,
      "comment_count": 0,
      "like_count": 0,
      "display_uri": "<display_uri>",
      "user": {},
      "owner": {},
      "image_versions2": {},
      "product_type": "<product_type>",
      "is_paid_partnership": false,
      "video_sticker_locales": [],
      "video_versions": [],
      "video_duration": 0,
      "has_audio": false,
      "url": "<url>"
    }
  ]
}
```

### Instagram comments

- Capability: `instagram/post-comments`
- Description: A list under comments, one row per item. The response also carries success, credits_remaining, credits_charged, cursor. Pass back as cursor for the next page. Fields are the vendor's own and are passed through unchanged.
- Instructions: Retrieves comments on a public Instagram post or reel. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [Instagram comments](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/instagram/post-comments)

Accepted options:
- `url` (string, required): The URL of the post or reel to get comments from. Example: `<url>`
- `cursor` (string): The cursor to get more comments. Get 'cursor' from previous response. Example: `<cursor>`

Response schema example:
```json
{
  "comments": [
    {
      "id": "<id>",
      "text": "<text>",
      "created_at": "<created_at>",
      "comment_like_count": 0,
      "child_comment_count": 0,
      "replies": [],
      "has_more_replies": false,
      "user": {}
    }
  ]
}
```

### Instagram reels

- Capability: `instagram/user-reels`
- Description: A list under items, one row per item. The response also carries success, credits_remaining, credits_charged, max_id. Pass back as max_id for the next page. Fields are the vendor's own and are passed through unchanged.
- Instructions: Returns a paginated list of a user's public Instagram reels (short-form videos). 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [Instagram reels](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/instagram/user-reels)

Accepted options:
- `user_id` (string): Instagram user id. Use this for faster response times. Example: `<user_id>`
- `handle` (string): Instagram handle. Use user_id for faster response times. Example: `<handle>`
- `max_id` (string): Max id to get more reels. Get 'max_id' from previous response. Example: `<max_id>`
- `trim` (boolean): Set to true for a trimmed down version of the response. Example: `false`

Response schema example:
```json
{
  "items": [
    {
      "id": "<id>",
      "code": "<code>",
      "taken_at": 0,
      "created_at": "<created_at>",
      "caption": {},
      "play_count": 0,
      "ig_play_count": 0,
      "comment_count": 0,
      "like_count": 0,
      "display_uri": "<display_uri>",
      "user": {},
      "owner": {},
      "image_versions2": {},
      "url": "<url>"
    }
  ]
}
```

### Instagram search reels

- Capability: `instagram/search-reels`
- Description: A list under reels, one row per item. The response also carries success, credits_remaining, credits_charged. Fields are the vendor's own and are passed through unchanged.
- Instructions: Use this when you only want Google-indexed Instagram reels matching a keyword or phrase, with optional date filters and pagination. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [Instagram search reels](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/instagram/search-reels)

Accepted options:
- `query` (string, required): The keyword to search for. Example: `<query>`
- `date_posted` (string): Google-indexed date window (last-week, last-month, last-year). Hour/day windows are not supported; Google does not index Instagram reels reliably enough in those windows. Example: `last-week`
- `page` (number): The page number to return. Must be between 1 and 11; page 12 or greater returns a 400 response. Example: `10`

Response schema example:
```json
{
  "reels": [
    {
      "id": "<id>",
      "__typename": "<__typename>",
      "shortcode": "<shortcode>",
      "url": "<url>",
      "caption": "<caption>",
      "thumbnail_src": "<thumbnail_src>",
      "display_url": "<display_url>",
      "video_url": "<video_url>",
      "has_audio": false,
      "accessibility_caption": "<accessibility_caption>",
      "product_type": "<product_type>",
      "video_duration": 0,
      "clips_music_attribution_info": {},
      "is_video": false,
      "owner": {},
      "taken_at": "<taken_at>",
      "is_ad": false,
      "like_count": 0,
      "is_affiliate": false,
      "is_paid_partnership": false
    }
  ]
}
```

### Instagram search hashtag posts

- Capability: `instagram/hashtag-posts`
- Description: A list under posts, one row per item. The response also carries success, credits_remaining, credits_charged, hashtag, media_type, cursor. Pass back as cursor for the next page. Fields are the vendor's own and are passed through unchanged.
- Instructions: Use this when you know the exact hashtag and want Google-indexed public Instagram posts or reels, optional date filters, and pagination. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [Instagram search hashtag posts](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/instagram/hashtag-posts)

Accepted options:
- `hashtag` (string, required): The hashtag to search for. Include or omit the #. Example: `<hashtag>`
- `date_posted` (string): Only return Google-indexed posts found in this relative window. Example: `last-hour`
- `media_type` (string): Use all to search public posts and reels, or reels to only return reels. Defaults to all. Example: `all`
- `cursor` (string): The cursor returned by the previous response. It is the next Google results page number and cannot exceed 11; cursor 12 or greater returns a 400 response. Example: `<cursor>`

Response schema example:
```json
{
  "posts": [
    {
      "id": "<id>",
      "__typename": "<__typename>",
      "shortcode": "<shortcode>",
      "url": "<url>",
      "caption": "<caption>",
      "thumbnail_src": "<thumbnail_src>",
      "display_url": "<display_url>",
      "video_url": "<video_url>",
      "has_audio": false,
      "accessibility_caption": "<accessibility_caption>",
      "product_type": "<product_type>",
      "video_duration": 0,
      "clips_music_attribution_info": {},
      "is_video": false,
      "owner": {},
      "taken_at": "<taken_at>",
      "is_ad": false,
      "like_count": 0,
      "is_affiliate": false,
      "is_paid_partnership": false
    }
  ]
}
```

### TikTok video info

- Capability: `tiktok/video`
- Description: One object. Fields are the vendor's own and are passed through unchanged.
- Instructions: Fetches detailed data for a single TikTok video by URL, including its metadata, engagement stats, and optionally its transcript/captions. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [TikTok video info](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/tiktok/video)

Accepted options:
- `url` (string, required): TikTok video or photo/slideshow URL. Example: `<url>`
- `region` (string): Two-letter country code passed to the primary post source. Defaults to US. Try the creator's country if a post is unavailable. This does not guarantee a matching browser/proxy country or complete retrieval; the fallback source does not receive this parameter. Example: `<region>`
- `trim` (boolean): Set to true to get a trimmed response. Example: `false`

Response schema example:
```json
{
  "success": false,
  "credits_remaining": 0,
  "credits_charged": 0,
  "aweme_detail": {},
  "transcript": "<transcript>"
}
```

### TikTok profile videos

- Capability: `tiktok/user-videos`
- Description: One object. Fields are the vendor's own and are passed through unchanged.
- Instructions: Fetches videos posted by a TikTok user, sortable by latest or most popular — use this to get a creator's video feed or TikToks. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [TikTok profile videos](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/tiktok/user-videos)

Accepted options:
- `handle` (string, required): TikTok handle. Example: `<handle>`
- `user_id` (string): TikTok user id. Use this for faster responses. Example: `<user_id>`
- `sort_by` (string): What to sort by. Example: `latest`
- `max_cursor` (string): Cursor to get more videos. Get 'max_cursor' from previous response. Example: `<max_cursor>`
- `region` (string): Country code passed to the profile-feed source. Defaults to US. If a profile should have videos but returns none, try another relevant two-letter country code. Changing this value does not guarantee that region-restricted posts will appear. Example: `<region>`
- `trim` (boolean): Set to true for a trimmed down version of the response. Example: `false`

Response schema example:
```json
{
  "success": false,
  "credits_remaining": 0,
  "credits_charged": 0,
  "aweme_list": [],
  "max_cursor": 0
}
```

### TikTok comments

- Capability: `tiktok/video-comments`
- Description: A list under comments, one row per item. The response also carries success, credits_remaining, credits_charged, cursor, total. Pass back as cursor for the next page. Fields are the vendor's own and are passed through unchanged.
- Instructions: Fetches comments on a TikTok video by URL — useful for reading audience reactions, replies, and engagement. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [TikTok comments](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/tiktok/video-comments)

Accepted options:
- `url` (string, required): TikTok video URL. Example: `<url>`
- `cursor` (number): Cursor to get more comments. Get 'cursor' from previous response. Example: `10`
- `trim` (boolean): Set to true to get a trimmed response. Example: `false`

Response schema example:
```json
{
  "comments": [
    {
      "aweme_id": "<aweme_id>",
      "text": "<text>",
      "user": {},
      "create_time": 0,
      "reply_comment_total": 0,
      "digg_count": 0,
      "comment_language": "<comment_language>"
    }
  ]
}
```

### TikTok comment replies

- Capability: `tiktok/comment-replies`
- Description: A list under comments, one row per item. The response also carries success, credits_remaining, credits_charged, cursor, extra, has_more, log_pb, status_code, status_msg, total. Pass back as cursor for the next page. Fields are the vendor's own and are passed through unchanged.
- Instructions: Fetches replies to a specific TikTok comment by its ID. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [TikTok comment replies](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/tiktok/comment-replies)

Accepted options:
- `comment_id` (string, required): TikTok comment ID. This is the cid from the comments endpoint. Example: `<comment_id>`
- `url` (string, required): TikTok video URL. This is the url from the comments endpoint. Example: `<url>`
- `cursor` (number): Cursor to get more replies. Get 'cursor' from previous response. Example: `10`

Response schema example:
```json
{
  "comments": [
    {
      "aweme_id": "<aweme_id>",
      "cid": "<cid>",
      "collect_stat": 0,
      "comment_language": "<comment_language>",
      "comment_post_item_ids": [],
      "create_time": 0,
      "digg_count": 0,
      "fold_status": 0,
      "is_author_digged": false,
      "is_comment_translatable": false,
      "is_high_purchase_intent": false,
      "no_show": false,
      "reply_id": "<reply_id>",
      "reply_to_reply_id": "<reply_to_reply_id>",
      "share_info": {},
      "status": 0,
      "stick_position": 0,
      "text": "<text>",
      "text_extra": [],
      "thread_has_more": false
    }
  ]
}
```

### TikTok search by keyword

- Capability: `tiktok/search-videos`
- Description: A list under search_item_list, one row per item. The response also carries success, credits_remaining, credits_charged, cursor. Pass back as cursor for the next page. Fields are the vendor's own and are passed through unchanged.
- Instructions: Searches for TikTok videos by keyword or phrase — the general video search across all of TikTok. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [TikTok search by keyword](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/tiktok/search-videos)

Accepted options:
- `query` (string, required): Keyword to search for. Example: `<query>`
- `date_posted` (string): Requested publish window forwarded upstream. Not reliably enforced — responses can include create_time outside the window (or match an unscoped call). When recency matters, filter create_time locally. Example: `yesterday`
- `sort_by` (string): Requested order forwarded upstream. Not reliably enforced — most-liked / date-posted may leave digg_count or create_time unsorted. When order matters, sort locally. Example: `relevance`
- `region` (string): Note, this doesn't filter the tiktoks only in a specfic region, it puts the proxy there. Use it in case you want to scrape posts only available for some country. Use 2 letter country codes like US, GB, FR, etc. Example: `<region>`
- `cursor` (number): Cursor to get more videos. Get 'cursor' from previous response. Example: `10`
- `trim` (boolean): Set to true to get a trimmed response. Example: `false`

Response schema example:
```json
{
  "search_item_list": [
    {
      "aweme_id": "<aweme_id>",
      "desc": "<desc>",
      "desc_language": "<desc_language>",
      "region": "<region>",
      "statistics": {},
      "video": {},
      "author": {},
      "create_time": 0,
      "is_ad": false,
      "is_eligible_for_commission": false,
      "create_time_utc": "<create_time_utc>",
      "url": "<url>"
    }
  ]
}
```

### X user tweets

- Capability: `x/user-posts`
- Description: A list under tweets, one row per item. The response also carries success, credits_remaining, credits_charged. Fields are the vendor's own and are passed through unchanged.
- Instructions: Fetches tweets from a Twitter user's profile by handle. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [X user tweets](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/x/user-posts)

Accepted options:
- `handle` (string, required): Twitter handle. Example: `<handle>`
- `trim` (boolean): Set to true for a trimmed down version of the response. Example: `false`

Response schema example:
```json
{
  "tweets": [
    {
      "rest_id": "<rest_id>",
      "views": {},
      "source": "<source>",
      "legacy": {},
      "url": "<url>"
    }
  ]
}
```

### X tweet details

- Capability: `x/post`
- Description: One object. Fields are the vendor's own and are passed through unchanged.
- Instructions: Retrieves detailed information about a specific tweet by URL, including the author's profile and engagement metrics. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [X tweet details](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/x/post)

Accepted options:
- `url` (string, required): Tweet URL. Example: `<url>`
- `trim` (boolean): Set to true for a trimmed down version of the response. Example: `false`
- `cache_max_age` (string): If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "cached_at" timestamp). Otherwise, scrape a live result (1 credit). See the Caching page for details. Example: `1d`

Response schema example:
```json
{
  "success": false,
  "credits_remaining": 0,
  "credits_charged": 0,
  "rest_id": "<rest_id>",
  "views": {},
  "source": "<source>",
  "legacy": {}
}
```

### X community tweets

- Capability: `x/community-posts`
- Description: A list under tweets, one row per item. The response also carries success, credits_remaining, credits_charged. Fields are the vendor's own and are passed through unchanged.
- Instructions: Fetches tweets posted within a Twitter/X Community by URL. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [X community tweets](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/x/community-posts)

Accepted options:
- `url` (string, required): Community URL. Example: `<url>`

Response schema example:
```json
{
  "tweets": [
    {
      "id": "<id>",
      "source": "<source>",
      "view_count": "<view_count>",
      "bookmark_count": 0,
      "bookmarked": false,
      "created_at": "<created_at>",
      "conversation_id_str": "<conversation_id_str>",
      "display_text_range": [],
      "favorite_count": 0,
      "favorited": false,
      "full_text": "<full_text>",
      "is_quote_status": false,
      "lang": "<lang>",
      "possibly_sensitive": false,
      "possibly_sensitive_editable": false,
      "quote_count": 0,
      "reply_count": 0,
      "retweet_count": 0,
      "retweeted": false,
      "user_id_str": "<user_id_str>"
    }
  ]
}
```

### YouTube video/short details

- Capability: `youtube/video`
- Description: One object. Fields are the vendor's own and are passed through unchanged.
- Instructions: Fetches full details for a YouTube video or short, including title, description, thumbnail, view count (views), like count (likes), comment count, publish date, duration, genre, keywords, chapters, collaborators, and available caption. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [YouTube video/short details](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/youtube/video)

Accepted options:
- `url` (string, required): YouTube video or short URL. Example: `<url>`
- `language` (string): Preferred response language (mapped to Accept-Language header; not guaranteed due to YouTube localization behavior). 2 letter language code, ie 'en', 'es', 'fr' etc. Example: `<language>`

Response schema example:
```json
{
  "success": false,
  "credits_remaining": 0,
  "credits_charged": 0,
  "id": "<id>",
  "thumbnail": "<thumbnail>",
  "url": "<url>",
  "publishDate": "<publishDate>",
  "type": "<type>",
  "title": "<title>",
  "descriptionLinks": [],
  "commentCountText": "<commentCountText>",
  "commentCountInt": 0,
  "likeCountText": "<likeCountText>",
  "likeCountInt": 0
}
```

### YouTube channel videos

- Capability: `youtube/channel-videos`
- Description: A list under videos, one row per item. The response also carries success, credits_remaining, credits_charged, continuationToken. Pass back as continuationToken for the next page. Fields are the vendor's own and are passed through unchanged.
- Instructions: Fetches a paginated list of videos uploaded by a YouTube channel, including each video's title, URL, thumbnail, view count (views), publish date, duration, and description. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [YouTube channel videos](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/youtube/channel-videos)

Accepted options:
- `channelId` (string): YouTube channel ID. Example: `<channelId>`
- `handle` (string): YouTube channel handle. Example: `<handle>`
- `sort` (string): Sort by latest or popular. Example: `latest`
- `continuationToken` (string): Continuation token to get more videos. Get 'continuationToken' from previous response. Example: `<continuationToken>`
- `includeExtras` (string): This will get you the like + comment count and the description. To get the full details of the video, use the /v1/youtube/video endpoint. Honestly, if you use this param, the error rate is higher. We might deprecate this param in the future. Example: `<includeExtras>`

Response schema example:
```json
{
  "videos": [
    {
      "type": "<type>",
      "id": "<id>",
      "url": "<url>",
      "title": "<title>",
      "description": "<description>",
      "thumbnail": "<thumbnail>",
      "channel": {},
      "viewCountText": "<viewCountText>",
      "viewCountInt": 0,
      "publishedTimeText": "<publishedTimeText>",
      "publishedTime": "<publishedTime>",
      "lengthText": "<lengthText>",
      "lengthSeconds": 0,
      "badges": []
    }
  ]
}
```

### YouTube comments

- Capability: `youtube/video-comments`
- Description: A list under comments, one row per item. The response also carries success, credits_remaining, credits_charged, continuationToken. Pass back as continuationToken for the next page. Fields are the vendor's own and are passed through unchanged.
- Instructions: Fetches comments and replies from a YouTube video, including each comment's text content, author details, like count, reply count, and publish date. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [YouTube comments](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/youtube/video-comments)

Accepted options:
- `url` (string, required): YouTube video URL. Example: `<url>`
- `order` (string): Order of comments. Example: `top`
- `continuationToken` (string): Continuation token to get more comments. Get 'continuationToken' from previous response. Example: `<continuationToken>`

Response schema example:
```json
{
  "comments": [
    {
      "id": "<id>",
      "content": "<content>",
      "publishedTimeText": "<publishedTimeText>",
      "publishedTime": "<publishedTime>",
      "replyLevel": 0,
      "author": {},
      "engagement": {},
      "repliesContinuationToken": "<repliesContinuationToken>"
    }
  ]
}
```

### YouTube comment replies

- Capability: `youtube/comment-replies`
- Description: A list under comments, one row per item. The response also carries success, credits_remaining, credits_charged, continuationToken. Pass back as continuationToken for the next page. Fields are the vendor's own and are passed through unchanged.
- Instructions: Fetches replies to a specific comment on a YouTube video, including each reply's text content, author details (name, channel ID, avatar, verified/creator status), like count, and publish date. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [YouTube comment replies](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/youtube/comment-replies)

Accepted options:
- `continuationToken` (string, required): Continuation token for the comment replies. Use 'repliesContinuationToken' from the Comments endpoint, or 'continuationToken' from a previous replies response to paginate. Example: `<continuationToken>`

Response schema example:
```json
{
  "comments": [
    {
      "id": "<id>",
      "content": "<content>",
      "publishedTimeText": "<publishedTimeText>",
      "publishedTime": "<publishedTime>",
      "replyLevel": 0,
      "author": {},
      "engagement": {}
    }
  ]
}
```

### YouTube channel community posts

- Capability: `youtube/community-posts`
- Description: A list under posts, one row per item. The response also carries success, credits_remaining, credits_charged, continuationToken. Pass back as continuationToken for the next page. Fields are the vendor's own and are passed through unchanged.
- Instructions: Fetches community posts from a YouTube channel's Posts tab, including post ID, URL, content, images, attached video, like count, publish time, channel info, and a continuationToken when YouTube has more results. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [YouTube channel community posts](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/youtube/community-posts)

Accepted options:
- `channelId` (string): YouTube channel ID. Example: `<channelId>`
- `handle` (string): YouTube channel handle. Example: `<handle>`
- `continuationToken` (string): Continuation token to get more community posts. Get 'continuationToken' from previous response. Example: `<continuationToken>`

Response schema example:
```json
{
  "posts": [
    {
      "id": "<id>",
      "url": "<url>",
      "channel": {},
      "content": "<content>",
      "image": "<image>",
      "images": [],
      "likeCountText": "<likeCountText>",
      "likeCount": 0,
      "publishedTimeText": "<publishedTimeText>",
      "publishedTime": "<publishedTime>",
      "video": {}
    }
  ]
}
```

### YouTube community post details

- Capability: `youtube/community-post`
- Description: One object. Fields are the vendor's own and are passed through unchanged.
- Instructions: Retrieves the full details of a YouTube community post, including its text content, attached images, like count, publish date, and associated channel info. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [YouTube community post details](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/youtube/community-post)

Accepted options:
- `url` (string, required): The URL of the YouTube community post to get. Example: `<url>`

Response schema example:
```json
{
  "success": false,
  "credits_remaining": 0,
  "credits_charged": 0,
  "id": "<id>",
  "channel": {},
  "content": "<content>",
  "images": [],
  "likeCount": 0,
  "publishedTimeText": "<publishedTimeText>",
  "publishedTime": "<publishedTime>"
}
```

### YouTube search

- Capability: `youtube/search`
- Description: A list under videos, one row per item. The response also carries success, credits_remaining, credits_charged, channels, playlists, shorts, shelves, lives, continuationToken. Pass back as continuationToken for the next page. Fields are the vendor's own and are passed through unchanged.
- Instructions: Searches YouTube by keyword query and returns matching videos, channels, playlists, shorts, shelves, and live streams. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [YouTube search](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/youtube/search)

Accepted options:
- `query` (string, required): Search query. For stricter title matching, use YouTube's intitle: operator, for example intitle:"Foursquare Swarm". Quoted queries by themselves may still be broadened by YouTube when no fresh exact matches are available. Example: `<query>`
- `uploadDate` (string): Filter by upload date. One of: today | this_week | this_month | this_year. Example: `today`
- `sortBy` (string): Only relevance|popular work. view_count, upload_date, and rating are NOT accepted (HTTP 400). Example: `relevance`
- `type` (string): Type of content to search for. Plural forms: videos | shorts | channels | playlists (not video/channel). Example: `videos`
- `duration` (string): Duration of the video. Only applies to videos (not shorts). One of: under_3_min | between_3_and_20_min | over_20_min. Example: `under_3_min`
- `region` (string): 2 letter country code of the country to put the proxy in. Example: `<region>`
- `continuationToken` (string): Continuation token to get more videos. Get 'continuationToken' from previous response. Example: `<continuationToken>`
- `includeExtras` (string): This will get you the like + comment count and the description. To get the full details of the video, use the /v1/youtube/video endpoint. *This will slow down the response slightly.*. Example: `<includeExtras>`

Response schema example:
```json
{
  "videos": [
    {
      "type": "<type>",
      "id": "<id>",
      "url": "<url>",
      "title": "<title>",
      "thumbnail": "<thumbnail>",
      "channel": {},
      "viewCountText": "<viewCountText>",
      "viewCountInt": 0,
      "publishedTimeText": "<publishedTimeText>",
      "publishedTime": "<publishedTime>",
      "lengthText": "<lengthText>",
      "lengthSeconds": 0,
      "badges": []
    }
  ]
}
```

### LinkedIn company posts

- Capability: `linkedin/company-posts`
- Description: A list under posts, one row per item. The response also carries success, credits_remaining, credits_charged. Fields are the vendor's own and are passed through unchanged.
- Instructions: Retrieves paginated posts from a LinkedIn company or school page, including each post's URL, ID, publication date, and full text content. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [LinkedIn company posts](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/linkedin/company-posts)

Accepted options:
- `url` (string, required): The LinkedIn company (/company/) or school (/school/) page URL, for example https://www.linkedin.com/school/oxfordsbs/. Example: `<url>`
- `page` (number): The page number to get. Example: `10`

Response schema example:
```json
{
  "posts": [
    {
      "url": "<url>",
      "id": "<id>",
      "datePublished": "<datePublished>",
      "text": "<text>"
    }
  ]
}
```

### LinkedIn post

- Capability: `linkedin/post`
- Description: One object. Fields are the vendor's own and are passed through unchanged.
- Instructions: Fetches a single LinkedIn post or article, returning the title, headline, full description text, author info with follower count, publication date, like count (reactions), comment count, and individual comments. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [LinkedIn post](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/linkedin/post)

Accepted options:
- `url` (string, required): The URL of the LinkedIn post to get. Example: `<url>`

Response schema example:
```json
{
  "success": false,
  "credits_remaining": 0,
  "credits_charged": 0,
  "url": "<url>",
  "name": "<name>",
  "headline": "<headline>",
  "commentCount": 0,
  "likeCount": 0,
  "datePublished": "<datePublished>",
  "description": "<description>",
  "author": {},
  "comments": [],
  "moreArticles": []
}
```

### LinkedIn search posts

- Capability: `linkedin/search-posts`
- Description: A list under posts, one row per item. The response also carries success, credits_remaining, credits_charged, query, cursor. Pass back as cursor for the next page. Fields are the vendor's own and are passed through unchanged.
- Instructions: Finds public LinkedIn posts, feed updates, and Pulse articles by keyword using Google Search, then returns post details such as description, author, media, images, like count, comment count, and published date when LinkedIn exposes them. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [LinkedIn search posts](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/linkedin/search-posts)

Accepted options:
- `query` (string, required): Keyword or phrase to search for in public LinkedIn posts. Example: `<query>`
- `date_posted` (string): Google-indexed date window. One of: last-hour | last-day | last-week | last-month | last-year. Values like past-week / past-day are NOT accepted (provider rejects them). Example: `last-hour`
- `cursor` (string): The cursor returned from the previous response. The maximum cursor is 11; cursor 12 or greater returns a 400 response. Example: `<cursor>`

Response schema example:
```json
{
  "posts": [
    {
      "url": "<url>",
      "datePublished": "<datePublished>",
      "description": "<description>",
      "media": "<media>",
      "images": [],
      "image": "<image>",
      "author": {},
      "comments": [],
      "likeCount": 0,
      "commentCount": 0
    }
  ]
}
```

### Pinterest pin

- Capability: `pinterest/pin`
- Description: One object. Fields are the vendor's own and are passed through unchanged.
- Instructions: Fetches detailed information about a single Pinterest pin by URL, returning title, description, link, dominantColor, originPinner, pinner, images at multiple resolutions (imageSpec_236x through imageSpec_orig), and pinJoin with visual. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [Pinterest pin](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/pinterest/pin)

Accepted options:
- `url` (string, required): Pinterest pin URL. Example: `<url>`
- `trim` (boolean): Set to true for a trimmed down version of the response. Example: `false`
- `cache_max_age` (string): If we have a response in the cache that is this many days old or newer, return the cached response (0 credits, with "cached": true and a "cached_at" timestamp). Otherwise, scrape a live result (1 credit). See the Caching page for details. Example: `1d`

Response schema example:
```json
{
  "success": false,
  "credits_remaining": 0,
  "credits_charged": 0,
  "entityId": "<entityId>",
  "seoAltText": "<seoAltText>",
  "originPinner": {},
  "pinner": {},
  "imageSpec_orig": {},
  "description": "<description>",
  "shareCount": 0,
  "createdAt": "<createdAt>",
  "repinCount": 0,
  "totalReactionCount": 0
}
```

### Pinterest search

- Capability: `pinterest/search-pins`
- Description: A list under pins, one row per item. The response also carries success, credits_remaining, credits_charged, cursor. Pass back as cursor for the next page. Fields are the vendor's own and are passed through unchanged.
- Instructions: Searches Pinterest for pins matching a query, returning results with id, url, title, description, images, link, domain, board info, and pinner details. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [Pinterest search](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/pinterest/search-pins)

Accepted options:
- `query` (string, required): Search query. Example: `<query>`
- `cursor` (string): Cursor. Example: `<cursor>`
- `trim` (boolean): Set to true for a trimmed down version of the response. Example: `false`

Response schema example:
```json
{
  "pins": [
    {
      "id": "<id>",
      "url": "<url>",
      "description": "<description>",
      "created_at": "<created_at>",
      "pinner": {},
      "images": {}
    }
  ]
}
```

### Pinterest board

- Capability: `pinterest/board`
- Description: One object. Fields are the vendor's own and are passed through unchanged.
- Instructions: Fetches a paginated list of pins from a Pinterest board by URL, returning each pin's id, description, title, images, board info, pin_join annotations, and aggregated_pin_data. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [Pinterest board](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/pinterest/board)

Accepted options:
- `url` (string, required): The URL of the board to get. Example: `<url>`
- `cursor` (string): The cursor to get the next page of results. Example: `<cursor>`
- `trim` (boolean): Set to true for a trimmed down version of the response. Retains pins[].aggregated_pin_data.aggregated_stats.saves and pins[].pin_join.visual_annotation when Pinterest supplies them; these native save counts and keyword labels are not guaranteed for every pin. Only these nested leaves are retained, not the full aggregated_pin_data or pin_join objects. Example: `false`

Response schema example:
```json
{
  "success": false,
  "credits_remaining": 0,
  "credits_charged": 0,
  "pins": [],
  "cursor": "<cursor>"
}
```

### Bluesky post

- Capability: `bluesky/post`
- Description: One object. Fields are the vendor's own and are passed through unchanged.
- Instructions: Fetches a single Bluesky post by URL, returning the post's record text, author info, embed content, replyCount, repostCount, likeCount, and quoteCount. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [Bluesky post](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/bluesky/post)

Accepted options:
- `url` (string, required): Bluesky post URL. Example: `<url>`

Response schema example:
```json
{
  "success": false,
  "credits_remaining": 0,
  "credits_charged": 0,
  "post": {},
  "replies": []
}
```

### Bluesky posts

- Capability: `bluesky/user-posts`
- Description: A list under feed, one row per item. The response also carries success, credits_remaining, credits_charged, cursor. Returned by the vendor. This route takes no cursor option, so only the first page is reachable. Fields are the vendor's own and are passed through unchanged.
- Instructions: Fetches a paginated feed of posts from a Bluesky user, returning each post's uri, record text, author info, embed content, replyCount, repostCount, likeCount, quoteCount, and indexedAt. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [Bluesky posts](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/bluesky/user-posts)

Accepted options:
- `handle` (string): Bluesky handle. Example: `<handle>`
- `user_id` (string): Bluesky 'did'. (For some reason Bluesky calls their user ids, 'did' for whatever reason). Example: `<user_id>`

Response schema example:
```json
{
  "feed": [
    {
      "uri": "<uri>",
      "cid": "<cid>",
      "author": {},
      "record": {},
      "embed": {},
      "replyCount": 0,
      "repostCount": 0,
      "likeCount": 0,
      "quoteCount": 0,
      "indexedAt": "<indexedAt>",
      "labels": []
    }
  ]
}
```

### Truth Social post

- Capability: `truthsocial/post`
- Description: One object. Fields are the vendor's own and are passed through unchanged.
- Instructions: Fetches a single Truth Social post by URL, returning text, id, created_at, url, content, account details, media_attachments, card link previews, replies_count, reblogs_count, and favourites_count. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [Truth Social post](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/truthsocial/post)

Accepted options:
- `url` (string, required): Truth Social post URL. Example: `<url>`

Response schema example:
```json
{
  "success": false,
  "credits_remaining": 0,
  "credits_charged": 0,
  "text": "<text>",
  "id": "<id>",
  "created_at": "<created_at>",
  "in_reply_to_id": "<in_reply_to_id>",
  "quote_id": "<quote_id>",
  "in_reply_to_account_id": "<in_reply_to_account_id>",
  "sensitive": false,
  "spoiler_text": "<spoiler_text>",
  "visibility": "<visibility>",
  "language": "<language>",
  "uri": "<uri>"
}
```

### Truth Social user posts

- Capability: `truthsocial/user-posts`
- Description: A list under posts, one row per item. The response also carries success, credits_remaining, credits_charged, next_max_id. Pass back as next_max_id for the next page. Fields are the vendor's own and are passed through unchanged.
- Instructions: Fetches a paginated list of posts from a Truth Social user, returning text, id, created_at, url, content, account info, media_attachments, card link previews, replies_count, reblogs_count, and favourites_count. 2 Firecrawl credits when ScrapeCreators charges its 1 credit; a cache hit or an uncharged empty page costs nothing.
- Cost: 2 credits per ScrapeCreators credit
- Capability file: [Truth Social user posts](https://alexandria.firecrawl.dev/agents/providers/scrapecreators/truthsocial/user-posts)

Accepted options:
- `handle` (string): Truth Social username. Example: `<handle>`
- `user_id` (string): Truth Social user id. Use this for faster response times. Trumps is 107780257626128497. It is the 'id' field in the profile endpoint. Example: `<user_id>`
- `next_max_id` (string): Used to paginate to next page. Example: `<next_max_id>`
- `trim` (boolean): Set to true for a trimmed down version of the response. Example: `false`

Response schema example:
```json
{
  "posts": [
    {
      "id": "<id>",
      "text": "<text>",
      "created_at": "<created_at>",
      "language": "<language>",
      "url": "<url>",
      "replies_count": 0,
      "reblogs_count": 0,
      "favourites_count": 0,
      "upvotes_count": 0,
      "downvotes_count": 0,
      "media_attachments": []
    }
  ]
}
```