關鍵字
必填欄位
在 keyword 欄位中最多可指定 700 個字元
所有 %## 都將被解碼（另外，字元 ‘+’ 會被解碼為空格字元）
如果需要在 keyword 中使用 “%” 字元，請將其指定為 “%25”；
如果需要在 keyword 中使用 “+” 字元，請將其指定為 “%2B”；
如果此欄位包含 ‘allinanchor:’、‘allintext:’、‘allintitle:’、‘allinurl:’、‘cache:’、‘define:’、‘filetype:’、‘id:’、‘inanchor:’、‘info:’、‘intext:’、‘intitle:’、‘inurl:’、‘link:’、‘site:’，每個任務的費用將乘以 5
有關 DataForSEO API 中 keyword 與 keywords 欄位的規則與限制，請參閱這篇說明中心文章
搜尋引擎地點代碼
未指定 location_name 或 location_coordinate 時為必填欄位
如果使用此欄位，則無需指定 location_name 或 location_coordinate
可個別向 https://api.dataforseo.com/v3/serp/google/locations 發出請求，取得搜尋引擎的可用地點及其 location_code 清單
範例：
2840
搜尋引擎語言代碼
未指定 language_name 時為必填欄位
如果使用此欄位，則無需指定 language_name
可個別向 https://api.dataforseo.com/v3/serp/google/languages 發出請求，取得搜尋引擎的可用語言及其 language_code 清單範例：en
解析深度
選填欄位
SERP 中的結果數量
預設值：10
最大值：700
將深度設為 10 以上可能會產生額外費用（如果搜尋引擎傳回超過 10 筆結果）；
費用可在 定價頁計算。" }, "device": { "type": [ "string", "null" ], "description": "
裝置類型
選填欄位
傳回特定裝置類型的結果
可取的值為：desktop、mobile
預設值：desktop
載入非同步 AI 概覽
選填欄位
設為 true 以取得 SERP 中的 ai_overview 項目，即使它們是非同步載入的；
如果設為 false，你將只能從快取中取得 ai_overview 項目；
預設值：false
注意：使用此參數將額外收取 $0.0006；
如果該元素不存在或包含 \"asynchronous_ai_overview\": false，所有額外費用將退還至你的帳戶餘額
任務完成通知 URL
選填欄位
任務完成後，我們會向你指定的 URL 傳送 GET 請求進行通知
可將 ‘$id’ 字串用作 $id 變數，將 ‘$tag’ 用作經 URL 編碼的 $tag 變數。傳送請求前我們會設定必要的值。
範例：
http://your-server.com/pingscript?id=$id
http://your-server.com/pingscript?id=$id&tag=$tag
注意：pingback_url 中的特殊字元會進行 URL 編碼；
例如，# 字元會編碼為 %23
詳情請參閱我們的說明中心
" }, "postback_url": { "type": [ "string", "null" ], "description": "用於傳送任務結果的 URL
選填欄位
任務完成後，我們會將結果以 gzip 格式壓縮，並向你指定的 postback_url 傳送 POST 請求
可將 ‘$id’ 字串用作 $id 變數，將 ‘$tag’ 用作經 URL 編碼的 $tag 變數。傳送請求前我們會設定必要的值
範例：
http://your-server.com/postbackscript?id=$id
http://your-server.com/postbackscript?id=$id&tag=$tag
注意：postback_url 中的特殊字元會進行 URL 編碼；
例如，# 字元會被編碼為 %23
詳情請參閱我們的 說明中心
" }, "postback_data": { "type": "string", "description": "postback_url 資料類型
指定 postback_url 時為必填欄位
對應於將傳送至你伺服器的資料類型
可取的值為：
regular、advanced、html
任務優先順序
選填欄位
可取以下值：
1 – 一般執行優先順序（預設設定）；
2 – 高執行優先順序
費用可在 定價頁計算。" }, "location_name": { "type": "string", "description": "
搜尋引擎地點全名
未指定 location_code 或 location_coordinate 時為必填欄位
如果使用此欄位，則無需指定 location_code 或 location_coordinate
可個別向 https://api.dataforseo.com/v3/serp/google/locations 發出請求，取得搜尋引擎的可用地點及其 location_name 清單
範例：
London,England,United Kingdom
地點的 GPS 座標
未指定 location_name 或 location_code 時為必填欄位
如果使用此欄位，則無需指定 location_name 或 location_code
location_coordinate 參數應採用 \"latitude,longitude,radius\" 格式
\"latitude\" 與 \"longitude\" 的最大小數位數：7
\"radius\" 的最小值：199（mm）
\"radius\" 的最大值：199999（mm）
範例：
53.476225,-2.243572,200
搜尋引擎語言全名
未指定 language_code 時為必填欄位
如果使用此欄位，則無需指定 language_code
可個別向 https://api.dataforseo.com/v3/serp/google/languages 發出請求，取得搜尋引擎的可用語言及其 language_name 清單
範例：
English
使用者自訂任務識別碼
選填欄位
字元數上限為 255
可使用此參數識別任務，並將其與結果對應
指定的 tag 值可在回應的 data 物件中找到
裝置作業系統
選填欄位
如果在 device 欄位中指定 desktop，請從以下值中選擇：windows、macos
預設值：windows
如果在 device 欄位中指定 mobile，請從以下值中選擇：android、ios
預設值：android
目標比對類型
指定 stop_crawl_on_match 時為必填欄位
match_value 的比對類型
可取的值：
domain – 特定網域或子網域
with_subdomains – 主網域和子網域
wildcard – 萬用字元模式
目標網域、子網域或萬用字元值
指定 stop_crawl_on_match 時為必填欄位
指定目標網域、子網域或萬用字元值；
注意：網域或子網域指定時不得包含請求通訊協定；
範例：\"match_value\": \"dataforseo.com\"，
\"match_value\": \"/blog/post-*\"
頁面擷取上限
選填欄位
要擷取的搜尋結果頁數
最大值：100
注意：每擷取一個頁面都會收費（每頁 10 筆自然結果）；
詳情請參閱我們的定價頁；
注意#2：max_crawl_pages 與 depth 參數彼此互補；
詳情請參閱我們的說明中心
" }, "search_param": { "type": [ "string", "null" ], "description": "搜尋查詢的附加參數
選填欄位
lr、cr、as_qdr、as_sitesearch、as_occt、as_filetype。"
},
"remove_from_url": {
"type": [
"array",
"null"
],
"items": {
"type": "string"
},
"description": "從 URL 中移除特定參數
選填欄位
使用此欄位，最多可指定 10 個要從結果 URL 中移除的參數
範例：
\"remove_from_url\": [\"srsltid\"]
展開 AI 概覽
選填欄位
設為 true 以展開 ai_overview 項目；
預設值：false；
注意：此參數僅適用於 HTML 任務結果
" }, "people_also_ask_click_depth": { "type": [ "integer", "null" ], "description": "相應元素上的點擊次數
選填欄位
指定 people_also_ask 元素上的點擊深度，以取得額外的 people_also_ask_element 項目；
注意 你的帳戶將按每次點擊額外計費 $0.00015，無論任務優先順序為何；
如果該元素不存在或我們執行的點擊次數少於你指定的次數，所有額外費用將退還至你的帳戶餘額
可取的值：1 到 4
顯示相關結果
選填欄位
如果設為 true，回應中的 related_result 元素將作為其父層自然結果的摘要提供；
如果設為 false，related_result 元素將作為個別的自然結果提供；
預設值：true
計算進階結果中 SERP 元素的像素排名
選填欄位
像素排名是指結果摘要與螢幕左上角之間的距離；
依預設，該參數設為 false
注意：使用此參數將額外收取 $0.0006
" }, "browser_screen_width": { "type": [ "integer", "null" ], "description": "瀏覽器螢幕寬度
選填欄位
你可以為特定裝置設定自訂瀏覽器螢幕寬度，以計算像素排名；
可指定範圍：240-9999；
依預設，該參數設為：
1920（desktop）；
360（mobile，android）；
375（mobile，iOS）；
注意：要使用此參數，請將 calculate_rectangles 設為 true
瀏覽器螢幕高度
選填欄位
你可以為特定裝置設定自訂瀏覽器螢幕高度，以計算像素排名；
可指定範圍：240-9999；
依預設，該參數設為：
1080（desktop）；
640（mobile，android）；
812（mobile，iOS）；
注意：要使用此參數，請將 calculate_rectangles 設為 true
瀏覽器螢幕解析度比例
選填欄位
你可以為特定裝置設定自訂瀏覽器螢幕解析度比例，以計算像素排名；
可指定範圍：0.5-3；
依預設，該參數設為：
1（desktop）；
3（mobile，android）；
3（mobile，iOS）；
注意：要使用此參數，請將 calculate_rectangles 設為 true
搜尋查詢的直接 URL
選填欄位
你可以指定一個直接 URL，我們會將其解析為必要欄位。請注意，此方法對我們的 API 而言處理難度最高，且要求你在 URL 中指定確切的語言和地點。大多數情況下，我們不建議使用此方法。
範例：
https://www.google.co.uk/search?q=%20rank%20tracker%20api&hl=en&gl=GB&uule=w+CAIQIFISCXXeIa8LoNhHEZkq1d1aOpZS
lr、cr、as_qdr、as_sitesearch、as_occt、as_filetype。"
},
"target_search_mode": {
"type": [
"string",
"null"
],
"description": "目標比對模式
選填欄位
要啟用此參數，還必須啟用 stop_crawl_on_match
定義在 stop_crawl_on_match 中指定多個目標時，爬取應如何停止
可能的值：all、any
all – 僅當找到所有指定目標時，爬取才停止
any – 找到任意單一目標時，爬取即停止
預設值：any
詳情請參閱我們 說明中心中的此參數說明
" }, "find_targets_in": { "type": [ "array", "null" ], "items": { "type": "string" }, "description": "要檢查目標的 SERP 元素類型
選填欄位
要啟用此參數，還必須啟用 stop_crawl_on_match
指定應檢查哪些 SERP 元素類型以比對目標
如果未指定，將檢查所有帶有 url 和 domain 欄位的第一層元素是否比對目標
可取的值：organic、paid、local_pack、featured_snippet、events、google_flights、images、jobs、knowledge_graph、local_service、map、scholarly_articles、third_party_reviews、twitter
注意：不能包含與 ignore_targets_in 相同的元素類型
範例：
\"find_targets_in\": [\"organic\", \"featured_snippet\"]
詳情請參閱我們說明中心中的此參數說明
" }, "ignore_targets_in": { "type": [ "array", "null" ], "items": { "type": "string" }, "description": "要從目標搜尋中排除的 SERP 元素類型
選填欄位
要啟用此參數，還必須啟用 stop_crawl_on_match
指定在搜尋目標比對時應排除哪些 SERP 元素類型
可取的值：organic、paid、local_pack、featured_snippet、events、google_flights、images、jobs、knowledge_graph、local_service、map、scholarly_articles、third_party_reviews、twitter
注意：不能包含與 find_targets_in 相同的元素類型
範例：
\"ignore_targets_in\": [\"paid\", \"images\"]
詳情請參閱我們說明中心中的此參數說明
" }, "se_domain": { "type": [ "string", "null" ], "description": "搜尋引擎網域
選填欄位
我們會根據你指定的地點和語言自動選擇相關的搜尋引擎網域
不過，你也可以在此欄位中設定自訂搜尋引擎網域
範例：
google.co.uk, google.com.au, google.de 等。
null"
}
}
}
]
}
```