Spiral gives your agent every tool with one account. Browse the tools →

AlexandriaSocial MediaAvailable now

Oriane · Search TikTok videos

oriane/tiktok/posts-search

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.

Pricing

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

Limits

Runs
In the background
Returns
json
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

FieldKindDefaultDescription
sorttext—

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.

limitnumber
1 to 100
—

Maximum results, default 20.

handletext—

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.

offsetnumber
0 to …
—

Result offset, default 0.

captiontext—

Text to match in the caption. Provide this or another search field; multiple fields must all match.

projectionone 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.

aiSearchAnchortext—

Anchor from the first visual search page, required for subsequent pages.

Same request in code

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>"
    }
  }'

Frequently asked questions

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.