ホーム API/ツール API トレンド記事抽出

トレンド記事抽出

    トレンド記事抽出APIは、インターネット上のニュース記事やブログ記事から、独自のトレンド解析エンジンにより抽出された、注目度の高い記事の一覧を取得し提供します。
    本APIでは、dアカウントによるユーザ認証・認可を行うことで、さらに便利な機能をご利用いただくことができます。 なお、dアカウントはドコモユーザ以外のお客様でも取得できます。詳細に関してはこちらを参照ください。

    API
    基本情報
    提供 : REST, SDK(Android™,iOS,Server side JAVA)
    • 審査 : アプリ審査
    利用条件 : あり※1

    ※1「ガイドライン(必読)」に記載の利用条件に予め同意していただく必要がございます。

    ご利用いただくためには「アカウント登録(無料)」が必要です。

    リファレンスを参照するAPI機能名を選択してください

    関連記事取得

    指定した記事と内容が類似する記事を取得します。

    テクニカルガイドライン

    • アクセスはHTTPリダイレクトされる可能性があります。

    リクエストURL

    https://api.apigw.smt.docomo.ne.jp/webCuration/v3/relatedContents

    メソッド : GET
    文字コード : UTF-8

    リクエストクエリパラメータ

    キー 必須 説明
    contentId 関連記事を取得する記事の記事IDを指定。
    APIKEY APIにアクセスするアプリの認証に利用する。

    レスポンス(JSON形式)

    キー 必須 説明
    totalResults 関連記事の全件数(0以上の整数)。
    articleContents 関連記事の配列。
    ※関連記事が無い場合は、空配列を返却。
       contentId 記事IDは、すべての記事でユニークな値を返却。
    (long型 : 9223372036854775807まで)
    contentType - 記事種別は、下記を返却。
    10 : トレンド記事
    genreId ジャンルID(1以上の整数)。
    contentData 表示する記事。
       title 記事のタイトル。
    body - 記事のスニペット。
    ※記事に本文が含まれない場合、本項目は省略される。
    linkUrl 記事のURL。
    imageUrl - 記事に含まれる画像のURL。
    ※記事に画像が含まれない場合、本項目は省略される。
    imageSize - 記事に含まれる画像のサイズは、縦px,横pxを返却。
    ※記事に画像が含まれない場合、本項目は省略される。
    height 画像の縦ピクセル数。
    width 画像の横ピクセル数。
    createdDate 記事作成日時(YYYY-MM-DDThh:mm:ssTZD)。
    sourceDomain 配信元ドメイン。
    sourceName 配信元名称。
    relatedContents - 関連記事に対して、さらに関連記事が存在する場合はエンドポイントと記事IDを含むURLを返却する。
    ※関連記事が存在しない場合、本項目は省略される。

    リクエストサンプル

    #記事IDが100の記事の関連記事を取得する場合
    GET https://api.apigw.smt.docomo.ne.jp/webCuration/v3/relatedContents?contentId=100&APIKEY=1111111
    

    レスポンスサンプル

    {
    "totalResults" : 2,
    "articleContents" :[
      {
      "contentId" : 101,
      "contentType" : 10,
      "genreId" : 1
      "contentData" :
        {
        "title" : (記事のタイトル),
        "body" : (記事のスニペット),
        “linkUrl”: (記事のURL),
        "createdDate" : (記事の作成日時),
        "sourceDomain" : (記事のドメイン),
        "sourceName" : (記事の配信元名)
        }
      "relatedContents" :"https://api.apigw.smt.docomo.ne.jp/webCuration/v3/relatedContents?contentId=101"
      },
      {
      "contentId" : 105,
      "contentType" : 10,
      "genreId" : 1
      "contentData" :
        {
        "title" : (記事のタイトル),
        "body" : (記事のスニペット),
        “linkUrl”: (記事のURL),
        "createdDate" : (記事の作成日時),
        "sourceDomain" : (記事のドメイン),
        "sourceName" : (記事の配信元名)
        }
      "relatedContents" :"https://api.apigw.smt.docomo.ne.jp/webCuration/v3/relatedContents?contentId=105"
      }
      ]
    }
    
    よくあるご質問
    APIなどの各サービスに関するよくある質問を掲載します。
    お問い合わせ
    「docomo Developer support」及び「作ろうスマートフォン/iモードコンテンツ」に関するお問い合わせです。よくあるご質問や技術ブログで解決しない場合は、お問い合わせください。