Reddit Post Search
Search Reddit posts to explore what people say about a brand, product category, or problem, including complaints, purchase advice, and usage experiences. Enter a Chinese or English keyword in search_name. Optionally select a result page with page (default 1), filter post categories with comma-separated post_type codes (1=Question/Help, 2=Purchase Advice, 3=Complaint, 4=Experience Sharing, 5=Discussion, 6=Innovation, 7=Other), or filter the main post sentiment with main_sentiment (1=Positive, 2=Neutral, 3=Negative). Returns up to 20 posts per call; the provider has not specified a structured output schema.
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.62 credits/call |
The fixed fee for each call is 2.62 credits.
Each call searches the specified results page. The page number, post type filters and main post sentiment filter do not affect the fixed fee per call.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
page | integer | No | The page index of the query result. Defaults to page 1. Each page returns 20 records. | 1 |
post_type | string | No | Filter by post type, multiple values separated by commas. Allowed: 1=Question/Help, 2=Purchase Advice, 3=Complaint, 4=Experience Sharing, 5=Discussion, 6=Innovation, 7=Other. | "" |
search_name | string | Yes | Search keyword, supports both Chinese and English. Can be a brand name (e.g., Whirlpool), a category term (e.g., "Ice Maker"), or a problem description (e.g., "What to do if the ice maker leaks"). | — |
main_sentiment | integer | No | Filter by main post sentiment. Allowed: 1=Positive, 2=Neutral, 3=Negative. | 0 |
Invocation example
Copy the request and explore its response example.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_reddit_post_search' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"page": 1,
"search_name": "led bulbs"
}
}'"No data available."Guides using this tool
See how this tool fits into real workflows

