# Oriane · Search TikTok videos

Get public social media posts, profiles and videos with Oriane · Search TikTok videos from Alexandria through one Spiral API key. Search Oriane's indexed TikTok posts, captions and engagement. Platform is fixed to TikTok. Coverage and freshness depend on the existing index; this is not a complete live feed. Results include profileUrl; an empty result does not trigger ingestion. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: Social Media
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `oriane/tiktok/posts-search`
- Page: https://spiral.ai/tools/alexandria/oriane/tiktok/posts-search

## Pricing

`projection`: basic $0.0611065, otherwise $0.087295, full $0.1134835 per run.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 5 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `sort` | text |  | — | Comma-separated sort fields with optional :asc or :desc. Profiles: followersCount, createdAt, updatedAt. Posts: viewsCount, likesCount, sharesCount, commentsCount, interactionsCount, engagementRatePerViews, engagementRatePerFollowers, profileFollowersCount, publishedAt, visualSimilarity, transcriptRelevance. |
| `limit` | number | 1 to 100 | — | Maximum results, default 20. |
| `handle` | text |  | — | Account username to match exactly, for example mrbeast. A leading @ is optional; usernames are matched without regard to case. Provide this or another search field; multiple fields must all match. |
| `offset` | number | 0 to … | — | Result offset, default 0. |
| `caption` | text |  | — | Text to match in the caption. Provide this or another search field; multiple fields must all match. |
| `projection` | one of | basic, default, full | default | Response detail and fixed price per nonempty call: basic 35 credits, default 50 credits, full 65 credits. Empty results cost zero. Result limit does not change the tier price. |
| `aiSearchAnchor` | text |  | — | Anchor from the first visual search page, required for subsequent pages. |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "oriane/tiktok/posts-search",
    "input": {
      "handle": "<handle>"
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=oriane%2Ftiktok%2Fposts-search

## Common questions

### Oriane · Search TikTok videos

**How much does Oriane · Search TikTok videos cost?**

`projection`: basic $0.0611065, otherwise $0.087295, full $0.1134835 per run. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use Oriane · Search TikTok videos through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "oriane/tiktok/posts-search"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Alexandria to use Oriane · Search TikTok videos?**

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

**Can my AI agent use Oriane · Search TikTok videos?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

