API Description

競合 SEO/PPC 調査

競合 SEO/PPC 調査 API では、競合サイトとそのキーワードの統計をオーガニック検索と有料検索結果から取得する事ができる便利なフォームです。

このセクションにアクセスするには、有料プランを利用中か、またはアカウントの残高が必要となります。

エラー

HTTP コード エラー メッセージ
403Empty balance
403 Licence expired

ドメイン 概要 (選択したデータベース)

説明

このメソッドは、選択されたデータベースに関する有料・オーガニックトラフィックのキーワード統計データを返します。

リクエスト フォーマット

Title of the code block
コピー
GET https://api4.seranking.com/research/{source}/overview/?domain=domain.com

リクエスト パラメータ

名前 必須 説明
source はいチェック対象の国の Alpha-2 code
domain はい td> ドメイン

結果

成功すると、サーバーは指定されたデータベースのオーガニック・有料トラフィックのキーワード統計を返します。

例

Title of the code block
コピー
{

    "organic": {

        "base_domain":"domain.com",

        "keywords_new_count": 182,

        "keywords_up_count": 292,

        "keywords_equal_count": 55,

        "keywords_lost_count": 282,

        "top11_20": 127,

        "top51_100": 331,

        "keywords_down_count": 558,

        "top1_5": 25,

        "top21_50": 270,

        "top6_10": 52,

        "keywords_count": 790,

        "traffic_sum": 3149,

        "price_sum": 23167.97,

        "year": 2022,

        "month": 8

    },

    "adv": {

        "base_domain":"domain.com",

        "keywords_new_count": 91,

        "keywords_up_count": 17,

        "keywords_equal_count": 18,

        "keywords_lost_count": 62,

        "top11_20": 0,

        "top1_2": 53,

        "top51_100": 0,

        "keywords_down_count": 76,

        "top1_5": 121,

        "top21_50": 0,

        "top3_5": 68,

        "top6_8": 19,

        "top9_11": 0,

        "top6_10": 19,

        "keywords_count": 140,

        "traffic_sum": 2968,

        "price_sum":17795.26,

        "year": 2022,

        "month": 8

    }

}

レスポンス パラメータ

名前 説明
organic オーガニック トラフィック データ
adv 有料 トラフィック データ
base_domainドメイン
keywords_count キーワード合計数
traffic_sum トラフィック予測
price_sum コスト予測
top1_5 1-5 内のキーワード合計数
top6_10 6-10 内のキーワード合計数
top11_20 11-20 内のキーワード合計数
top1_2 1-2 位に位置するキーワードの合計数 (有料トラフィックで)
top3_5 3-5 位に位置するキーワードの合計数 (有料トラフィックで)
top6_8 6-8 位に位置するキーワードの合計数 (有料トラフィックで)
top9_11 9-11 位に位置するキーワードの合計数 (有料トラフィックで)
keywords_ new_count キーワードの合計数
keywords_ lost_count 検索結果圏外にドロップしたキーワード合計数
keywords_ equal_count 順位変化無し
keywords_ up_count 順位上昇
keywords_ down_count 順位下降
year年
month月

エラー

HTTP コード エラー メッセージ
400 Invalid domain
400 Invalid source

ドメイン 概要 (履歴)

説明

本メソッドは、オーガニック・有料トラフィックに関するパラメータ（キーワード数、クリック、コスト）の履歴データを取得する事ができます。

リクエスト フォーマット

Title of the code block
コピー
GET https://api4.seranking.com/research/{source}/overview/history/?domain=domain.com&type=organic

リクエスト パラメータ

名前 必須 説明
source はいチェック対象の国の Alpha-2 code
domain はい ドメイン
type いいえ organic – オーガニックトラフィックデータ (デフォルト) adv – 有料トラフィックデータ

結果

成功すると、サーバーはオーガニック・有料トラフィックに関するパラメータの履歴データを返します。

例:

Title of the code block
コピー
[

   {

    "keywords_count": 51,

    "traffic_sum": 184,

    "price_sum": 1095.87,

    "year": 2016,

    "month": 9,

    "top1_2": 13,

    "top3_5": 18,

    "top6_8": 20,

    "top9_11": 0

   },

...

]

レスポンス パラメータ

名前 説明
keywords_count キーワード数
traffic_sum トラフィック予測
price_sum コスト予測
year 年
month 月
top1_5 1-5 内のキーワード合計数
top6_10 6-10 内のキーワード合計数
top11_20 11-20 内のキーワード合計数
top21_50 21-50 内のキーワード合計数
top51_100 51-100 内のキーワード合計数
top1_2 1-2 位に位置するキーワードの合計数 (有料トラフィックで)
top3_5 3-5 位に位置するキーワードの合計数 (有料トラフィックで)
top6_8 6-8 位に位置するキーワードの合計数 (有料トラフィックで)
top9_11 9-11 位に位置するキーワードの合計数 (有料トラフィックで)

