Blizzard US Forums · Search posts
us-forums-blizzard-com/forum-discussions/search_postsGet public social media posts, profiles and videos with Blizzard US Forums · Search posts from Alexandria through one Spiral API key. Find discussions about a subject (e.g. WoW Forever newest first, or posts in #housing after a date). Pair with get_topic for the full thread. It runs in the background and returns structured JSON. Pay as you go, with no subscription.
Pricing
$0.00873 per call.
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
| Field | Kind | Default | Description |
|---|---|---|---|
query required | text | — | Free text; the site's own operators ( |
page | number 1 to 100 | — | 1-based results page. Continue with next_page and next_offset as a pair. |
site | text | wow | Forum site prefix on us.forums.blizzard.com. Known prefixes (robots.txt, 2026-09-22): wow, blizzard, blizzcon, d2r, d3, d4, diablo-immortal, hearthstone, heroes, overwatch, sc2, starcraft, warcraft3, warcraftrumble (en); d3, hearthstone, heroes, overwatch, sc2, warcraftrumble, wow (es); blizzard, d3, hearthstone, heroes, overwatch, sc2, warcraftrumble, wow (pt). Each locale/site pair is a separate Discourse forum with its own category, topic, post and user ids. Default |
after | text | — | Only posts on or after this YYYY-MM-DD date. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. |
order | one of latest, likes, views, latest_topic | — | latest (newest post first), likes, views or latest_topic; default is the site's relevance order. |
before | text | — | Only posts before this YYYY-MM-DD date. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. |
locale | one of en, es, pt | en | Locale path prefix: en, es or pt. Default |
offset | number 0 to 10000 | — | Offset within the upstream page, default 0. Pass the prior next_offset together with next_page. |
category | text | — | Category slug to restrict to ( |
max_results | number 1 to 50 | — | Maximum rows returned from this page window. Continue with both next_page and next_offset. |
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": "us-forums-blizzard-com/forum-discussions/search_posts",
"input": {
"query": "<query>"
}
}'Frequently asked questions
How much does Blizzard US Forums · Search posts cost?
$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.
How do I use Blizzard US Forums · Search posts through an API?
Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "us-forums-blizzard-com/forum-discussions/search_posts"` 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 Blizzard US Forums · Search posts?
No. Spiral runs it on its own Alexandria account and charges your Spiral balance.
Can my AI agent use Blizzard US Forums · Search posts?
Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.