Reddit Post Search

2.62 credits/call
ae_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.

Social
2.62 credits/call

Pricing

2.62 credits/call
ConditionCharge
Each call2.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.

ParameterTypeRequiredDescriptionDefault
pageintegerNoThe page index of the query result. Defaults to page 1. Each page returns 20 records.1
post_typestringNoFilter 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_namestringYesSearch 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_sentimentintegerNoFilter by main post sentiment. Allowed: 1=Positive, 2=Neutral, 3=Negative.0

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key
Request coderequest.sh
curl --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"
  }
}'
Response exampleresponse.json
JSON
"No data available."

Guides using this tool

See how this tool fits into real workflows