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

Google Play 應用程式交集（即時）

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

DataForSEO

​

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

DataForSEO 操作

Google Play 應用程式交集（即時）

​

兩個或多個 Google Play 應用程式共同有排名的關鍵字。以 limit、offset 與 offset_token 分頁；翻過前幾頁後請改用該權杖。採用 DataForSEO 的信封結構：資料位於 tasks[0].result，結果狀態位於 tasks[0].status_code——被拒絕的請求仍會傳回 HTTP 200。post_dataforseo_labs_google_app_competitors_live 給出的是競爭對手，而此端點給出的是它們爭奪的領域。Apple 一側的對應端點：post_dataforseo_labs_apple_app_intersection_live。

計費參考

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

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

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

      目標應用程式的 ID
      必填欄位
      Google Play 上目標行動應用程式的 ID；
      可在 Google Play 中每個應用程式的 URL 中找到該 ID；
      範例：
      在 URL https://play.google.com/store/apps/details?id=org.telegram.messenger 中
      ID 為 org.telegram.messenger；
      ID 應以下列方式指定：
      "app_ids": {
      "1": "org.telegram.messenger",
      "2": "com.zhiliaoapp.musically"
      }
      若在此只指定一個 ID，API 將只傳回單一應用程式的結果；
      此物件中最多可指定 20 個應用程式 ID

      • propertyName
        類型: string | null
    • filters
      類型: array (object | null)[] | null

      結果篩選參數陣列
      選填欄位
      可同時新增多個篩選條件（最多 8 個）
      應在條件之間設定邏輯運算子 and、or
      支援以下運算子：
      <、<=、>、>=、=、<>、in、not_in
      範例：
      ["keyword_data.keyword_info.search_volume",">",500]

      [["keyword_data.keyword_info.search_volume","<>",500],"and",[intersection_result.382617920.rank_group",">=","10"]]

      有關篩選條件的更多資訊，請參閱 Dataforseo Labs - Filters 或這篇 說明中心指南

      空物件
    • 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 個關鍵字將被略過，並傳回後續關鍵字的資料

    • order_by
      類型: array string[] | null

      結果排序規則
      選填欄位
      可使用與 filters 陣列相同的值對結果排序；
      可能的排序類型：
      asc - 結果將依遞增順序排列；
      desc - 結果將依遞減順序排列；
      應使用逗號設定排序類型；
      範例：
      ["intersection_result.382617920.rank_absolute,asc"]
      注意：單次請求中最多可設定三條排序規則；
      應使用逗號分隔多條排序規則；
      範例：
      ["intersection_result.382617920.rank_absolute,desc","keyword_data.keyword_info.search_volume,asc"]
      預設規則：
      ["keyword_data.keyword_info.search_volume,desc"]
      注意：如果 item_types 陣列包含 organic 以外的項目類型，結果將依陣列中的第一個項目類型排序

    • tag
      類型: string | null

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

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

      任務總費用，美元

    • status_code
      類型: integer | null

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

    • status_message
      類型: string | null

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

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

      任務陣列

      • 類型: object | null · Response36Afe1097B20_DataforseoLabsGoogleAppIntersectionLiveTaskInfo
        • 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

          結果陣列

          • app_ids
            類型: object | null

            POST 陣列中的應用程式 ID

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

            包含與 app_id 欄位中指定應用程式之排名關鍵字相關的資料

            • intersection_result
              類型: object | null

              包含針對傳回的 keyword 的 SERP 資料
              資料會依你在設定任務時於 app_ids 物件中指定的每個應用程式 ID，分別放在不同陣列中；
              視指定的應用程式 ID 數量而定，可包含 1 到 20 個對應命名的陣列

              • propertyName
                類型: object | null · Response36Afe1097B20_GooglePlaySearchOrganic
                • app_id
                  類型: string | null

                  POST 陣列中的應用程式 ID

                • developer
                  類型: string | null

                  應用程式開發者的名稱

                • developer_url
                  類型: string | null

                  Google Play 上開發者頁面的 URL

                • icon
                  類型: string | null

                  應用程式圖示的 URL

                • is_free
                  類型: boolean | null
                • position
                  類型: string | null

                  元素在 SERP 中的對齊方式
                  可取下列值：
                  left、right

                • price
                  類型: object | null · Response36Afe1097B20_PriceInfo
                  • currency
                    類型: string | null

                    所列價格的貨幣 套用於該價格的貨幣 ISO 代碼

                  • current
                    類型: number | null 格式: double

                    目前價格 表示結果中所展示產品或服務的目前價格

                  • displayed_price
                    類型: string | null

                    結果中的價格字串 結果中提供的原始價格字串

                  • is_price_range
                    類型: boolean | null

                    價格以區間形式提供 表示價格是否以區間形式提供

                  • max_value
                    類型: number | null 格式: double

                    最高價格 結果中所示產品或服務的最高價格

                  • regular
                    類型: number | null 格式: double

                    一般價格 表示未套用任何折扣的產品或服務一般價格

                • rank_absolute
                  類型: integer | null

                  SERP 中的絕對排名
                  SERP 中所有元素中的絕對位置

                • rank_group
                  類型: integer | null

                  具有相同 type 值的元素群組內的位置
                  不同 type 值的元素位置不計入 rank_group

                • rating
                  類型: object | null · Response36Afe1097B20_RatingInfo

                  應用程式的平均評分

                  • rating_max
                    類型: integer | null

                    rating_type 的最大值

                  • rating_type
                    類型: string | null

                    評分類型 此處可以找到下列元素：Max5、Percents、CustomMax

                  • value
                    類型: number | null 格式: double

                    評分的值

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

                    回饋數量

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

                  應用程式的總評論數

                • title
                  類型: string | null

                  應用程式的標題

                • type
                  類型: string | null

                  元素類型

                • url
                  類型: string | null

                  Google Play 上應用程式頁面的 URL

            • keyword_data
              類型: object | null · Response36Afe1097B20_KeywordDataInfo

              傳回關鍵字的關鍵字資料

              • avg_backlinks_info
                類型: object | null · Response36Afe1097B20_AvgBacklinksInfo

                傳回關鍵字的反向連結資料
                此物件提供平均反向連結數、引用頁面數與網域數，以及該關鍵字自然排名前 10 網站的平均排名值

                • backlinks
                  類型: number | null

                  平均反向連結數

                • dofollow
                  類型: number | null

                  平均 dofollow 連結數

                • last_updated_time
                  類型: string | null

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

                • main_domain_rank
                  類型: number | null

                  平均主要網域排名
                  在這篇說明中心文章中進一步瞭解此指標及其計算公式

                • rank
                  類型: number | null

                  平均排名
                  如需進一步瞭解該指標及其計算方式，請參閱這篇說明中心文章

                • referring_domains
                  類型: number | null

                  平均引薦網域數量

                • referring_main_domains
                  類型: number | null

                  平均引薦主網域數量

                • referring_pages
                  類型: number | null

                  平均引薦頁面數量

                • se_type
                  類型: string | null

                  搜尋引擎類型

              • clickstream_keyword_info
                類型: object | null · Response36Afe1097B20_ClickstreamKeywordInfo

                傳回關鍵字的點擊流資料
                若要取得此欄位的結果，參數 include_clickstream_data 必須設為 true

                • age_distribution
                  類型: object | null

                  依年齡分佈的點擊流指標
                  如需瞭解該指標的計算方式，請參閱這篇說明中心文章

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

                    Signed 64-bit integers (long type).

                • gender_distribution
                  類型: object | null

                  依性別分佈的點擊流估算指標
                  如需瞭解該指標的計算方式，請參閱這篇說明中心文章

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

                    Signed 64-bit integers (long type).

                • last_updated_time
                  類型: string | null

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

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

                  每月搜尋量
                  表示該關鍵字概念在指定地理位置的（約略）搜尋次數（根據過去十二個月的資料）

                  • month
                    類型: integer | null

                    月

                  • search_volume
                    類型: integer | null

                    每月平均搜尋量

                  • year
                    類型: integer | null

                    年

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

                  平均每月搜尋量
                  表示該關鍵字概念在 google.com 上的（約略）搜尋次數

              • keyword
                類型: string | null

                傳回的關鍵字想法

              • keyword_info
                類型: object | null · Response36Afe1097B20_KeywordInfo

                傳回關鍵字想法的關鍵字資料

                • categories
                  類型: array integer[] | null

                  產品與服務類別
                  你可以下載所有可能類別的完整清單

                • competition
                  類型: number | null

                  競爭
                  代表與指定關鍵字相關的相對競爭程度。此值根據 Google Ads 資料，介於 0 與 1 之間（含 0 與 1）

                • competition_level
                  類型: string | null

                  競爭程度
                  僅代表指定關鍵字在付費 SERP 中的相對競爭程度；
                  可能的值：LOW、MEDIUM、HIGH
                  若競爭程度未知，該值為 null；
                  在這篇說明中心文章中進一步瞭解此指標

                • cpc
                  類型: number | null

                  每次點擊費用
                  代表該關鍵字歷來平均每次點擊費用（美元）

                • high_top_of_page_bid
                  類型: number | null

                  廣告顯示於首頁頂端的最高出價
                  代表高於約 80% 廣告得以顯示之最低出價的值（根據 Google Ads 的廣告主統計資料）
                  此值可能因 POST 請求中指定的地點而異

                • last_updated_time
                  類型: string | null

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

                • low_top_of_page_bid
                  類型: number | null

                  廣告顯示於首頁頂端的最低出價
                  代表高於約 20% 廣告得以顯示之最低出價的值（根據 Google Ads 的廣告主統計資料）
                  此值可能因 POST 請求中指定的地點而異

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

                  每月搜尋量
                  表示該關鍵字概念在指定地理位置的（約略）搜尋次數（根據過去十二個月的資料）

                  • month
                    類型: integer | null

                    月

                  • search_volume
                    類型: integer | null

                    每月平均搜尋量

                  • year
                    類型: integer | null

                    年

                • se_type
                  類型: string | null

                  搜尋引擎類型

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

                  平均每月搜尋量
                  表示該關鍵字概念在 google.com 上的（約略）搜尋次數

                • search_volume_trend
                  類型: object | null · Response36Afe1097B20_SearchVolumeTrend

                  搜尋量趨勢變化
                  代表與上一期間相比的搜尋量變化百分比

                  • monthly
                    類型: integer | null

                    搜尋量相較上個月的百分比變化

                  • quarterly
                    類型: integer | null

                    搜尋量相較上一季的百分比變化

                  • yearly
                    類型: integer | null

                    搜尋量相較去年的百分比變化

              • keyword_info_normalized_with_bing
                類型: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

                包含以 Bing 搜尋量標準化的關鍵字搜尋量

                • is_normalized
                  類型: boolean | null

                  關鍵字資訊已正規化 若為 true，數值會使用 Bing 資料正規化

                • last_updated_time
                  類型: string | null

                  資料集更新日期與時間 UTC 格式：「yyyy-mm-dd hh-mm-ss +00:00」 範例： 2019-11-15 12:57:46 +00:00

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

                  每月搜尋量 物件陣列，包含一年中某個月的搜尋量

                  • month
                    類型: integer | null

                    月

                  • search_volume
                    類型: integer | null

                    每月平均搜尋量

                  • year
                    類型: integer | null

                    年

                • search_volume
                  類型: integer | null

                  關鍵字的目前搜尋量

              • keyword_info_normalized_with_clickstream
                類型: object | null · Response36Afe1097B20_KeywordInfoNormalizedWithInfo

                包含以點擊流資料標準化的關鍵字搜尋量

                • is_normalized
                  類型: boolean | null

                  關鍵字資訊已正規化 若為 true，數值會使用 Bing 資料正規化

                • last_updated_time
                  類型: string | null

                  資料集更新日期與時間 UTC 格式：「yyyy-mm-dd hh-mm-ss +00:00」 範例： 2019-11-15 12:57:46 +00:00

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

                  每月搜尋量 物件陣列，包含一年中某個月的搜尋量

                  • month
                    類型: integer | null

                    月

                  • search_volume
                    類型: integer | null

                    每月平均搜尋量

                  • year
                    類型: integer | null

                    年

                • search_volume
                  類型: integer | null

                  關鍵字的目前搜尋量

              • keyword_properties
                類型: object | null · Response36Afe1097B20_KeywordProperties

                關鍵字的額外資訊

                • core_keyword
                  類型: string | null

                  群組中的主關鍵字
                  包含由同義字叢集演算法決定的群組主關鍵字
                  若值為 null，表示我們的資料庫中沒有對應演算法可辨識為與 keyword 同義的關鍵字

                • detected_language
                  類型: string | null

                  偵測到的關鍵字語言
                  代表系統辨識出的關鍵字語言

                • is_another_language
                  類型: boolean | null

                  偵測到的關鍵字語言與設定的語言不同
                  若為 true，表示請求中設定的語言與系統為指定關鍵字判定的語言不一致

                • keyword_difficulty
                  類型: integer | null

                  關鍵字進入前 10 個自然搜尋結果排名的難度
                  代表關鍵字進入前 10 個自然搜尋結果的機會，採用 0 到 100 的對數刻度；
                  計算時會分析 SERP 前 10 個頁面的連結概況等參數；
                  在這篇說明中心指南中進一步瞭解此指標

                • se_type
                  類型: string | null

                  搜尋引擎類型

                • synonym_clustering_algorithm
                  類型: string | null

                  用於辨識同義字的演算法
                  可能的值：
                  keyword_metrics - 表示以 keyword_info 參數為基礎的演算法
                  text_processing - 表示以文字為基礎的演算法
                  若值為 null，表示我們的資料庫中沒有對應演算法可辨識為與 keyword 同義的關鍵字

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

                  關鍵字中的字數
                  表示該關鍵字由多少個詞組成

              • language_code
                類型: string | null

                POST 陣列中的語言代碼

              • location_code
                類型: integer | null

                POST 陣列中的位置代碼

              • se_type
                類型: string | null

                搜尋引擎類型

              • search_intent_info
                類型: object | null · Response36Afe1097B20_SearchIntentInfo

                傳回關鍵字的搜尋意圖資訊
                可於這篇說明中心文章中瞭解搜尋意圖

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

                  補充搜尋意圖
                  可能的值：informational、navigational、commercial、transactional

                • last_updated_time
                  類型: string | null

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

                • main_intent
                  類型: string | null

                  主要搜尋意圖
                  可能的值：informational、navigational、commercial、transactional

                • se_type
                  類型: string | null

                  搜尋引擎類型

              • serp_info
                類型: object | null · Response36Afe1097B20_SerpInfo

                SERP 資料
                此值為 null 的情況包括：未在 POST 陣列中將 include_serp_info 設為 true，或我們的資料庫中沒有此關鍵字的 SERP 資料

                • check_url
                  類型: string | null

                  搜尋引擎結果的直接 URL
                  可用來確認我們提供了準確的結果

                • last_updated_time
                  類型: string | null

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

                • previous_updated_time
                  類型: string | null

                  SERP 資料在最近一次更新之前的日期與時間
                  採用 UTC 格式：“yyyy-mm-dd hh-mm-ss +00:00”
                  範例：
                  2019-10-15 12:57:46 +00:00

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

                  傳回關鍵字的搜尋結果數

                • se_type
                  類型: string | null

                  搜尋引擎類型

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

                  SERP 中的搜尋結果類型
                  包含在 SERP 中找到的搜尋結果類型（items）
                  可能的項目類型：
                  answer_box、app、carousel、multi_carousel、featured_snippet、google_flights、google_reviews、third_party_reviews、google_posts、images、jobs、knowledge_graph、local_pack、hotels_pack、map、organic、paid、people_also_ask、related_searches、people_also_search、shopping、top_stories、twitter、video、events、mention_carousel、recipes、top_sights、scholarly_articles、popular_products、podcasts、questions_and_answers、find_results_on、stocks_box、visual_stories、commercial_units、local_services、google_hotels、math_solver、currency_box、product_considerations、found_on_web、short_videos、refine_products、explore_brands、perspectives、discussions_and_forums、compare_sites、courses、ai_overview；
                  注意，實際結果僅針對 organic、paid、featured_snippet 與 local_pack 元素傳回

            • se_type
              類型: string | null

              搜尋引擎類型

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

            items 陣列中傳回的結果數

          • language_code
            類型: string | null

            POST 陣列中的語言代碼

          • location_code
            類型: integer | null

            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/google/app_intersection/live
curl https://openapi.felo.ai/v1/beta/dataforseo/dataforseo_labs/google/app_intersection/live \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '[
  {
    "app_ids": {
      "1": "686449807",
      "2": "382617920"
    },
    "language_name": "English",
    "location_code": 2840,
    "limit": 10
  }
]'

{
  "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,
          "app_ids": null,
          "location_code": null,
          "language_code": null,
          "total_count": null,
          "items_count": null,
          "items": [
            {
              "se_type": null,
              "keyword_data": "[Max Depth Exceeded]",
              "intersection_result": null
            }
          ]
        }
      ]
    }
  ]
}

操作成功

Google Play App Intersection Live

需要協助嗎？