エラー

HTTP コード エラー メッセージ
400無効なドメイン
404無効なソース

ドメイン概要 (ワールドワイド)

説明

このメソッドでは、現在の月のドメインの全世界統計を取得できます。

リクエスト フォーマット

Title of the code block
コピー
GET https://api4.seranking.com/research/worldwide-overview?domain=seranking.com&fields=price,traffic,keywords,positions_diff,positions_tops&show_zones_list=0¤cy=USD

リクエスト パラメータ

名称必須説明
domainはいドメイン
currencyいいえISO 4217 通過コード。初期値: USD
fieldsいいえカンマ区切りの想定されるフィールドのリスト。
初期値: price,traffic,keywords.

フィールド値のリスト:
price – トラフィック費用値を表示
traffic – トラフィック値を表示
keywords – キーワード統計を表示
positions_diff – 順位変動フィールドを表示
positions_tops – トップ順位の表示
show_zones_list いいえ 昇順 または 降順 (デフォルト)

結果

成功した場合、サーバーはオーガニックと広告の統計リストを返します。リストには、全世界の統計とゾーンごとの統計（show_zones_listが1の場合）が含まれます。

例:

Title of the code block
コピー
[

{

    "organic": [

        {

            "source": "worldwide",

            "country": "Worldwide",

            "keywords_count": 823967,

            "traffic_sum": 273150,

            "price_sum": 241482.11,

            "positions_new_count": 56042,

            "positions_up_count": 56326,

            "positions_down_count": 49834,

            "positions_lost_count": 47169,

            "positions_equal_count": 876005,

            "positions_tops": {

                "top1_5": 91520,

                "top6_10": 95652,

                "top11_20": 165641,

                "top21_50": 332015,

                "top51_100": 353061

            }

        },

        ...

    ],

    "adv": [

        {

            "source": "worldwide",

            "country": "Worldwide",

            "keywords_count": 4947,

            "traffic_sum": 4369,

            "price_sum": 6509.45,

            "positions_new_count": 333,

            "positions_up_count": 7,

            "positions_down_count": 4,

            "positions_lost_count": 1742,

            "positions_equal_count": 5645,

            "positions_tops": {

                "top1_2": 4905,

                "top3_5": 1046,

                "top6_8": 38,

                "top9_11": 0

            }

        },

        ...

    ]

}

]

ドメイン キーワード

説明

本メソッドは、ドメインに関するキーワードのリストを取得します。

リクエスト フォーマット

Title of the code block
コピー
GET https://api4.seranking.com/research/{source}/keywords/?domain=domain.com&type=organic&order_field=position&order_type=desc&cols=position,prev_pos

リクエスト パラメータ

名前 必須 説明
source はいチェック対象の国の Alpha-2 code
domain はい ドメイン
type いいえ organic – オーガニックトラフィックデータ (デフォルト) adv – 有料トラフィックデータ
order_field いいえ ソート項目 (デフォルトではトラフィック)
order_type いいえ 昇順 または 降順 (デフォルト)
page いいえ 結果ページ (デフォルト – 1)
limit いいえ 要素の数 (デフォルト – 100, 最大. 1000)
cols いいえ 返される値のリスト (カンマ区切り)
pos_change いいえ順位変化フィルタ
up – 順位上昇
down – 順位下降
new – 検索結果 初登場
lost – 検索圏外に下降
same – 順位変化無し

結果

I成功すると、サーバーはそのパラメータとドメインに関するキーワードのリストを返します。

例

Title of the code block
コピー
[

 {

    "keyword": "seranking.com",

    "position": 1,

    "prev_pos": 1,

    "volume": 10,

    "cpc": 0.00,

    "competition": 0.00,

    "url": "https://seranking.com/",

    "total_sites": 88,

    "traffic": 3,

    "traffic_percent": 11.11,

    "price": 0

},

...

]

レスポンス パラメータ

名前 説明
keyword キーワード
position 順位
prev_pos 前月の順位
volume ボリューム
cpcCPC
competition 競合性
urlURL
total_sites クエリに関するサイトの合計数
traffic トラフィック
traffic_prercent トラフィックのシェア
price コスト

有料トラフィック (type=adv)に関しては、上記のパラメータに加え、広告に関する情報も取得できます。

例

