reddit fetch_dynamic_search

Reference example

# Fixed reference example. Playground inputs do not update this sample.
curl --request GET \
  --url 'https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_dynamic_search?after=&allow_nsfw=0&need_format=false&query=python+programming&safe_search=unset&search_type=post&sort=RELEVANCE&time_range=all' \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_dynamic_search"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_dynamic_search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_dynamic_search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_dynamic_search"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_dynamic_search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "cache_message": "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_zh": "本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。",
  "cache_url": "<string>",
  "code": 200,
  "data": "<unknown>",
  "docs": "<string>",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功，本次请求将被计费。",
  "params": {},
  "request_id": "<string>",
  "router": "",
  "support": "Discord: https://discord.gg/aMEAS8Xsvz",
  "time": "<string>",
  "time_stamp": 123,
  "time_zone": "America/Los_Angeles"
}

GET

https://api.aisa.one

apis

tikhub

app

fetch_dynamic_search

Reference example

# Fixed reference example. Playground inputs do not update this sample.
curl --request GET \
  --url 'https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_dynamic_search?after=&allow_nsfw=0&need_format=false&query=python+programming&safe_search=unset&search_type=post&sort=RELEVANCE&time_range=all' \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_dynamic_search"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_dynamic_search', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_dynamic_search",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_dynamic_search"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_dynamic_search")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

{
  "cache_message": "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_zh": "本次响应已缓存，可通过下方 URL 直接查看，有效期 24 小时，访问缓存链接无额外费用。缓存仅用于请求溯源，不影响接口数据的时效性，也不会再次通过接口返回。",
  "cache_url": "<string>",
  "code": 200,
  "data": "<unknown>",
  "docs": "<string>",
  "message": "Request successful. This request will incur a charge.",
  "message_zh": "请求成功，本次请求将被计费。",
  "params": {},
  "request_id": "<string>",
  "router": "",
  "support": "Discord: https://discord.gg/aMEAS8Xsvz",
  "time": "<string>",
  "time_stamp": 123,
  "time_zone": "America/Los_Angeles"
}

获取Reddit APP动态搜索结果计费 — 按成功调用计费，最终扣费按你的套餐倍率浮动。仅当上游响应体 code 为 200 时计费。

响应结构尚未完整文档化 —— 以实际调用为准。

示例

curl "https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_dynamic_search?query=python programming" \
  -H "Authorization: Bearer YOUR_API_KEY"

请求规范

方法与路径: GET /apis/v1/tikhub/reddit/app/fetch_dynamic_search
可用状态: enabled
请求 URL 模板: https://api.aisa.one/apis/v1/tikhub/reddit/app/fetch_dynamic_search
after: query; 可选
allow_nsfw: query; 可选
language: query; 可选
need_format: query; 可选
query: query; 必填
safe_search: query; 可选
search_type: query; 可选
sort: query; 可选
time_range: query; 可选
Runtime 事实版本: 85ae03121f63417c9ff9d57a0fd59fdc6386fd71e2dc732a002843e6d8979d87

完整 OpenAPI 定义有效请求与价格声明（包括认证和引用的 schema）：

