Felo API PlatformFelo API Platform
全部 DataForSEO 端點
v0.2.0-beta
OpenAPI 3.1.0

相關關鍵字

Felo API Support
MIT
伺服器:https://openapi.felo.ai
用戶端程式庫
Shell Curl

DataForSEO

​

SEO, search-engine results, keyword research, backlinks and AI visibility data.

DataForSEO 操作

相關關鍵字

​

與種子關鍵字相關的 Amazon 搜尋詞。以 limit、offset 與 offset_token 分頁；翻過前幾頁後請改用該權杖。採用 DataForSEO 的信封結構：資料位於 tasks[0].result，結果狀態位於 tasks[0].status_code——被拒絕的請求仍會傳回 HTTP 200。Google 一側的對應端點是 post_dataforseo_labs_google_related_keywords_live；購物意圖與網頁意圖差異很大，不要將兩者互相替代。

計費參考

  • 計量方式：依回報的回應成本計量。
  • 參考請求估算：0.1356 美元。
  • 參考客戶倍率：1.0。不得對已結算的客戶金額再次套用。

僅供參考的中繼資料，並非帳戶報價、保證價格或消費上限。資源額度並非 Felo 額度。最終費用依 Felo 計費記錄為準。

請求本文
application/json
  • 類型: array (object | null)[]
    • depth
      類型: integer | null

      關鍵字搜尋深度
      選填欄位
      預設值：1；
      傳回的結果數量取決於此欄位設定的值；
      可指定 0 到 4 的層級；
      各層級的關鍵字數量估算（最大值）：
      0 - keyword 欄位中設定的關鍵字
      1 – 6 個關鍵字
      2 – 42 個關鍵字
      3 – 258 個關鍵字
      4 – 1554 個關鍵字

    • ignore_synonyms
      類型: boolean | null

      忽略高度相似的關鍵字
      選填欄位
      如果設為 true，則只傳回核心關鍵字，所有高度相似的關鍵字都會被排除；
      預設值：false

    • include_seed_keyword
      類型: boolean | null

      包含種子關鍵字的資料
      選填欄位
      如果設為 true，回應中的 seed_keyword_data 陣列將提供 keyword 欄位所指定種子關鍵字的資料
      預設值：false

    • keyword
      類型: string

      關鍵字
      必填欄位
      UTF-8 編碼
      關鍵字應使用小寫形式指定

      有關 DataForSEO API 中 keyword 與 keywords 欄位的規則與限制，請參閱這篇 說明中心文章

    • language_code
      類型: string | null

      語言代碼
      未指定 language_name 時為必填欄位
      注意：必須指定 language_name 或 language_code
      可個別向 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 發出請求，取得可用地點及其 language_code 的清單
      範例：
      en

    • language_name
      類型: string

      語言全名
      未指定 language_code 時為必填欄位
      注意：必須指定 language_name 或 language_code
      可個別向 https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 發出請求，取得可用地點及其 language_name 的清單
      範例：
      English

    • limit
      類型: integer | null

      傳回關鍵字數量上限
      選填欄位
      預設值：100
      最大值：1000

    • location_code
      類型: integer

      地點代碼
      未指定 location_name 時為必填欄位
      注意：必須指定 location_name 或 location_code
      可個別向
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 發出請求，取得可用地點及其 location_code 的清單；
      注意：此端點目前僅支援美國、埃及、沙烏地阿拉伯與阿拉伯聯合大公國的地點；
      範例：
      2840

    • location_name
      類型: string

      地點全名
      未指定 location_code 時為必填欄位
      注意：必須指定 location_name 或 location_code
      可個別向
      https://api.dataforseo.com/v3/dataforseo_labs/locations_and_languages 發出請求，取得可用地點及其 location_name 的清單；
      注意：此端點目前僅支援美國、埃及、沙烏地阿拉伯與阿拉伯聯合大公國的地點；
      範例：
      United States

    • offset
      類型: integer | null

      傳回的關鍵字在結果陣列中的位移量
      選填欄位
      預設值：0
      若指定 10，結果陣列中的前 10 個關鍵字將被略過，並傳回後續關鍵字的資料

    • tag
      類型: string | null

      使用者自訂任務識別碼
      選填欄位
      字元數上限為 255
      可使用此參數識別任務，並將其與結果對應
      可在回應的 data 物件中找到指定的 tag 值

