Reddit App Fetch Search Typeahead
Get autocomplete suggestions for the Reddit app search box based on your search text. Inputs: - query (required): Search text, up to 512 characters. - language (optional): Preferred response language as an IETF language tag, such as en-US. Must be 2–16 characters and match ^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$. Default: en-US. - safe_search (optional): "unset" for an unset safe-search setting or "strict" for strict mode. Default: "unset". - allow_nsfw (optional): String "0" to disallow adult content or "1" to allow it. Default: "0". - need_format (optional): Whether to request cleaned and formatted data. Default: false. Returns: JSON search-suggestion data that may include related subreddits, users, suggested search terms, and trending topics. The exact data structure and available categories are not fixed by the documented response schema. These are autocomplete suggestions, not full search results. Example: {"query":"programming","language":"en-US","safe_search":"unset","allow_nsfw":"0","need_format":false}
Pricing
| Condition | Charge |
|---|---|
| Each call | 2.07 credits/call |
2.07 credits/call Charges are per query. A successful query is billed even if it returns no results.
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
query | string | Yes | 搜索关键词/Search query | — |
language | string | No | 返回内容使用的语言,采用 IETF 语言标签;默认 en-US / Preferred response language as an IETF language tag; default: en-US | en-US |
allow_nsfw | enum (0 | 1) | No | 是否允许NSFW内容/Allow NSFW content: 0 or 1 | 0 |
need_format | boolean | No | 是否需要清洗数据/Whether to clean and format the data | false |
safe_search | enum (unset | strict) | No | 安全搜索设置/Safe search setting: unset, strict | unset |
Invocation example
Parameter templateGenerated from the parameter configuration. Replace the sample values before use.
/agent-api/v1/tool/executeX-Api-Keycurl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_reddit_app_fetch_search_typeahead' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"query": "xxx"
}
}'No response example available yet.

