API Direct

Forum Posts

GET /v1/forums/posts

Search forum posts across the web including discussion boards, Q&A sites, and community forums. Returns post title, URL, source domain, and content snippet. Supports filtering by time period and country.

Cost

$0.008 per request

Free tier

50 requests/month

Parameters

query *

Search keyword (max 500 characters)

page

Page number for pagination (default: 1)

time

Time filter: any, hour, day, week, month, year (default: any)

country

ISO 3166-1 alpha-2 country code (e.g., US, GB)

get_sentiment

Set to true to add AI emotion analysis (+$0.001/request)

Example Request

curl "https://apidirect.io/v1/forums/posts?query=programming&time=week&country=US" \
  -H "X-API-Key: YOUR_API_KEY"

import requests

response = requests.get(
    "https://apidirect.io/v1/forums/posts",
    headers={"X-API-Key": "YOUR_API_KEY"},
    params={
        "query": "programming",
        "time": "week",
        "country": "US"
    }
)
print(response.json())

Example Response

{
  "posts": [
    {
      "position": 1,
      "rank": 1,
      "title": "Discussion about programming",
      "url": "https://forum.example.com/thread/...",
      "source": "forum.example.com",
      "domain": "forum.example.com",
      "snippet": "Forum post content...",
      "sentiment": {
        "emotions": {
          "joy": 40,
          "trust": 55,
          "fear": 0,
          "surprise": 10,
          "sadness": 0,
          "disgust": 0,
          "anger": 0,
          "anticipation": 30
        },
        "dominant_emotion": "trust",
        "emotional_intensity": 5,
        "polarity": "positive"
      }
    }
  ],
  "page": 1,
  "count": 10
}

Your Usage

Free tier this month

Recent Activity