gtm)，包含下列六项能力。
Capability 是 Solution 中的一项能力，例如 company_intelligence 或 people_search，各有固定的支持操作和输入。
为什么使用 Solution？
例如，公司信息能力可按域名查询公司。你只需发送domain，Glasser 会选择受支持的数据提供商，将输入转换为其接口格式，并在支持的失败类型下尝试下一家符合条件的数据提供商。
这样，集成无需处理各数据提供商不同的输入格式：无论所选数据提供商要求 domain、website 还是 company_website，你都只需发送 domain。
当 Solution 的输入能够满足任务时，可使用此方式。如果需要指定接口、完整输入选项，或在执行前确定其准确价格，请通过 搜索、检查 和运行直接选择并调用接口。
可用能力
各能力在/v1/solutions/gtm/ 下有独立请求路径。
各能力的参考页列出了支持的操作、数据提供商和必填字段。多数能力使用
action 选择操作；社交数据研究使用 platform 和 mode。
示例：获取公司资料
按 API 概览配置 API Key。以下请求会执行付费数据查询：domain。省略 action 时使用 enrich，省略 provider 时使用 auto。metadata 可选，可以省略。重试此请求时保持 Idempotency-Key 不变；重新查询或发起不同请求时，使用新值。
数据提供商如何选择
使用
auto 时，遇到数据提供商错误、超时或接口不可用， Glasser 可以尝试下一家符合条件的数据提供商。搜索结果为空不会触发切换。 Fetch (scrape) 还可在输出为空、无效或缺少受支持的格式时，在请求预算内切换。内容措辞和长度不会触发切换。所选接口必须支持你的输入，并获得当前 API Key 的允许。
结果与费用
网页研究的所有操作均返回规范化output。Scrape 提供 text、markdown、html 和 raw_html，缺失格式为 null。Search 提供 output.results[]；news、places、scholar、shopping、images、videos 和 similar 提供每行字段固定的 output.items[]；answer 提供 output.answer 和 citations[]。数据提供商原生输出不在 output 中重复，而是保留在 Run 中，可通过 Get Run 读取。Glasser 不将 HTML 转为文本，也不合并抓取内容。
通过 result_status 判断交付结果：success、partial、no_result、error 或 pending。缺失的请求格式列在 missing_formats 中。交付错误返回 output: null 和 error。内容语义仍未经验证。
charge_usd 是所列 runs 的费用总和，包括收费的失败和空结果。每个 Run 在 runs[] 中有独立费用及计费条款。存在未结算 Run 时，总费用为 null；多个 Run 不存在单一的顶层 charge_basis。 id、provider 和大写的 status 仍描述最终 Run。
POST 在 Run 结束时返回 HTTP 200，执行中返回 202。在 API 服务地址上，使用 API Key 轮询返回的 result_url，以保留规范化输出和费用总和。即使仍在等待，该读取请求也返回 HTTP 200，请检查正文。轮询不会创建 Run，也不会恢复数据提供商切换。获取 Run 保留原生输出和单笔费用。仅轮询 Get Run 的旧插件必须更新轮询路径。仅凭 COMPLETED 无法确认内容可用。
SEO 研究的所有操作均返回规范化 output。列表类操作提供每行字段固定的 output.items[]，例如 ranked_keywords 包含 keyword、 position、url、volume、cpc_usd、traffic；概览类操作提供固定顶层字段，例如 backlinks_overview 包含 backlinks、referring_domains、 semrush_authority_score、dataforseo_rank、serpstat_domain_rank、dofollow_backlinks、 nofollow_backlinks。所选数据提供商的原生输出保留在 Run 中，不进入 output。数据提供商未报告的值为 null；金额统一为美元。权威度分数不在数据提供商之间换算，均保留各自的名称和量表，只填写实际响应方的字段。volume、traffic 和 cpc_usd 均为各数据提供商自身估算，只宜在同一家内比较。result_status 为 success、no_result、error 或 pending，上述计费和轮询规则保持不变。各操作的字段列表见 SEO 研究参考页。
公司信息的所有操作均返回规范化 output：enrich 和 traffic 提供固定顶层字段；tech_stack、competitors、news 和 jobs 提供 output.items[]； funding 提供 total_funding_usd 和 items[]；ads 提供 total_ads 和 items[]。员工数和营收区间拆分为 *_range_min / *_range_max，相似度分数带有数据提供商名称，如 predictleads_similarity_score、exa_similarity_score。各操作字段见 公司信息参考页。
市场数据的所有操作均返回规范化 output，共享同一组房产字段，包括 address、property_type、bedrooms、bathrooms、living_area_sqft、lot_size_sqft、 year_built、latitude、longitude。房产搜索增加产权人字段；房源增加挂牌、MLS、HOA、经纪人和经纪机构字段；出售房源使用 price_usd，出租房源使用 monthly_rent_usd；估值报告 comparables_count。股票报价包含 currency、常规交易时段的 price、change、change_percent，其中百分比以百分点表示，以及 extended_hours_* 报价和 as_of_text。各操作字段见市场数据 参考页。
社交数据研究按 mode 返回规范化 output，六个平台共享同一结构： profile 返回单个账号，search 和 feed 返回帖子列表 output.items[]，post 返回单篇帖子， find 返回 output.profiles[]。帖子包含 title、仅含正文的 text 和 published_at；详见社交数据研究 参考页。
人员搜索的所有操作均返回规范化 output：search 提供 total_matches 及每人一行的 output.items[]；enrich 和 find_email 在顶层提供相同字段的单个人员。姓名、职称、seniority 和 department 均按数据提供商报告保留。email_status 为数据提供商自身的验证标签，需结合 email_catch_all 和 email_source 阅读。Hunter 的 generated 表示邮箱按域名模式生成。find_email 未返回邮箱时为 no_result。字段详情见 人员搜索参考页。
字段约定
所有规范化output 均遵循相同的命名规则：
Fetch 控制参数为
formats、timeout_ms，默认 90000，max_charge_usd 和 cache_max_age_seconds，后两项可选。请求格式用于选择数据提供商和决定是否切换；实际可用格式位于固定输出字段中。费用上限包括本请求中的全部 Run，也包括重放 Run。存在未结算 Run 时停止切换。使用同一个键重试会复用 Run，并开始新的请求时间窗口。
自动模式先使用 Serper，再使用 Firecrawl。请求 HTML 或明确指定缓存年龄时，直接使用 Firecrawl，但排除 X/Twitter 和 LinkedIn 信息补全路径。显式只请求文本时使用 Serper。Exa 可通过明确指定使用。每次数据提供商调用都以所属 Endpoint 的自身窗口开启；当该窗口会超出请求预算时，Serper、Firecrawl 与 Exa 仍按实际剩余调用时间运行，并预留结算及响应时间；剩余调用时间少于一秒时跳过这一跳。如果没有 Run 能被受理，API 返回受理错误。如果预算阻止继续切换，则报告最后受理 Run 的交付结果及全部已受理费用。
Firecrawl 数据源返回原生 Run 输出，不切换数据提供商。Fetch Solution 增加了路由、结构检查、格式检查和共享请求预算。其 search/scrape 响应遵循上述规范化契约。可选的 metadata 保存追踪值，不影响数据提供商选择或价格。