{
  "operationId": "get_tikhub_reddit_app_fetch_dynamic_search",
  "method": "GET",
  "path": "/apis/v1/tikhub/reddit/app/fetch_dynamic_search",
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "parameters": [
    {
      "description": "Pagination parameter",
      "example": "",
      "in": "query",
      "name": "after",
      "required": false,
      "schema": {
        "default": "",
        "description": "Pagination parameter",
        "maxLength": 4096,
        "title": "After",
        "type": "string"
      }
    },
    {
      "description": "Allow NSFW content: 0, 1",
      "example": "0",
      "in": "query",
      "name": "allow_nsfw",
      "required": false,
      "schema": {
        "default": "0",
        "description": "Allow NSFW content: 0, 1",
        "enum": [
          "0",
          "1"
        ],
        "title": "Allow Nsfw",
        "type": "string"
      }
    },
    {
      "description": "Preferred response language as an IETF language tag; default: en-US",
      "in": "query",
      "name": "language",
      "required": false,
      "schema": {
        "default": "en-US",
        "description": "Preferred response language as an IETF language tag; default: en-US",
        "maxLength": 16,
        "minLength": 2,
        "pattern": "^[A-Za-z]{2,3}(?:-[A-Za-z0-9]{2,8})*$",
        "title": "Language",
        "type": "string"
      }
    },
    {
      "description": "Whether to clean and format the data",
      "example": false,
      "in": "query",
      "name": "need_format",
      "required": false,
      "schema": {
        "default": false,
        "description": "Whether to clean and format the data",
        "title": "Need Format",
        "type": "boolean"
      }
    },
    {
      "description": "Search query",
      "example": "python programming",
      "in": "query",
      "name": "query",
      "required": true,
      "schema": {
        "description": "Search query",
        "maxLength": 512,
        "minLength": 1,
        "title": "Query",
        "type": "string"
      }
    },
    {
      "description": "Safe search setting: unset, strict",
      "example": "unset",
      "in": "query",
      "name": "safe_search",
      "required": false,
      "schema": {
        "default": "unset",
        "description": "Safe search setting: unset, strict",
        "enum": [
          "unset",
          "strict"
        ],
        "title": "Safe Search",
        "type": "string"
      }
    },
    {
      "description": "Search type, options:\n  - post: Search posts (default)\n  - community: Search communities/subreddits\n  - comment: Search comments\n  - media: Search media (images/videos/GIFs)\n  - people: Search users",
      "example": "post",
      "in": "query",
      "name": "search_type",
      "required": false,
      "schema": {
        "default": "post",
        "description": "Search type, options:\n  - post: Search posts (default)\n  - community: Search communities/subreddits\n  - comment: Search comments\n  - media: Search media (images/videos/GIFs)\n  - people: Search users",
        "enum": [
          "post",
          "community",
          "comment",
          "media",
          "people"
        ],
        "title": "Search Type",
        "type": "string"
      }
    },
    {
      "description": "Sort method (only for post/comment/media types), options:\n  - RELEVANCE: By relevance\n  - HOT: Hot/trending\n  - TOP: Most popular\n  - NEW: Newest\n  - COMMENTS: By comment count (only for post type)",
      "example": "RELEVANCE",
      "in": "query",
      "name": "sort",
      "required": false,
      "schema": {
        "description": "Sort method (only for post/comment/media types), options:\n  - RELEVANCE: By relevance\n  - HOT: Hot/trending\n  - TOP: Most popular\n  - NEW: Newest\n  - COMMENTS: By comment count (only for post type)",
        "enum": [
          "RELEVANCE",
          "HOT",
          "TOP",
          "NEW",
          "COMMENTS",
          null
        ],
        "title": "Sort",
        "type": [
          "string",
          "null"
        ]
      }
    },
    {
      "description": "post/media)/Time range (only for post/media): all( ), year( ), month( ), week( ), day( ), hour( 1\n\nUsage: Time range (only for post/media types), options:\n  - all: All time\n  - year: Past year\n  - month: Past month\n  - week: Past week\n  - day: Today\n  - hour: Past hour",
      "example": "all",
      "in": "query",
      "name": "time_range",
      "required": false,
      "schema": {
        "description": "post/media)/Time range (only for post/media): all( ), year( ), month( ), week( ), day( ), hour( 1\n\nUsage: Time range (only for post/media types), options:\n  - all: All time\n  - year: Past year\n  - month: Past month\n  - week: Past week\n  - day: Today\n  - hour: Past hour",
        "enum": [
          "all",
          "year",
          "month",
          "week",
          "day",
          "hour",
          null
        ],
        "title": "Time Range",
        "type": [
          "string",
          "null"
        ]
      }
    }
  ],
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "x-aisa-status": "enabled",
  "x-aisa-pricing": {
    "cost_contract": "fixed_success",
    "customer_multiplier": 1.0,
    "customer_pricing": "provider_cost_multiplier",
    "default_request_estimate_usd": 0.001,
    "estimate_source": "profile_seed",
    "evidence_source": "request_snapshot"
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    }
  }
}

费用与请求规则

公开参考价格：每次成功请求 $0.001 USD。最终费用以账户适用价格及实际结算为准。公开参考值不是你的账户报价或最终扣费。对于支持 X-AISA-Cost-Mode: quote 的接口，执行前请针对完整请求获取免费报价；执行后通过响应费用元数据和 Usage Logs 核对结算费用。1 USD 等于 1,000,000 个整数 micro-USD。

默认请求参考估价（USD）: 0.001
计费依据: fixed_success
公开参考倍率: 1.0
结算证据来源: request_snapshot

授权

Authorization

string

header

必填

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

查询参数

after

string

默认值:""

Pagination parameter

Maximum string length: 4096

allow_nsfw

enum<string>

默认值:0

Allow NSFW content: 0, 1

可用选项:

0,

1

language

string

默认值: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})*$

need_format

boolean

默认值:false

Whether to clean and format the data

query

string

必填

搜索查询

Required string length: 1 - 512

safe_search

enum<string>

默认值:unset

Safe search setting: unset, strict

可用选项:

unset,

strict

search_type

enum<string>

默认值:post

Search type, options:

post: Search posts (default)
community: Search communities/subreddits
comment: Search comments
media: Search media (images/videos/GIFs)
people: Search users

可用选项:

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)

可用选项:

RELEVANCE,

HOT,

TOP,

NEW,

COMMENTS,

null

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

可用选项:

all,

year,

month,

week,

day,

hour,

null

响应

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

cache_message

string | null

默认值: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

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

Cache message (ZH-CN)

cache_url

string | null

The URL to access the cached result

code

integer

默认值:200

HTTP 状态码

data

any

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.

docs

string | null

Link to the API Swagger documentation for this endpoint

message

string

默认值:Request successful. This request will incur a charge.

Response message (EN-US)

message_zh

string

默认值:请求成功，本次请求将被计费。

Response message (ZH-CN)

params

any

默认值:{}

The parameters used in the request

request_id

string | null

Unique request identifier

router

string

默认值:""

The endpoint that generated this response

support

string

默认值: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

默认值:America/Los_Angeles

The timezone of the response time

概览

模型

搜索与研究

金融与加密

社交与媒体

SEO 与网站情报

销售与邮件

出行与其他

Media Generation

reddit fetch_dynamic_search

示例

请求规范

费用与请求规则

授权

查询参数

响应

Returns

​示例

​请求规范

​费用与请求规则

授权

查询参数

响应

Returns

示例

请求规范

费用与请求规则