Search Forum Posts
Search for forum posts across the web, including discussion boards, Q&A sites, and community boards. Each result returns its position and rank, the post title, URL, source forum, domain, and a content snippet. Supports filtering by time period (hour, day, week, month, year) and by country (ISO 3166-1 alpha-2 code). Results are paginated 10 at a time via the page parameter, and count reports how many were returned. The search runs in English. Set get_sentiment=true to add AI emotion analysis to each post.
Price: $0.008 per request. Free tier: 50 requests/month.
Request
- Base URL: https://apidirect.io
- URL: https://apidirect.io/v1/forums/posts
- Auth: API key in header X-API-Key
Query parameters
Search query (max 500 characters). Leading and trailing whitespace is trimmed, and the query must not be empty.
Page number for pagination, 1-10 (default: 1). Results are paginated 10 at a time, so page=2 starts at the 11th result. Values below 1, and values that are not numbers, are treated as 1. A page above 10 returns 400.
Filter by time period. 'any' applies no time filter. Any value outside this list returns 400.
ISO 3166-1 alpha-2 country code (e.g., US, GB, DE). Case-insensitive. Any value that is not exactly 2 letters returns 400.
Set to true to add AI emotion analysis to each post. Adds a sentiment object containing emotions (joy, trust, fear, surprise, sadness, disgust, anger and anticipation, each scored 0-100), dominant_emotion, emotional_intensity (0-10), and polarity (positive, negative or neutral). Any post that cannot be scored returns sentiment: null.
Response
Successful response
Changes
No recorded changes to this operation across all 1 revision of this API.