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

トレンド記事抽出

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

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

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

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

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

    記事取得

    各ジャンルの記事を取得します。

    テクニカルガイドライン

    • アクセスはHTTPリダイレクトされる可能性があります。
    • 記事数がnで指定された件数に満たない場合は、指定された件数以下でデータを返却します。

    リクエストURL

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

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

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

    キー 必須 説明
    genreId 表示設定されているジャンルIDを指定。
    lang - 記事およびジャンル情報の言語は、下記のいずれかを指定。
    ja : 日本語(省略時)
    en : 英語
    s - 記事一覧の開始番号を指定(1以上999999以下の整数)。
    省略時 : 1
    n - カテゴリ内の記事一覧の取得件数を指定(0以上50以下の整数)。
    省略時 : 10
    APIKEY APIにアクセスするアプリの認証に利用する。

    レスポンス(JSON形式)

    キー 必須 説明
    totalResults 記事の全件数(0以上の整数)。
    startIndex 取得記事の開始番号(1以上の整数)。
    itemsPerPage 取得記事の返却件数(0以上の整数)。
    issueDate 記事セットの作成時刻(YYYY-MM-DDThh:mm:ssTZD)。
    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を返却する。
    ※関連記事が存在しない場合、本項目は省略される。

    リクエストサンプル

    #日本語記事のジャンル1の記事を12件目から30件取得する場合
    GET https://api.apigw.smt.docomo.ne.jp/webCuration/v3/contents?genreId=1&s=12&n=30&APIKEY=1111111
    
    #英語記事のジャンル101の記事を1件目から10件取得する場合
    GET https://api.apigw.smt.docomo.ne.jp/webCuration/v3/contents?genreId=101&lang=en&s=1&APIKEY=1111111
    

    レスポンスサンプル

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