---
title: "Search Forum Posts"
method: GET
path: "/v1/forums/posts"
tags: ["Forums"]
---

# Search Forum Posts

`GET /v1/forums/posts`

## Request

- Base URL: `https://apidirect.io`
- URL: `https://apidirect.io/v1/forums/posts`
- Auth: API key in header `X-API-Key`

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.

## Query parameters

- `query` string, required
- `page` integer
- `time` 'any' | 'hour' | 'day' | 'week' | 'month' | 'year'
- `country` string
- `get_sentiment` boolean

## Response `200`

Successful response

- SearchForumsResponse: Inferred from a live response. Any field can be null or absent, and new fields may be added at any time.
  - `count` number, nullable
  - `page` number, nullable
  - `posts` object[], nullable
    - `domain` string, nullable
    - `position` number, nullable
    - `rank` number, nullable
    - `snippet` string, nullable
    - `source` string, nullable
    - `title` string, nullable
    - `url` string, nullable

## Other responses

- `400`: Bad request: missing query, query over 500 characters, unsupported time value, or a country code that is not 2 letters
- `401`: Unauthorized: invalid or missing API key
- `402`: Free tier used up for this endpoint and no payment method on file (`payment_required`).
- `403`: Account blocked after a failed payment (`account_blocked`).
- `429`: Rate limit exceeded, or too many concurrent requests for this endpoint
- `500`: Internal server error
- `502`: Temporary failure retrieving forum data. Please retry shortly.
- `503`: Service temporarily unavailable. Please retry shortly.
- `504`: The request timed out

---

[API](https://skmtc.dev/apidirect/apis/api-direct.md) · [All operations](https://skmtc.dev/apidirect/apis/api-direct/llms.txt) · [OpenAPI document](https://skmtc.dev/apidirect/apis/api-direct/revisions/fa8c68d70bd0?raw)