Skip to main content
POST
Search ads
Search ads Pricing — base $0.00145 per successful call (provider cost × 1.45; final charge scales by your plan multiplier). Charged only when the upstream response body code is 200.

Example

Authorizations

Authorization
string
header
required

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

Body

application/json
objective
integer | null

广告目标类型(可选)/Ad objective (optional; 1:流量 2:应用安装 3:转化 4:视频浏览 5:触达 6:潜在客户 7:产品销售)

like
integer | null

表现排名(可选)/Performance rank (optional; 1:前1-20% 2:前21-40% 3:前41-60% 4:前61-80% 5:前81-100%)

period
integer
default:180

时间段/Time period (days)

industry
string

行业ID/Industry ID

keyword
string

搜索关键词/Search keyword

page
integer
default:1

页码/Page number

limit
integer
default:20

每页数量/Items per page

order_by
string
default:for_you

排序方式/Sort by (for_you, likes)

country_code
string
default:US

国家代码/Country code

ad_format
integer | null

广告格式(可选)/Ad format (optional; 1:Spark Ads 2:Non-Spark Ads)

ad_language
string | null

广告语言(可选)/Ad language (optional)

duration
integer | null

视频时长筛选值(可选)/Video duration filter value (optional)

pattern_label
string | null

创意趋势标签(可选)/Creative pattern label (optional)

search_id
string

搜索ID(可选)/Search ID (optional)

自定义Cookie字符串(可选)

Response

200 - application/json

Successful Response

code
integer
default:200

HTTP status code | HTTP状态码

request_id
string | null

Unique request identifier | 唯一请求标识符

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

Response message (EN-US) | 响应消息 (English)

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 | 此端点的 API Swagger 文档链接

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) | 缓存消息 (English)

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

Cache message (ZH-CN) | 缓存消息 (中文)

cache_url
string | null

The URL to access the cached result | 访问缓存结果的 URL

router
string
default:""

The endpoint that generated this response | 生成此响应的端点

params
any
default:{}

The parameters used in the request | 请求中使用的参数

data
any | null

The response data | 响应数据