OpenAPI
Meta 素材搜索
分页筛选广告素材。金额估算、预算等级与实际账单不同；未指定日期的 Meta 查询沿用服务默认时间范围。
/v1/ads/meta/search- 认证方式
- X-API-Key
- 所需 scope
ads:meta:search- 计费
- 价格以账户生效规则为准
- 限流
- 查看当前限流规则
请求参数
该请求使用 JSON 请求体提交。
pageinteger可选默认值: 1
1 ≤ page ≤ 1000
sizeinteger可选默认值: 20
1 ≤ size ≤ 100
about_textstring可选关于文本模糊查询
material_typestring可选素材类型, 逗号分隔
cta_typestring可选cta类型, 逗号分隔
page_category_type_enstring可选页面类目, 逗号分隔
platform_categorystring可选页面类目, 逗号分隔
countrystring可选国家代码, 逗号分隔
publisher_platform_arrstring可选发布平台, 逗号分隔 (数组字段筛选)
creation_time_beginstring可选开始日期范围-起始 (YYYY-MM-DD)
creation_time_endstring可选开始日期范围-结束 (YYYY-MM-DD)
placement_days_gteinteger可选投放天数-起始
placement_days_lteinteger可选投放天数-结束
likes_gteinteger可选粉丝数-起始
likes_lteinteger可选粉丝数-结束
total_reach_gteinteger可选触达次数-起始
total_reach_lteinteger可选触达次数-结束
estimate_spend_gtenumber可选预估消耗-起始
estimate_spend_ltenumber可选预估消耗-结束
ad_creative_labelstring可选素材标签, 逗号分隔 (Exhausted,One-Hit,Others,Scaling)
is_political_pageboolean可选是否政治页面
is_activeboolean可选是否投放中
is_euboolean可选是否面向欧盟
sort_bystring可选排序字段；关键词检索未指定时默认按相关度
relevance · start_date · likes · placement_days · total_reach · estimate_spend
sort_orderstring可选默认值: "DESC"
ASC · DESC
响应
successboolean必填dataarray可选展开字段
ad_archive_idstring必填page_idinteger可选titlestring可选about_textstring可选material_typestring可选obs_image_urlstring可选obs_video_hd_urlstring可选landing_page_urlstring可选active_statusboolean可选start_datestring可选placement_daysinteger可选total_reachinteger可选estimate_spendnumber可选估算值，非实际账单
currencystring可选publisher_platformarray可选展开字段
该接口暂不提供 Schema 详情。
errorobject可选错误详情
展开字段
codeinteger必填业务错误码
messagestring必填可读错误信息
metaobject可选响应元数据
展开字段
request_idstring可选请求唯一标识
默认值: ""
pageinteger可选当前页码
sizeinteger可选每页数量
totalinteger可选总数
quota_remaininginteger可选剩余配额（-1 表示不限制）
默认值: -1
service_levelstring可选本次请求的服务等级
langstring可选响应语言（cn/en），为空表示未翻译
platformstring可选本次请求的达人平台
recall_typestring可选召回类型：hybrid / vector / scalar
credits_consumedinteger可选本次请求扣减的积分数
默认值: 0
credits_remaininginteger可选积分余额（-1 不限制）
默认值: -1
billable_unitsinteger可选Server-calculated billable units for this response
默认值: 0
0 ≤ billable_units ≤ ∞
skill_namestring可选调用方 skill 名称
skill_current_versionstring可选调用方 skill 当前版本
skill_latest_versionstring可选服务端声明的最新 skill 版本
skill_min_supported_versionstring可选服务端声明的最低支持版本
skill_update_availableboolean可选是否存在可用 skill 更新
默认值: false
skill_update_requiredboolean可选是否要求更新 skill 后再继续使用
默认值: false
skill_update_messagestring可选skill 更新提示文案
skill_update_manifest_urlstring可选skill 更新 manifest URL