ソーシャルシェアカウントAPI
Social Share Count APIを使用すると、URLの合計共有アクティビティにアクセスできます。ソーシャルボタンやアプリケーション内の任意の場所にシェアカウントを表示するために使用します。
概要
ShareThis は、ShareThis ボタンを通じて、300万以上のサイトからなる広大なネットワーク上のURLのシェア関連のアクティビティを取得しています。このデータには、主にユーザーのシェアと、ソーシャルネットワーク内で共有されたリンクをクリックした友人からの訪問が含まれます。このAPIにより、クライアントアプリケーションは指定したURLのデータにアクセスすることができます。
使用例としては、ソーシャル・シェアリング・メトリクスに基づいてURLの人気度を判断したり、シェアリング・アクティビティのカウンターを表示したり、ソーシャル・データを処理/解析するアプリケーションなどがあります。
セットアップ
あなたのウェブサイトでSocial Countsを有効にするためには ShareThis スクリプト には、共有ボタンの div タグが含まれています。Web Share API を使って独自のボタンを実装したい場合は、CSS で div タグを "display:none" に設定することができます。スクリプトとタグを追加しないと、ソーシャルカウントの計算でエラーが発生します。
URL情報の取得
エンドポイント
count-server.sharethis.com/v2.0/get_counts?url=<url>
シェアカウントAPIは、URLという1つのパラメータを受け取ります。
例
count-server.sharethis.com/v2.0/get_counts?url=https://www.sharethis.com
これにより、sharethis.comのURLに対するすべてのシェアが返されます。
レガシーAPIエンドポイントを使用する場合
パブリッシャーがレガシーなウィジェット(wd.sharethis.com)を使用している場合は、以下のように変更してください。
count-server.sharethis.com/v2.0/get_counts?wd=true&url=<url>
新しいエンドポイントと従来のエンドポイントのレスポンスの違いは?
REST APIエンドポイントレスポンス
- インバウンドは新しいAPIではクリックと呼ばれています。
- アウトバウンドは新APIの株式と呼ばれる
REST API | カウントサーバー |
インバウンド | クリック |
アウトバウンド | 株 |
total : { “inbound”: 0, “outbound”: 0} | { “clicks”: {“all” : 0}, “shares”: {“all”: 0}} |