Go SDK 使用说明

本指南介绍如何安装 Dataify Go SDK 并调用其全部功能：SERP 搜索引擎（Google、Bing、Yandex、DuckDuckGo、Google Images / News / Maps 等）、平台专用采集（Amazon、LinkedIn、Instagram、TikTok、YouTube、Reddit、Twitter、Airbnb、Booking、Crunchbase、eBay、Facebook、GitHub、Glassdoor、Indeed、Walmart、Zillow、Google Maps 等）、Web Unlocker。

安装与配置

导入时使用包名 dataify：

配置

须提供 Dataify API Token。可在 Dataify 控制台获取。

选项 1：环境变量（推荐）

选项 2：直接初始化

可选配置（functional options）：

缺少 token 时，请求会返回 dataify.ErrMissingToken。

基本用法

client.<Service>.<Method>(ctx, <Request>) —— service 对应平台，method 对应工具，request 为强类型结构体：

发起搜索引擎（SERP）

SERP 方法挂在 client.<Engine>.<Method> 下。

Google 搜索

Google 图片

Google 新闻 / 趋势 / 地图

Bing 搜索

全部 SERP 方法见 go doc github.com/dataify-server/dataify-sdk-go Google（含 Search / Images / News / Maps / Trends / Shopping / Finance / Flights / Scholar / Videos 等）。

平台专用采集（Scrapers）

采集方法挂在 client.<Platform>.<Method> 下，request 为强类型结构体。以下按平台分列：

Amazon

Instagram / YouTube / Walmart

可用服务（service）一览

Client 上挂载的 service 字段：

Airbnb · Amazon · Bing · Booking · Crunchbase · DuckDuckGo · EBay · Facebook · GitHub · Glassdoor · Google · Indeed · Instagram · LinkedIn · Reddit · TikTok · Twitter · Walmart · WebUnlocker · Yandex · YouTube · Zillow

每个 service 提供若干工具方法（例如 Amazon 下有 Product / Comment / Seller / ProductList）。全部工具的方法名与请求结构体字段以 go doc github.com/dataify-server/dataify-sdk-go 为准。

Web Unlocker

字段名以 go doc github.com/dataify-server/dataify-sdk-go.RequestWebUnlockerRequest 为准（URL / Type / JsRender / BlockResources / CleanContent / Country / Headers / Cookies / Wait / WaitFor / FollowRedirect）。

返回值与错误处理

所有工具方法返回 (*RawResponse, error)。成功响应 RawResponse 仅提供读取方法：Bytes() []byte、String() string、Decode(v any) error（没有 Body() 方法，也没有 StatusCode 字段）。

网络/上游错误返回 *dataify.APIError（含 StatusCode int 与 Body []byte）。注意 StatusCode/Body 是 APIError（出错时） 的字段，不是成功响应 RawResponse 的字段。

安全注意事项

Token 等同于账号凭证，不要提交到代码仓库；推荐使用环境变量 DATAIFY_TOKEN。

本 SDK 为纯服务端库，请勿将其编译进会被反编译分发的客户端。

推荐架构：前端 → 你的后端 → dataify → Dataify APIs。

类型提示与编辑器支持（IntelliSense）

Go 为静态类型语言，所有 request 结构体字段、StatusCode 等均有编译器校验。在 VS Code（Go 插件）/ GoLand 中将鼠标悬停在 client.Google.Search、dataify.GoogleSearchRequest 等上即可看到完整字段与文档。完整 API 以命令行查询为准：

完整示例

资源

资源	说明	链接
📘 GitHub 仓库	查看源码、示例并做出贡献	GitHub
📦 Go 模块	模块文档与版本说明	dataify-sdk-go

Go SDK 使用说明

安装与配置#

配置#

基本用法#

发起搜索引擎（SERP）#

Google 搜索#

Google 图片#

Google 新闻 / 趋势 / 地图#

Bing 搜索#

平台专用采集（Scrapers）#

Amazon#

LinkedIn#

Instagram / YouTube / Walmart#

可用服务（service）一览#

Web Unlocker#

返回值与错误处理#

安全注意事项#

类型提示与编辑器支持（IntelliSense）#

完整示例#

资源#