回應
  • 200
    類型: object | null · Response36Afe1097B20_DataforseoLabsAmazonRelatedKeywordsLiveResponseInfo
    • cost
      類型: number | null 格式: double

      任務總費用，美元

    • status_code
      類型: integer | null

      一般狀態碼 完整回應碼清單請見此處

    • status_message
      類型: string | null

      一般資訊訊息 完整的一般資訊訊息清單請見此處

    • tasks
      類型: array (object | null)[] | null

      任務陣列

      • 類型: object | null · Response36Afe1097B20_DataforseoLabsAmazonRelatedKeywordsLiveTaskInfo
        • cost
          類型: number | null 格式: double

          任務總費用，美元

        • data
          類型: object | null

          包含你在 POST 請求中指定的相同參數

          • propertyName
            類型: object | null
        • id
          類型: string | null

          任務識別碼 我們系統中 UUID 格式的唯一任務識別碼

        • path
          類型: array (string | null)[] | null

          URL 路徑

        • result
          類型: array (object | null)[] | null

          結果陣列

          • items
            類型: array (object | null)[] | null

            包含關鍵字及相關資料的物件

            • depth
              類型: integer | null

              關鍵字搜尋深度

            • keyword_data
              類型: object | null · Response36Afe1097B20_AmazonKeywordData

              傳回關鍵字的關鍵字資料

              • keyword
                類型: string | null

                相關關鍵字

              • keyword_info
                類型: object | null · Response36Afe1097B20_AmazonKeywordInfo

                所傳回關鍵字的關鍵字資訊

                • last_updated_time
                  類型: string | null

                  關鍵字資料的更新日期與時間 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00” 範例： '2019-11-15 12:57:46 +00:00'

                • se_type
                  類型: string | null

                  搜尋引擎類型

                • search_volume
                  類型: integer | null 格式: int64

                  平均每月搜尋量比率 表示 Amazon 上所提供關鍵字構想的（近似）搜尋次數

              • language_code
                類型: string | null

                POST 陣列中的語言代碼

              • location_code
                類型: integer | null 格式: int64

                POST 陣列中的地點代碼

              • se_type
                類型: string | null

                搜尋引擎類型

            • related_keywords
              類型: array string[] | null

              相關關鍵字清單
              表示與上方陣列中傳回之關鍵字相關的搜尋查詢清單

            • se_type
              類型: string | null

              搜尋引擎類型

          • items_count
            類型: integer | null 格式: int64

            items 陣列中傳回的結果數

          • language_code
            類型: string | null

            POST 陣列中的語言代碼

          • location_code
            類型: integer | null

            POST 陣列中的位置代碼

          • se_type
            類型: string | null

            搜尋引擎類型

          • seed_keyword
            類型: string | null

            POST 陣列中的關鍵字

          • seed_keyword_data
            類型: object | null · Response36Afe1097B20_AmazonKeywordData

            種子關鍵字的關鍵字資料
            物件中的欄位與 keyword_data 相同

            • keyword
              類型: string | null

              相關關鍵字

            • keyword_info
              類型: object | null · Response36Afe1097B20_AmazonKeywordInfo

              所傳回關鍵字的關鍵字資訊

              • last_updated_time
                類型: string | null

                關鍵字資料的更新日期與時間 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00” 範例： '2019-11-15 12:57:46 +00:00'

              • se_type
                類型: string | null

                搜尋引擎類型

              • search_volume
                類型: integer | null 格式: int64

                平均每月搜尋量比率 表示 Amazon 上所提供關鍵字構想的（近似）搜尋次數

            • language_code
              類型: string | null

              POST 陣列中的語言代碼

            • location_code
              類型: integer | null 格式: int64

              POST 陣列中的地點代碼

            • se_type
              類型: string | null

              搜尋引擎類型

          • total_count
            類型: integer | null 格式: int64

            我們資料庫中與你的請求相關的結果總數

        • result_count
          類型: integer | null 格式: int64

          result 陣列中的元素數

        • status_code
          類型: integer | null

          任務的狀態碼 由 DataForSEO 產生，範圍如下：10000-60000 完整回應碼清單請見此處

        • status_message
          類型: string | null

          任務的資訊訊息 完整的一般資訊訊息清單請見此處

        • time
          類型: string | null

          執行時間，秒

    • tasks_count
      類型: integer | null 格式: int64

      tasks 陣列中的任務數

    • tasks_error
      類型: integer | null 格式: int64

      tasks 陣列中傳回錯誤的任務數

    • time
      類型: string | null

      總執行時間，秒

    • version
      類型: string | null

      API 的目前版本

    application/json
  • 400

    無法處理該要求。請檢查請求參數。

  • 401

    需要有效的 Felo API 金鑰。

  • 402

    由於未符合計費要求，要求無法繼續。

  • 403

    該帳戶無權執行此操作。

  • 429

    已達到要求或支出上限。

  • 502

    服務無法完成該要求。

  • 503

    API 或計費服務暫時無法使用。

  • 504

    服務在處理要求時逾時。

  • default

    錯誤回應；上游透傳回應可能採用供應商格式

    application/json
Request Example for post/v1/beta/dataforseo/dataforseo_labs/amazon/related_keywords/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/amazon/related_keywords/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "keyword": "computer mouse",
    "language_name": "English",
    "location_code": 2840,
    "limit": 5,
    "include_seed_keyword": true
  }
]'

{
  "version": null,
  "status_code": null,
  "status_message": null,
  "time": null,
  "cost": null,
  "tasks_count": null,
  "tasks_error": null,
  "tasks": [
    {
      "id": null,
      "status_code": null,
      "status_message": null,
      "time": null,
      "cost": null,
      "result_count": null,
      "path": [
        null
      ],
      "data": null,
      "result": [
        {
          "se_type": null,
          "seed_keyword": null,
          "seed_keyword_data": {
            "se_type": null,
            "keyword": null,
            "location_code": null,
            "language_code": null,
            "keyword_info": "[Max Depth Exceeded]"
          },
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "keyword_data": "[Max Depth Exceeded]",
              "depth": null,
              "related_keywords": [
                "[Max Depth Exceeded]"
              ]
            }
          ]
        }
      ]
    }
  ]
}

操作成功

Related Keywords

需要協助嗎？