---
type: "firecrawl-provider"
description: "Public social profiles, posts, comments, search, and transcripts."
use_when: "Public Facebook profiles, posts, comments, events, marketplace, and ads.\n\nPublic Instagram profiles, posts, reels, comments, hashtags, and search.\n\nA work email from a LinkedIn profile URL, and the public LinkedIn ads library.\n\nPublic Reddit posts, comments, profiles, and subreddit search.\n\nPublic TikTok profiles, videos, comments, search, transcripts, and ads.\n\nPublic X profiles, posts, replies, search, and trends. Routes keep the twitter prefix."
categories: "Social"
capabilities: 38
pricing: "5–50 credits per billed unit; see each capability for its unit and maximum."
---
# AnyAPI on Firecrawl Alexandria

Public social profiles, posts, comments, search, and transcripts.

- Categories: Social
- Category index: [Social category](https://alexandria.firecrawl.dev/agents/categories/social)
- Provider key: `anyapi`
- Access: Firecrawl credits
- Cost (Facebook Ad Details): 5 credits per call
- Cost (Facebook Ad Transcript): 5 credits per call
- Cost (Facebook Event Details): 5 credits per call
- Cost (Facebook Events Search): 5 credits per call
- Cost (Facebook Marketplace): 5 credits per call
- Cost (Facebook Marketplace Item): 5 credits per call
- Cost (Facebook Marketplace Location Search): 5 credits per call
- Cost (Facebook Page Contact Info): 5 credits per call
- Cost (Facebook Post Transcript): 5 credits per call
- Cost (Facebook Profile): 5 credits per call
- Cost (Facebook Page Search): 50 credits per call
- Cost (Facebook Post Search): 30 credits per call
- Cost (Instagram Hashtag Recent Posts): 5 credits per call
- Cost (Instagram Location Posts): 5 credits per call
- Cost (Instagram Media Transcript): 5 credits per call
- Cost (Instagram Post Likers): 5 credits per call
- Cost (Instagram Profile Contact Info): 5 credits per call
- Cost (Instagram Search): 5 credits per call
- Cost (Instagram Tagged Posts): 5 credits per call
- Cost (LinkedIn Ad Details): 5 credits per call
- Cost (LinkedIn Email Finder): 5 credits per call
- Cost (Reddit Profile): 5 credits per call
- Cost (Reddit Subreddit Search): 5 credits per call
- Cost (Reddit User Comments): 5 credits per call
- Cost (Reddit User Posts): 5 credits per call
- Cost (TikTok Ad Library Search): 5 credits per call
- Cost (TikTok Followers): 5 credits per call
- Cost (TikTok Following): 5 credits per call
- Cost (TikTok Profile Contact Info): 5 credits per call
- Cost (TikTok Top Ads Search): 5 credits per call
- Cost (TikTok Trending Hashtags): 5 credits per call
- Cost (X Followers): 5 credits per call
- Cost (X Following): 5 credits per call
- Cost (X Post Replies): 5 credits per call
- Cost (X Search): 5 credits per call
- Cost (X User Search): 5 credits per call
- Cost (X Tweet Thread): 5 credits per call
- Cost (Twitter Tweet Transcript): 5 credits per call

## More

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

## Capabilities

- [Facebook Ad Details](https://alexandria.firecrawl.dev/agents/providers/anyapi/facebook/ad-details): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [Facebook Ad Transcript](https://alexandria.firecrawl.dev/agents/providers/anyapi/facebook/ad-transcript): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [Facebook Event Details](https://alexandria.firecrawl.dev/agents/providers/anyapi/facebook/event-details): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [Facebook Events Search](https://alexandria.firecrawl.dev/agents/providers/anyapi/facebook/events-search): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [Facebook Marketplace](https://alexandria.firecrawl.dev/agents/providers/anyapi/facebook/marketplace): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [Facebook Marketplace Item](https://alexandria.firecrawl.dev/agents/providers/anyapi/facebook/marketplace-item): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [Facebook Marketplace Location Search](https://alexandria.firecrawl.dev/agents/providers/anyapi/facebook/marketplace-location-search): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [Facebook Page Contact Info](https://alexandria.firecrawl.dev/agents/providers/anyapi/facebook/page-contact): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [Facebook Post Transcript](https://alexandria.firecrawl.dev/agents/providers/anyapi/facebook/post-transcript): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [Facebook Profile](https://alexandria.firecrawl.dev/agents/providers/anyapi/facebook/profile): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [Facebook Page Search](https://alexandria.firecrawl.dev/agents/providers/anyapi/facebook/search-pages): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [Facebook Post Search](https://alexandria.firecrawl.dev/agents/providers/anyapi/facebook/search-posts): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [Instagram Hashtag Recent Posts](https://alexandria.firecrawl.dev/agents/providers/anyapi/instagram/hashtag-recent-posts): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [Instagram Location Posts](https://alexandria.firecrawl.dev/agents/providers/anyapi/instagram/location-posts): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [Instagram Media Transcript](https://alexandria.firecrawl.dev/agents/providers/anyapi/instagram/media-transcript): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [Instagram Post Likers](https://alexandria.firecrawl.dev/agents/providers/anyapi/instagram/post-likers): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [Instagram Profile Contact Info](https://alexandria.firecrawl.dev/agents/providers/anyapi/instagram/profile-contact): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [Instagram Search](https://alexandria.firecrawl.dev/agents/providers/anyapi/instagram/search): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [Instagram Tagged Posts](https://alexandria.firecrawl.dev/agents/providers/anyapi/instagram/tagged-posts): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [LinkedIn Ad Details](https://alexandria.firecrawl.dev/agents/providers/anyapi/linkedin/ad): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [LinkedIn Email Finder](https://alexandria.firecrawl.dev/agents/providers/anyapi/linkedin/email): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [Reddit Profile](https://alexandria.firecrawl.dev/agents/providers/anyapi/reddit/profile): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [Reddit Subreddit Search](https://alexandria.firecrawl.dev/agents/providers/anyapi/reddit/subreddit-search): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [Reddit User Comments](https://alexandria.firecrawl.dev/agents/providers/anyapi/reddit/user-comments): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [Reddit User Posts](https://alexandria.firecrawl.dev/agents/providers/anyapi/reddit/user-posts): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [TikTok Ad Library Search](https://alexandria.firecrawl.dev/agents/providers/anyapi/tiktok/ad-library-search): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [TikTok Followers](https://alexandria.firecrawl.dev/agents/providers/anyapi/tiktok/followers): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [TikTok Following](https://alexandria.firecrawl.dev/agents/providers/anyapi/tiktok/following): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [TikTok Profile Contact Info](https://alexandria.firecrawl.dev/agents/providers/anyapi/tiktok/profile-contact): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [TikTok Top Ads Search](https://alexandria.firecrawl.dev/agents/providers/anyapi/tiktok/top-ads-search): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [TikTok Trending Hashtags](https://alexandria.firecrawl.dev/agents/providers/anyapi/tiktok/trending-hashtags): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [X Followers](https://alexandria.firecrawl.dev/agents/providers/anyapi/twitter/followers): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [X Following](https://alexandria.firecrawl.dev/agents/providers/anyapi/twitter/following): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [X Post Replies](https://alexandria.firecrawl.dev/agents/providers/anyapi/twitter/replies): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [X Search](https://alexandria.firecrawl.dev/agents/providers/anyapi/twitter/search): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [X User Search](https://alexandria.firecrawl.dev/agents/providers/anyapi/twitter/search-users): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [X Tweet Thread](https://alexandria.firecrawl.dev/agents/providers/anyapi/twitter/thread): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- [Twitter Tweet Transcript](https://alexandria.firecrawl.dev/agents/providers/anyapi/twitter/tweet-transcript): costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.

## 1. Choose this provider when

Public Facebook profiles, posts, comments, events, marketplace, and ads.

Public Instagram profiles, posts, reels, comments, hashtags, and search.

A work email from a LinkedIn profile URL, and the public LinkedIn ads library.

Public Reddit posts, comments, profiles, and subreddit search.

Public TikTok profiles, videos, comments, search, transcripts, and ads.

Public X profiles, posts, replies, search, and trends. Routes keep the twitter prefix.

## 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": "anyapi",
  "capability": "facebook/ad-details",
  "options": {
    "id": "<id>"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `id` (string): Meta Ad Library ad ID (e.g. "702369045530963"). Provide either id or url. Example: `<id>`
- `url` (string): Meta Ad Library ad URL (e.g. "https://www.facebook.com/ads/library?id=1185617869915074"). Provide either id or url. Example: `<url>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "anyapi",
    capability: "facebook/ad-details",
    options: {
      id: "<id>",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "anyapi",
  "capability": "facebook/ad-details",
  "options": {
    "id": "<id>"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "anyapi",
    "capability": "facebook/ad-details",
    "options": {
      "id": "<id>"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'anyapi/facebook/ad-details' \
  --options '{"id":"<id>"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "anyapi",
  "capability": "facebook/ad-details",
  "options": {
    "id": "<id>"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "anyapi",
  "capability": "facebook/ad-details",
  "options": {
    "id": "<id>"
  }
}
```

## 6. Response data

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

```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

## API reference-derived contract

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

### Facebook Ad Details

- Capability: `facebook/ad-details`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Look up a single Meta Ad Library ad by ID or URL and get the advertiser, creative text, call-to-action, platforms, and run dates as clean JSON.
- Cost: 5 credits per call
- Capability file: [Facebook Ad Details](https://alexandria.firecrawl.dev/agents/providers/anyapi/facebook/ad-details)

Accepted options:
- `id` (string): Meta Ad Library ad ID (e.g. "702369045530963"). Provide either id or url. Example: `<id>`
- `url` (string): Meta Ad Library ad URL (e.g. "https://www.facebook.com/ads/library?id=1185617869915074"). Provide either id or url. Example: `<url>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### Facebook Ad Transcript

- Capability: `facebook/ad-transcript`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Get the spoken-word transcript of a Meta Ad Library video ad by ad ID or URL.
- Cost: 5 credits per call
- Capability file: [Facebook Ad Transcript](https://alexandria.firecrawl.dev/agents/providers/anyapi/facebook/ad-transcript)

Accepted options:
- `id` (string): Meta Ad Library ad ID (e.g. "1020359190509080"). Provide either id or url. Example: `<id>`
- `url` (string): Meta Ad Library ad URL (e.g. "https://www.facebook.com/ads/library?id=1020359190509080"). Provide either id or url. Example: `<url>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### Facebook Event Details

- Capability: `facebook/event-details`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Fetch full details for a single Facebook event by ID or URL (name, schedule, venue, hosts, and attendance) as normalized JSON.
- Cost: 5 credits per call
- Capability file: [Facebook Event Details](https://alexandria.firecrawl.dev/agents/providers/anyapi/facebook/event-details)

Accepted options:
- `id` (string): The event's numeric identifier. Example: `<id>`
- `url` (string): The event's Facebook URL. Example: `<url>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### Facebook Events Search

- Capability: `facebook/events-search`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Search public Facebook events by keyword and get structured event records (name, schedule, venue, pricing, and attendance) as normalized JSON.
- Cost: 5 credits per call
- Capability file: [Facebook Events Search](https://alexandria.firecrawl.dev/agents/providers/anyapi/facebook/events-search)

Accepted options:
- `cursor` (string): Pagination cursor from a previous response. Example: `<cursor>`
- `query` (string, required): The query to search events for. Example: `<query>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### Facebook Marketplace

- Capability: `facebook/marketplace`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Search Facebook Marketplace listings by keyword near a location, filter by price, condition, delivery, recency, and availability, and get title, price, location, and image as normalized JSON.
- Cost: 5 credits per call
- Capability file: [Facebook Marketplace](https://alexandria.firecrawl.dev/agents/providers/anyapi/facebook/marketplace)

Accepted options:
- `availability` (string): Filter by availability: available (default), sold, or all (e.g. sold). Example: `available`
- `condition` (string): Only return listings in this condition (e.g. used_good). Example: `new`
- `cursor` (string): Pagination cursor from a previous response to fetch the next page. Example: `<cursor>`
- `dateListed` (string): Only return listings posted within this window (e.g. last_7_days). Example: `all`
- `deliveryMethod` (string): Only return listings offering this delivery method (e.g. shipping). Example: `all`
- `lat` (string, required): Latitude of the search location (e.g. '30.2677'). Example: `<lat>`
- `lng` (string, required): Longitude of the search location (e.g. '-97.7475'). Example: `<lng>`
- `priceMax` (number): Maximum listing price in whole currency units, e.g. 500 for $500. Facebook may mix in a few suggested listings outside the range. Example: `10`
- `priceMin` (number): Minimum listing price in whole currency units, e.g. 100 for $100. Facebook may mix in a few suggested listings outside the range. Example: `10`
- `query` (string, required): Search keyword for Marketplace listings (e.g. 'bike'). Example: `<query>`
- `sort` (string): Sort order for the returned listings (e.g. price_ascend). Example: `suggested`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### Facebook Marketplace Item

- Capability: `facebook/marketplace-item`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Fetch full details for a single Facebook Marketplace listing by ID or URL (title, price, location, photos, and attributes) as normalized JSON.
- Cost: 5 credits per call
- Capability file: [Facebook Marketplace Item](https://alexandria.firecrawl.dev/agents/providers/anyapi/facebook/marketplace-item)

Accepted options:
- `id` (string): Facebook Marketplace item ID. Example: `<id>`
- `url` (string): Facebook Marketplace item URL. Example: `<url>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### Facebook Marketplace Location Search

- Capability: `facebook/marketplace-location-search`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Resolve a place name to Facebook Marketplace locations with coordinates and metadata as normalized JSON.
- Cost: 5 credits per call
- Capability file: [Facebook Marketplace Location Search](https://alexandria.firecrawl.dev/agents/providers/anyapi/facebook/marketplace-location-search)

Accepted options:
- `query` (string, required): Location search query (e.g. a city name). Example: `<query>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### Facebook Page Contact Info

- Capability: `facebook/page-contact`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Look up a Facebook Page's public contact details (email, phone, website, and address) by page URL or ID.
- Cost: 5 credits per call
- Capability file: [Facebook Page Contact Info](https://alexandria.firecrawl.dev/agents/providers/anyapi/facebook/page-contact)

Accepted options:
- `language` (string): Locale code for the returned data (e.g. en-US). Example: `en-US`
- `page` (string, required): Facebook Page URL or page ID to look up (e.g. https://www.facebook.com/nasa). A link to a post, video, photo or reels tab on a page is read as that page. Example: `<page>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### Facebook Post Transcript

- Capability: `facebook/post-transcript`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Get the spoken-word transcript of any public Facebook video post by URL as normalized JSON.
- Cost: 5 credits per call
- Capability file: [Facebook Post Transcript](https://alexandria.firecrawl.dev/agents/providers/anyapi/facebook/post-transcript)

Accepted options:
- `url` (string, required): The Facebook post or video URL. Example: `<url>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### Facebook Profile

- Capability: `facebook/profile`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Fetch a Facebook page's public profile (likes, followers, category, about) by URL or handle.
- Cost: 5 credits per call
- Capability file: [Facebook Profile](https://alexandria.firecrawl.dev/agents/providers/anyapi/facebook/profile)

Accepted options:
- `handle` (string): Facebook page handle/username. Example: `<handle>`
- `url` (string): Full Facebook page URL. profile.php without an id value names no page and is refused as invalid input, with no charge. Example: `<url>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### Facebook Page Search

- Capability: `facebook/search-pages`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Search Facebook Pages by keyword, optionally narrowed to a location, and get structured page profiles (name, category, followers, contact details).
- Cost: 50 credits per call
- Capability file: [Facebook Page Search](https://alexandria.firecrawl.dev/agents/providers/anyapi/facebook/search-pages)

Accepted options:
- `limit` (number): Maximum number of results to return (1-10, default 10). You are billed per result returned, so a lower limit costs less. Example: `10`
- `location` (string): Optional free-text location to narrow the search: a city, province, or country (e.g. 'Berlin'). Example: `<location>`
- `query` (string, required): Keyword to search Facebook Pages for (e.g. 'coffee roasters'). Example: `<query>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### Facebook Post Search

- Capability: `facebook/search-posts`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Search public Facebook posts by keyword, optionally filtered by location, and get structured post records (text, author, engagement).
- Cost: 30 credits per call
- Capability file: [Facebook Post Search](https://alexandria.firecrawl.dev/agents/providers/anyapi/facebook/search-posts)

Accepted options:
- `endDate` (string): Only return posts published on or before this date, format YYYY-MM-DD (e.g. 2024-12-31). Example: `<endDate>`
- `limit` (number): Maximum number of results to return (1-20, default 20). Example: `10`
- `location` (string): Optional place name; include both city and country for best matches (e.g. 'Paris, France'). Uses Facebook's place filter, which favors posts tagged at that place rather than every post by people who live there, and can still return some posts from elsewhere. Example: `<location>`
- `query` (string, required): Keyword or phrase to search Facebook posts for (e.g. 'product launch'). Example: `<query>`
- `startDate` (string): Only return posts published on or after this date, format YYYY-MM-DD (e.g. 2024-01-01). Example: `<startDate>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### Instagram Hashtag Recent Posts

- Capability: `instagram/hashtag-recent-posts`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Instagram posts published under a hashtag, newest first, read from its live chronological feed rather than a web search index. Built for monitoring: results arrive within a couple of minutes of posting, so engagement counts are usually still zero and reels do not appear (Instagram keeps those on a separate tab).
- Cost: 5 credits per call
- Capability file: [Instagram Hashtag Recent Posts](https://alexandria.firecrawl.dev/agents/providers/anyapi/instagram/hashtag-recent-posts)

Accepted options:
- `cursor` (string): Pagination cursor from a previous response's nextCursor. Example: `<cursor>`
- `hashtag` (string, required): Hashtag to monitor, without the leading #. Example: `<hashtag>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### Instagram Location Posts

- Capability: `instagram/location-posts`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: List public Instagram posts tagged at a location, ranked or most recent, with cursor pagination.
- Cost: 5 credits per call
- Capability file: [Instagram Location Posts](https://alexandria.firecrawl.dev/agents/providers/anyapi/instagram/location-posts)

Accepted options:
- `cursor` (string): Pagination cursor from a previous response's nextCursor. Example: `<cursor>`
- `locationId` (string, required): Instagram location id, as returned by instagram/search-locations. Example: `<locationId>`
- `sort` (string): Order the posts by Instagram's top ranking or by newest first. Defaults to ranked. Example: `ranked`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### Instagram Media Transcript

- Capability: `instagram/media-transcript`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Get the spoken-audio transcript text for an Instagram post or reel by URL.
- Cost: 5 credits per call
- Capability file: [Instagram Media Transcript](https://alexandria.firecrawl.dev/agents/providers/anyapi/instagram/media-transcript)

Accepted options:
- `url` (string, required): Instagram post or reel URL. Example: `<url>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### Instagram Post Likers

- Capability: `instagram/post-likers`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: List the accounts that liked a public Instagram post, one page of likers per call, with each liker's handle, display name, verified flag and avatar.
- Cost: 5 credits per call
- Capability file: [Instagram Post Likers](https://alexandria.firecrawl.dev/agents/providers/anyapi/instagram/post-likers)

Accepted options:
- `url` (string, required): Canonical URL of a public Instagram post or reel. Example: `<url>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### Instagram Profile Contact Info

- Capability: `instagram/profile-contact`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Look up the contact email and phone number an Instagram creator or business publishes on its profile, including the address behind the profile's Email button that public profile lookups do not return.
- Cost: 5 credits per call
- Capability file: [Instagram Profile Contact Info](https://alexandria.firecrawl.dev/agents/providers/anyapi/instagram/profile-contact)

Accepted options:
- `handle` (string, required): Instagram username without the leading @. Example: `<handle>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### Instagram Search

- Capability: `instagram/search`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Search Instagram for users or hashtags by keyword and get matching results with names, counts, and links. For places, use instagram/search-locations.
- Cost: 5 credits per call
- Capability file: [Instagram Search](https://alexandria.firecrawl.dev/agents/providers/anyapi/instagram/search)

Accepted options:
- `limit` (number): Maximum number of results to return (1-20, default 20). Example: `10`
- `query` (string, required): Keyword to search Instagram for; one or more words without special punctuation (e.g. coffee roastery). Example: `<query>`
- `type` (string): What to search for: user profiles or hashtags (e.g. hashtag). Places are not offered here: the upstream place mode returns no results; use instagram/search-locations. Example: `user`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### Instagram Tagged Posts

- Capability: `instagram/tagged-posts`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: List the posts an Instagram user is tagged in, with cursor pagination (author, caption, likes, comments).
- Cost: 5 credits per call
- Capability file: [Instagram Tagged Posts](https://alexandria.firecrawl.dev/agents/providers/anyapi/instagram/tagged-posts)

Accepted options:
- `cursor` (string): Pagination cursor from a previous response's nextCursor. Example: `<cursor>`
- `handle` (string, required): Instagram username without the leading @. Example: `<handle>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### LinkedIn Ad Details

- Capability: `linkedin/ad`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Look up a single LinkedIn Ad Library ad by URL and get the advertiser, headline, creative text, format, CTA, targeting, run dates, and impressions as clean JSON.
- Cost: 5 credits per call
- Capability file: [LinkedIn Ad Details](https://alexandria.firecrawl.dev/agents/providers/anyapi/linkedin/ad)

Accepted options:
- `url` (string, required): LinkedIn Ad Library ad URL (e.g. "https://www.linkedin.com/ad-library/detail/666281156"). Example: `<url>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### LinkedIn Email Finder

- Capability: `linkedin/email`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Find the deliverability-validated work email behind a LinkedIn profile URL or public ID. Returns each discovered email with its deliverability, validation status, and quality score, plus the person's name and headline.
- Cost: 5 credits per call
- Capability file: [LinkedIn Email Finder](https://alexandria.firecrawl.dev/agents/providers/anyapi/linkedin/email)

Accepted options:
- `profileUrl` (string, required): LinkedIn profile URL or public identifier (the last part of the URL) to find the deliverability-validated work email for. Example: `<profileUrl>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### Reddit Profile

- Capability: `reddit/profile`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Fetch a Reddit user's public profile (karma split, post and comment counts, bio, avatar, account age) by username.
- Cost: 5 credits per call
- Capability file: [Reddit Profile](https://alexandria.firecrawl.dev/agents/providers/anyapi/reddit/profile)

Accepted options:
- `username` (string, required): Reddit username, without the u/ prefix. Example: "spez". Example: `<username>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### Reddit Subreddit Search

- Capability: `reddit/subreddit-search`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Search posts within a single subreddit by query, sort, and timeframe.
- Cost: 5 credits per call
- Capability file: [Reddit Subreddit Search](https://alexandria.firecrawl.dev/agents/providers/anyapi/reddit/subreddit-search)

Accepted options:
- `cursor` (string): Optional pagination token from a previous response. Include nextCursor in requireFields on the first request to make sure a source that supports pagination serves it. Example: `<cursor>`
- `query` (string): Optional search query to match posts (e.g. 'push ups'). Example: `<query>`
- `sort` (string): Optional sort order: relevance, hot, top, new, comments. Example: `relevance`
- `subreddit` (string, required): Subreddit name without the r/ prefix (e.g. 'Fitness'). Example: `<subreddit>`
- `timeframe` (string): Optional time filter: all, year, month, week, day, hour. Example: `all`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### Reddit User Comments

- Capability: `reddit/user-comments`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: List a Reddit user's comments by username, sorted by new, top, hot, or controversial, with the parent post title and subreddit on every item and cursor pagination. Comment text may be truncated to a roughly 300-character preview, and this endpoint carries no per-comment permalink; use reddit.post_comments for full comment bodies and comment URLs on a given post.
- Cost: 5 credits per call
- Capability file: [Reddit User Comments](https://alexandria.firecrawl.dev/agents/providers/anyapi/reddit/user-comments)

Accepted options:
- `cursor` (string): Opaque pagination cursor from a previous response's nextCursor. Omit for the first page; pass it back to fetch the next page. Example: `<cursor>`
- `limit` (number): Page size to ask for (up to 100, default 25). Some sources honor it; others always return their whole page of about 25 comments. A page is never trimmed after the call, so pass nextCursor back as cursor to continue exactly where this response ended. Example: `25`
- `sort` (string): Sort order for the user's comments. Defaults to new (most recent first). Example: `new`
- `username` (string, required): Reddit username, without the u/ prefix. Example: "spez". Example: `<username>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### Reddit User Posts

- Capability: `reddit/user-posts`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: List a Reddit user's posts by username, sorted by new, top, hot, or controversial, with cursor pagination.
- Cost: 5 credits per call
- Capability file: [Reddit User Posts](https://alexandria.firecrawl.dev/agents/providers/anyapi/reddit/user-posts)

Accepted options:
- `cursor` (string): Opaque pagination cursor from a previous response's nextCursor. Omit for the first page; pass it back to fetch the next page. Example: `<cursor>`
- `sort` (string): Sort order for the user's posts. Defaults to new (most recent first). Example: `new`
- `username` (string, required): Reddit username without the leading u/ prefix (e.g. "spez"). Example: `<username>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### TikTok Ad Library Search

- Capability: `tiktok/ad-library-search`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Search TikTok's public Ads Library by keyword or advertiser (advertiser, title, audience band, run dates, library link, and video).
- Cost: 5 credits per call
- Capability file: [TikTok Ad Library Search](https://alexandria.firecrawl.dev/agents/providers/anyapi/tiktok/ad-library-search)

Accepted options:
- `advertiserName` (string): Advertiser name to list ads for (e.g. Spotify). Provide advertiserName or query, never both. Example: `<advertiserName>`
- `cursor` (string): Opaque cursor from a previous response's nextCursor. Omit it for the first page. Example: `<cursor>`
- `query` (string): Keyword to search ad titles and content (e.g. spotify). Provide query or advertiserName, never both. Example: `<query>`
- `region` (string): Two-letter region code for TikTok's Commercial Content Library, such as DE, FR, GB or IT. Each region holds a different set of ads. Omit it to take the library's own default region, DE. Coverage is the EU and EEA; a non-EU code such as US is not served. Example: `<region>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### TikTok Followers

- Capability: `tiktok/followers`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: List the followers of a TikTok account by username, returning each follower's profile basics.
- Cost: 5 credits per call
- Capability file: [TikTok Followers](https://alexandria.firecrawl.dev/agents/providers/anyapi/tiktok/followers)

Accepted options:
- `cursor` (string): Pagination cursor from a previous response's nextCursor, to fetch the next page of followers. Example: `<cursor>`
- `handle` (string, required): TikTok username whose followers to list, without the @ prefix (e.g. stoolpresidente). Example: `<handle>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### TikTok Following

- Capability: `tiktok/following`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: List the accounts a TikTok user follows (handle, display name, follower count, bio) by username.
- Cost: 5 credits per call
- Capability file: [TikTok Following](https://alexandria.firecrawl.dev/agents/providers/anyapi/tiktok/following)

Accepted options:
- `cursor` (string): Pagination cursor from a previous response. Example: `<cursor>`
- `handle` (string, required): TikTok username without the leading @ (e.g. "stoolpresidente"). Example: `<handle>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### TikTok Profile Contact Info

- Capability: `tiktok/profile-contact`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Find the public contact email behind a TikTok creator's profile: the address written into the bio plus any published on the site the profile links to, each labelled with where it came from. Returns the creator's profile stats and linked social accounts alongside.
- Cost: 5 credits per call
- Capability file: [TikTok Profile Contact Info](https://alexandria.firecrawl.dev/agents/providers/anyapi/tiktok/profile-contact)

Accepted options:
- `handle` (string, required): TikTok username without the leading @. Example: `<handle>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### TikTok Top Ads Search

- Capability: `tiktok/top-ads-search`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Search TikTok Creative Center top video ads by keyword, with campaign objective, performance percentile, and time-window filters.
- Cost: 5 credits per call
- Capability file: [TikTok Top Ads Search](https://alexandria.firecrawl.dev/agents/providers/anyapi/tiktok/top-ads-search)

Accepted options:
- `limit` (number): Maximum number of ads requested for this page, from 1 through 20 (default 20). Example: `20`
- `objective` (string): Campaign objective filter. Omit it to search every objective. Example: `traffic`
- `page` (number): One-based provider page number (default 1). Example: `1`
- `performanceRank` (string): Ad performance percentile bucket, where top_1_20 is the highest-performing 20 percent. Omit it to search every bucket. Example: `top_1_20`
- `period` (number): Lookback period in days (default 180). Example: `180`
- `query` (string, required): Keyword to search in TikTok Creative Center top video ads. Example: `<query>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### TikTok Trending Hashtags

- Capability: `tiktok/trending-hashtags`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Rank TikTok's trending hashtags for one country and industry, with each hashtag's daily popularity curve, post count, video views, and leading creators. Ranks 15 industry categories, or omit industry for the all-industries board.
- Cost: 5 credits per call
- Capability file: [TikTok Trending Hashtags](https://alexandria.firecrawl.dev/agents/providers/anyapi/tiktok/trending-hashtags)

Accepted options:
- `industry` (string): Restrict the ranking to one industry. Omit for the all-industries board. Example: `apparel_accessories`
- `limit` (number): Maximum number of ranked hashtags to return, from 1 through 100 (default 3). TikTok publishes only the top 3 hashtags per board to anonymous callers, so 1 through 3 is served by the cheapest source; a higher limit routes to a dearer source that reads the full ranking. Example: `3`
- `period` (number): Lookback window in days that the ranking and the popularity curve cover (default 7). Example: `7`
- `region` (string): Two-letter country code of the market whose hashtag ranking to read (default US). Each market is ranked independently, so US and DE return different boards. Example: `US`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### X Followers

- Capability: `twitter/followers`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Fetch the follower list of any public X (Twitter) account by username with cursor pagination. Limit is a per-page maximum and a native page holds up to 200 accounts; follow the response's nextCursor for more.
- Cost: 5 credits per call
- Capability file: [X Followers](https://alexandria.firecrawl.dev/agents/providers/anyapi/twitter/followers)

Accepted options:
- `cursor` (string): Opaque pagination cursor from a previous response's nextCursor. Omit for the first page; pass it to fetch the next page of followers. Example: `<cursor>`
- `limit` (number): Accepted but does not change the page: every call returns one full native page of followers (up to 200, depending on the source), never trimmed, so follow nextCursor to continue exactly where this response ended. Example: `200`
- `username` (string, required): The X (Twitter) username to fetch followers for, without the @ prefix (e.g. elonmusk). Example: `<username>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### X Following

- Capability: `twitter/following`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: List the accounts a public X (Twitter) account follows by username with cursor pagination. Limit is a per-page maximum; follow the response's nextCursor for more.
- Cost: 5 credits per call
- Capability file: [X Following](https://alexandria.firecrawl.dev/agents/providers/anyapi/twitter/following)

Accepted options:
- `cursor` (string): Opaque pagination cursor from a previous response's nextCursor. Omit for the first page; pass it to fetch the next page of followed accounts. Example: `<cursor>`
- `limit` (number): Accepted but does not change the page: every call returns one full native page of followed accounts (about 50), never trimmed, so follow nextCursor to continue exactly where this response ended. Example: `200`
- `username` (string, required): The X (Twitter) username to fetch the following list for, without the @ prefix (e.g. elonmusk). Example: `<username>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### X Post Replies

- Capability: `twitter/replies`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Fetch the replies to any X (Twitter) post URL as structured records: author, text, and engagement. An empty result is valid and does not assert whether the target post exists.
- Cost: 5 credits per call
- Capability file: [X Post Replies](https://alexandria.firecrawl.dev/agents/providers/anyapi/twitter/replies)

Accepted options:
- `cursor` (string): Opaque pagination cursor from a previous response's nextCursor. Omit for the first page; pass it to fetch the next page of replies. Example: `<cursor>`
- `limit` (number): Maximum number of results to return (1-40, default 40). Per-result lanes cost less at lower limits; a backup that bills its native page may cost up to the advertised request price. Example: `10`
- `url` (string, required): Full URL of the X (Twitter) post to fetch replies for (e.g. https://x.com/nasa/status/1846987139428634858). Example: `<url>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### X Search

- Capability: `twitter/search`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Search X (Twitter) with full advanced-search syntax (operators like from:, since:, until:, min_faves: work inline in the query) and get structured tweets with text, author, engagement, and cursor pagination. Limit is a per-page maximum; native pages contain approximately 20 tweets unless requireSinglePage selects a bulk lane.
- Cost: 5 credits per call
- Capability file: [X Search](https://alexandria.firecrawl.dev/agents/providers/anyapi/twitter/search)

Accepted options:
- `cursor` (string): Opaque pagination cursor from a previous response's nextCursor. Omit for the first page; pass it to fetch the next page of search results. Example: `<cursor>`
- `limit` (number): Page size to ask for (1-50, default 20). Some sources honor it; others always return their whole native page of about 20. A page is never trimmed after the call, so follow nextCursor to continue exactly where this response ended. Example: `20`
- `query` (string, required): Search query using X (Twitter) advanced-search syntax. IMPORTANT: bare terms are ANDed - a tweet must contain EVERY word, so a list of loosely related keywords matches nothing; use one short phrase or OR between alternatives (e.g. 'anyapi OR getanyapi'). Example: `<query>`
- `queryType` (string): Which posts to return: 'Latest' (newest first, the default), 'Top' (most popular), 'Photos' (newest posts with images), or 'Videos' (newest posts with video). Photos and Videos search your query as written with filter:images or filter:videos added after it, so they cost the same as a Latest search. Example: `Latest`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### X User Search

- Capability: `twitter/search-users`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Search X (Twitter) accounts by keyword - the People tab of X search. Matches handles, display names, and profile bios, and returns normalized profile records with follower, following, and post counts plus cursor pagination. Use twitter.search for posts.
- Cost: 5 credits per call
- Capability file: [X User Search](https://alexandria.firecrawl.dev/agents/providers/anyapi/twitter/search-users)

Accepted options:
- `cursor` (string): Opaque pagination cursor from a previous response's nextCursor. Omit for the first page; pass it to fetch the next page of accounts. Example: `<cursor>`
- `query` (string, required): Keyword to match against X (Twitter) handles, display names, and profile bios. This is the People tab of X search: pass a topic ('ai agents'), a name ('Elon Musk'), or a handle ('openai') and get back accounts, not posts. Use twitter.search for posts. Example: `<query>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### X Tweet Thread

- Capability: `twitter/thread`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Resolve the linear self-thread containing an X (Twitter) post, from its root through the author's linked continuations. This excludes replies from other users.
- Cost: 5 credits per call
- Capability file: [X Tweet Thread](https://alexandria.firecrawl.dev/agents/providers/anyapi/twitter/thread)

Accepted options:
- `url` (string, required): Canonical x.com or twitter.com status URL with a numeric tweet ID. Any tweet in the self-thread can be supplied; the provider resolves the thread root. Example: `<url>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```

### Twitter Tweet Transcript

- Capability: `twitter/tweet-transcript`
- Description: costUsd is the USD the vendor charged. items is the row count. output.data is the record, a list, or null on a miss. output.found is false when nothing matched. resultId identifies the run. A hint, when present, names a date adjustment or a paging limit.
- Instructions: Extract the spoken transcript from a Twitter/X video tweet by URL.
- Cost: 5 credits per call
- Capability file: [Twitter Tweet Transcript](https://alexandria.firecrawl.dev/agents/providers/anyapi/twitter/tweet-transcript)

Accepted options:
- `url` (string, required): Tweet URL of the video to transcribe (e.g. https://x.com/TheoVon/status/1916982720317821050). Example: `<url>`
- `fields` (string): Comma-separated item keys to keep. This does not change the price. Example: `<fields>`
- `max_items` (number): Cap how many result rows come back. This does not change the price. A one-record API is not trimmed. Example: `10`
- `summary` (boolean): Return a structural outline instead of the full data. This does not change the price. Example: `false`
- `jq` (string): jq expression applied to the result envelope. On failure the full result is returned with jqError. This does not change the price. Example: `<jq>`

Response schema example:
```json
{
  "costUsd": 0,
  "items": 0,
  "output": {},
  "provider": "<provider>",
  "resultId": "<resultId>",
  "source": "<source>",
  "hint": "<hint>",
  "replayed": false
}
```