Title of the code block
コピー
[

  {

"keyword": "nyc hotels",

"position": 4,

"prev_pos": 4,

"volume": 550000,

"cpc": 3.75,

"competition": 0.16,

"url": "https://www.booking.com/city/us/new-york.html",

"total_sites": 851000000,

"traffic": 11000,

"traffic_percent": 0.96,

"price": 41250,

"block": "top",

"snippet_num": 579,

"snippets_count": 1,

"snippet_title": "Hotels in New York, NY | Lowest Price Guarantee.‎",

"snippet_description": "Book your Hotel in New York NY online. No reservation costs. Great rates. 24/7 Customer Service. Hotels. Secure Booking. Villas. Hostels. No Booking Fees. Best Price Guarantee.",

"snippet_display_url": "www.booking.com/city/us/new-york.html"

},

...

]
block top | bottom – ad type
snippet_num 広告 ナンバー
snippet_count 広告の数
snippet_ title 広告 タイトル
snippet_ description 広告 テキスト
snippet_ display_url 表示される広告URL

エラー

HTTP コード エラー メッセージ
400 Incorrect order
400Row limit exceeded
400 Invalid domain
400 Invalid source

キーワードの有料広告

説明

本メソッドは、キーワードの有料広告の概要を取得する事ができます。

リクエスト フォーマット

Title of the code block
コピー
GET https://api4.seranking.com/research/{source}/advertising/?keyword=seo

リクエスト パラメータ

名前 必須 説明
keyword はい キーワード
from いいえ 期間開始時点の年月 (2017-01)
to いいえ 期間終了時点の年月 (2018-12)
page いいえ 結果ページ (デフォルト – 1)
limit いいえ 要素の数 (デフォルト – 100, 最大 100)

結果

成功すると、サーバーはキーワードに関する有料広告の概要を返します。

例

Title of the code block
コピー
[

    {

    "domain": "hotels.com",

    "ads_count": 19,

    "keywords_count": 78972,

    "traffic_sum": 3565364,

    "price_sum": 10411189,

    "snippets":

    {

        2018-11:

        {

            "position": 2,

            "snippet_title": "Booking | Hotels.com‎",

            "snippet_description": "Stay 10 nights & get 1 free! Redeem your reward night anytime, anywhere. Last Minute Hotel Deals. Exclusive Deals. Photos & Reviews. Price Guarantee. Earn Free Hotel Nights. Guest Reviews. No Cancellation Fees. Travel Guides. Luxury Hotels. Budget Hotels.",

            "snippet_display_url": "www.hotels.com/",

            "snippet_count": 1,

            "url": "https://www.hotels.com/"

        },

        ...

    }

},,

...

]

レスポンス パラメータ

名前 説明
domain ドメイン
ads_count 広告の数
keywords_count キーワード数
traffic_sum トラフィック
price_sum 予算
snippets ドメインの広告のリスト
snippet_num 広告ナンバー
snippet_count 広告の数
snippet_title 広告 タイトル
snippet_description 広告 テキスト
snippet_display_url 表示される広告URL/td>
url リンク

エラー

HTTP コード エラー メッセージ
400Row limit exceeded
400 Invalid domain
400 Invalid source

ドメインの有料広告

説明

本メソッドは、ドメインに関する有料広告の概要を取得します。

リクエスト フォーマット

Title of the code block
コピー
GET https://api4.seranking.com/research/{source}/advertising/?domain=booking.com
 リクエスト パラメータ
名前 必須 説明
domain はい ドメイン
from いいえ 期間開始時点の年月 (2017-01)
to いいえ 期間終了時点の年月 (2018-12)
page いいえ 結果ページ (デフォルト – 1)
limit いいえ 要素の数 (デフォルト – 100, 最大 100)

結果

成功すると、サーバーはドメインに関する有料広告の概要を返します。

例

