Skip to main content
GET
Fetch Reddit APP Dynamic Search Results
Fetch Reddit APP Dynamic Search Results Pricing — billed per successful call; the final charge scales by your plan multiplier. Charged only when the upstream response body code is 200.
Response structure is not yet fully documented — refer to the actual API response.

Example

Authorizations

Authorization
string
header
required

AIsa API key. Get yours at https://aisa.one

Query Parameters

language
string
default:en-US

Preferred response language as an IETF language tag; default: en-US

Required string length: 2 - 16
Pattern: ^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$
query
string
required

Search query

Required string length: 1 - 512
search_type
enum<string>
default:post

Search type, options:

  • post: Search posts (default)
  • community: Search communities/subreddits
  • comment: Search comments
  • media: Search media (images/videos/GIFs)
  • people: Search users
Available options:
post,
community,
comment,
media,
people
sort
enum<string> | null

Sort method (only for post/comment/media types), options:

  • RELEVANCE: By relevance
  • HOT: Hot/trending
  • TOP: Most popular
  • NEW: Newest
  • COMMENTS: By comment count (only for post type)
Available options:
RELEVANCE,
HOT,
TOP,
NEW,
COMMENTS
time_range
enum<string> | null

post/media)/Time range (only for post/media): all( ), year( ), month( ), week( ), day( ), hour( 1

Usage: Time range (only for post/media types), options:

  • all: All time
  • year: Past year
  • month: Past month
  • week: Past week
  • day: Today
  • hour: Past hour
Available options:
all,
year,
month,
week,
day,
hour

Safe search setting: unset, strict

Available options:
unset,
strict
allow_nsfw
enum<string>
default:0

Allow NSFW content: 0, 1

Available options:
0,
1
after
string
default:""

Pagination parameter

Maximum string length: 4096
need_format
boolean
default:false

Whether to clean and format the data

Response

200 - application/json

Successful response. The outer object follows ResponseModel; the endpoint-specific payload is in data.

Returns

  • JSON data of search results containing:
    • List of matching results (different data types based on search_type)
    • Pagination information
code
integer
default:200

HTTP status code

request_id
string | null

Unique request identifier

message
string
default:Request successful. This request will incur a charge.

Response message (EN-US)

message_zh
string
default:请求成功,本次请求将被计费。

Response message (ZH-CN)

support
string
default:Discord: https://discord.gg/aMEAS8Xsvz

Support message

time
string

The time the response was generated

time_stamp
integer

The timestamp the response was generated

time_zone
string
default:America/Los_Angeles

The timezone of the response time

docs
string | null

Link to the API Swagger documentation for this endpoint

cache_message
string | null
default:This response is cached and accessible via the URL below for 24 hours at no extra cost. The cache is for request tracing only — it doesn't affect the API's data freshness and won't be returned through the API again.

Cache message (EN-US)

cache_message_zh
string | null
default:本次响应已缓存,可通过下方 URL 直接查看,有效期 24 小时,访问缓存链接无额外费用。缓存仅用于请求溯源,不影响接口数据的时效性,也不会再次通过接口返回。

Cache message (ZH-CN)

cache_url
string | null

The URL to access the cached result

router
string
default:""

The endpoint that generated this response

params
any
default:{}

The parameters used in the request

data
any | null

Endpoint-specific response payload. The official shared model does not declare a fixed type or field set. Use the operation's documented return fields or response example; an operation-specific schema, when present, describes the documented fields. Undocumented fields must be read from the actual response rather than assumed.