Title of the code block
コピー
[{

 "keyword":"locanda vivaldi venice",

 "ads_count":24,

 "competition":0.39,

 "cpc":5.64,

 "volume":100,

 "traffic":47.9,

 "traffic_percent":0.51,

 "snippets":

    {

        2017-01:

        {

            "position":2,

            "snippet_title":"Locanda Vivaldi, Venice - Booking.com‎",

            "snippet_description":"Book at Locanda Vivaldi, Venice. No reservation costs. Great rates Amenities: Free Wifi, Non Smoking Rooms, 24 Hour Front Desk, Air Conditioning",

            "snippet_display_url":"www.booking.com/hotel/it/locanda-vivaldi.en.html?a",

            "snippet_count":1,

            "url":"http://www.booking.com/hotel/it/locanda-vivaldi.en.html?aid=311088"

        },

,

...

]

レスポンス パラメータ

名前 説明
keyword キーワード
ads_count 合計広告数
competition 競合性
cpcCPC
volume ボリューム
trafficトラフィック
traffic_percentトラフィックのシェア
snippets ドメインの広告のリスト
snippet_count 広告の数 ドメインの広告数 広告の数
snippet_title 広告 タイトル
snippet_description 広告 テキスト
snippet_display_url 表示される広告URL
url リンク

エラー

HTTP コード エラー メッセージ
400Row limit exceeded
400 Invalid domain
400 Invalid source

競合

説明

本メソッドは、競合のドメインのリストを取得します (最大 500)。

リクエスト フォーマット

Title of the code block
コピー
GET https://api4.seranking.com/research/{source}/competitors?domain=booking.com&type=adv

リクエスト パラメータ

名前 必須 説明
type いいえ organic – オーガニックトラフィックデータ (デフォルト) adv – 有料トラフィックデータ
domain はい ドメイン
big_players いいえ 0 – 主要な競合を隠す (デフォルト) 1 – 主要な競合を表示する
stats いいえ 0 – ドメインのリストと共通するキーワード数のみ (デフォルト) 1 – 追加 パラメータ

結果

成功すると、サーバーは競合ドメインのリストを返します。

例

Title of the code block
コピー
[

 {

  "domain": "tripadvisor.com",

  "common_keywords": 1076

},

...

]

..stats =1

Title of the code block
コピー
[

 {

  "domain": "tripadvisor.com",

  "common_keywords": 1076,

  "total_keywords": 2084,

  "missing_keywords":5450,

  "traffic_sum": 291,

  "price_sum": 40.12,

},

...

]

レスポンス パラメータ

名前 説明
common_keywords 対象のサイトとその競合で使用されているキーワード
domain ドメイン
total_keywords Googleのトップ100にランクしている競合のキーワード合計数
missing_keywords競合サイトではGoogle100位以内にランクしているが、分析対象のウェブサイトでは使用していない、または使用しているが検索エンジンのヴィジビリティが無いキーワード
traffic sum 既存キーワードに関する、サイトのトラフィックボリューム予測。予想されるCTR（クリックスルーレイト）、ボリューム、現在の順位から計算されます。
price_sum キーワード、コスト、トラフィックの値に基づく選択された広告の月額コストの予測値

エラー

HTTP コード エラー メッセージ
400 Invalid domain
400 Invalid source

ドメイン 比較

説明

本メソッドは、二つのドメインのキーワードリストを取得します。

リクエスト フォーマット

Title of the code block
コピー
GET https://api4.seranking.com/research/{source}/competitors/compare?domain=booking.com&compare=google.com&type=adv

リクエスト パラメータ

名前 必須 説明
type いいえ organic – オーガニックトラフィックデータ (デフォルト) adv – 有料トラフィックデータ
domain はい ドメイン
compare はい 競合ドメイン
page いいえ 結果ページ (デフォルト – 1)
limit いいえ 要素の数 (デフォルト – 100, 最大. 1000)
cols いいえ 返される値のリスト (カンマ区切り)
diff いいえ 0 – 比較するドメイン（domain と compare）で共通するキーワード (デフォルト) 1 – domain には無い compare ドメインのキーワード

結果

成功すると、サーバーは二つのドメインのキーワードリストを返します。

例

Title of the code block
コピー
[

  {

   "keyword": "haworth hotel holland mi",

   "volume": 10,

   "cpc": 3.01,

   "competition": 0.38,

   "difficulty": 5,

   "total_sites": 94,

   "position": 4,

   "url": "https://www.booking.com/hotel/us/haworth-inn-center.html",

   "price": 2.44,

   "traffic": 0.81,

   "compare_position": 5,

   "compare_url": "https://www.hotels.com/ho576868/haworth/",

   "compare_price": 1.84,

   "compare_traffic": 0.61

    },

...

]

レスポンス パラメータ

名前 説明
keyword 分析キーワード
competition 競合性
difficultyキーワード難易度
cpc CPC (クリック単価)
volume 指定キーワードのGoogle月間検索数
total_sites クエリに関するサイトの合計数
position 順位
url 指定キーワードでGoogleにランクされているページのURL
price コスト
traffic トラフィック
compare_position 比較されるドメインの順位
compare_url 比較されるドメインのページURL
compare_price 比較されるドメインのトラフィックコスト
compare_traffic 比較されるドメインのトラフィック

エラー

HTTP コード エラー メッセージ
400 Invalid domain
400 Invalid source