開発者向け情報 - [パストラック(Pathtraq)]

開発者向け情報のインデックス

ニュースランキング取得API
カテゴリランキング取得API
キーワード・URL検索API
URL正規化API
ページカウンタAPI
ページチャートAPI
免責事項
クレジット表記
パストラックAPIを使ったサイトへのリンク集

ニュースランキング取得API

パストラックの人気のニュースランキングを取得するAPIです。ニュースジャンルの指定とスコープの指定が出来ます。ニュース自体についてはニュースに関するヘルプをご覧下さい。

リクエスト形式

URL

http://api.pathtraq.com/news_ja

リクエストパラメータ

全てクエリ変数として指定します。

api: (任意) json または rss を指定します。省略した場合は rss が指定されます。
genre: (任意) ニュースのジャンルを指定します。(ジャンル一覧) 省略するとニュース全体になります。
m: (任意) スコープ (popular: 定番, hot: 人気, upcoming: 注目) を指定します。省略すると hot になります。
callback: (任意) api パラメータが json の時のみ有効です。JSONP 形式でリクエストしたい際にコールバック関数を指定します。

ニュースジャンル一覧

リクエストパラメータの m の値として取れるニュースジャンルの一覧です。

national: 社会
sports: スポーツ
business: 経済
politics: 政治
international: 国際
academic: 学術・科学
culture: 文化・芸能

レスポンス形式

JSON 形式

JSON 形式のレスポンスは以下のフィールド値を持つオブジェクトが帰ります。

title: このニュースランキングのタイトルです
link: このランキングを提供するパストラック内のページへのリンクです
items: ランキング一覧を格納する配列です。

items フィールドにある配列の各要素は次のフィールド値を持つオブジェクトになります。

title: ニュース記事のタイトルです
link: ニュース記事へのリンクです
pathtraq:hits: 指定されたスコープ (popular, hot, upcoming) の期間に応じたパストラックが集計したそのページへのアクセス数です。

政治ジャンルのニュースから注目ページ一覧をJSON形式で取得したい場合、http://api.pathtraq.com/news_ja?api=json&callback=myobj.extract&genre=politics&m=upcoming のようにアクセスした際のレスポンスの例は下記になります。(簡略化の為に item の件数を実際の結果より少なくしております。)


      myobj.extract({
        "title": "Pathtraq - \u4eba\u6c17\u306e\u30cb\u30e5\u30fc\u30b9 - \u653f\u6cbb",
        "link":  "http://pathtraq.com/news_ja/politics?m=upcoming",
        "items": [
          {
            "title":         "\u3010\u7af9\u5cf6\u554f\u984c\u3011\u97d3\u56fd\u5927\u4f7f\u300c\u65e5\u672c\u306f\u5927\u4e8b\u306a\u3082\u306e\u5931\u3046\u300d  - MSN\u7523\u7d4c\u30cb\u30e5\u30fc\u30b9",
            "link":          "http://sankei.jp.msn.com/politics/policy/080715/plc0807151241009-n1.htm", 
            "pathtraq:hits": 7
          },
          {
            "title":         "asahi.com\uff1a\u300c\u7af9\u5cf6\u300d\u4e2d\u5b66\u89e3\u8aac\u66f8\u306b\u660e\u8a18\u3078\u3000\u97d3\u56fd\u53cd\u767a\u3001\u5927\u4f7f\u5e30\u56fd\u3082 - \u653f\u6cbb",
            "link":          "http://www.asahi.com/politics/update/0714/TKY200807140117.html", 
            "pathtraq:hits": 3
          },
          {
            "title":         "\u653f\u6cbb - MSN\u7523\u7d4c\u30cb\u30e5\u30fc\u30b9",
            "link":          "http://sankei.jp.msn.com/politics/politics.htm", 
            "pathtraq:hits": 2
          }
        ]
      });

一般的なRSS 2.0形式で返って来ますが、xmlns:pathtraq として "http://api.pathtraq.com/xml/pathtraq/0.1/" と言う XML 名前空間が指定されており、<item> 要素の子要素として <pathtraq:hits> 要素にて、指定されたスコープ (popular, hot, upcoming) の期間に応じたパストラックが集計したそのページへのアクセス数を提供します。

形式: text/xml
本文: RSS 2.0 形式の XML 文書

なお、提供するパラメータは JSON 形式の物と同等です。文化・芸能ジャンルのニュースから注目ページ一覧を取得したい場合、http://api.pathtraq.com/news_ja?genre=politics&m=upcoming に対するレスポンスのサンプルは以下になります。(簡略化の為に item の件数を実際の結果より少なくしております。)


      <?xml version="1.0" encoding="utf-8" ?>
      <rss version="2.0" xmlns:pathtraq="http://api.pathtraq.com/xml/pathtraq/0.1/">
        <channel>
          <title>Pathtraq - 人気のニュース - 政治</title>
          <link>http://pathtraq.com/news_ja/politics?m=upcoming</link>
          <item>
            <title>【竹島問題】韓国大使「日本は大事なもの失う」  - MSN産経ニュース</title>
            <link>http://sankei.jp.msn.com/politics/policy/080715/plc0807151241009-n1.htm</link>
            <description> 韓国の権哲賢駐日大使は15日、藪中三十二外務事務次官との竹島問題をめぐる会談後、「これにより日本は大事なものを失うと伝えた。強く抗議し、措置を要求した」と記者団に述べた。さらに「未来志向的にやると決め、福田康夫首相も親韓国の姿勢をとると言っていたのに、</description>
            <pathtraq:hits>7</pathtraq:hits>
          </item>
          <item>
            <title>asahi.com：「竹島」中学解説書に明記へ　韓国反発、大使帰国も - 政治</title>
            <link>http://www.asahi.com/politics/update/0714/TKY200807140117.html</link>
            <description>
      政府は14日、日韓双方が領有権を主張する竹島(韓国名・独島)について、中学校の学習指導要領の解説書に初めて明記する方針を固め、文言の最終調整に入った。韓国側の主張にも配慮した表現を盛り込むことを検討しているが、韓国側は竹島が記述されれば表現いかんにかか</description>
            <pathtraq:hits>3</pathtraq:hits>
          </item>
          <item>
            <title>政治 - MSN産経ニュース</title>
            <link>http://sankei.jp.msn.com/politics/politics.htm</link>
            <description> 福田康夫首相が議長として仕切った主要国首脳会議(北海道洞爺湖サミット)は9日閉幕した。首相は焦点の地球温暖化対策での前進などを強調し、サミットの「成果」を高らかに宣##した。ただ、内実は議長としての指導力や存在感を十分には発揮したとは言い切れず、張り子の</description>
            <pathtraq:hits>2</pathtraq:hits>
          </item>
        </channel>
      </rss>

カテゴリランキング取得API

パストラックの全体ランキングやカテゴリ別のランキングを rss または json 形式で取得する API です。

リクエスト形式

URL

http://api.pathtraq.com/popular

リクエストパラメータ

全てクエリ変数として指定します。

api: (任意) json または rss を指定します。省略した場合は rss が指定されます。
category: (任意) カテゴリを指定します。(カテゴリ一覧) 省略すると全体ランキングになります。
m: (任意) スコープ (popular: 定番, hot: 人気, upcoming: 注目) を指定します。省略すると hot になります。
callback: (任意) api パラメータが json の時のみ有効です。JSONP 形式でリクエストしたい際にコールバック関数を指定します。

カテゴリ一覧

politics: 政治
business: ビジネス/経済
society: 社会
showbiz: 芸能/お笑い
music: 音楽
movie: 映画
anime: アニメ/マンガ
game: ゲーム
sports: スポーツ
motor: 車
education: 教育/学習
reading: 読書/本
science: サイエンス
art: アート/デザイン
foods: 食/グルメ
travel: 旅行
mobile: モバイル
computer: コンピューター
web: ウェブ/インターネット

レスポンス形式

JSON 形式

JSON 形式のレスポンスはニュースランキング取得APIのJSON形式レスポンスと同様です。

ウェブ/インターネットカテゴリから定番ページ一覧をJSON形式で取得するサンプルとして、http://api.pathtraq.com/popular?category=web&api=json&callback=myobj.extract&m=popular のようにアクセスした際のレスポンスの例は下記になります。(簡略化の為に item の件数を実際の結果より少なくしております。)


      myobj.extract({
        "title": "Pathtraq - \u5b9a\u756a\u306e\u30da\u30fc\u30b8",
        "link":  "http://pathtraq.com/ranking/popular",
        "items": [
          {
            "title":         "Yahoo! JAPAN",
            "link":          "http://www.yahoo.co.jp/", 
            "pathtraq:hits": 922321
          },
          {
            "title":         "\u30cb\u30b3\u30cb\u30b3\u52d5\u753b(\u590f)",
            "link":          "http://www.nicovideo.jp/", 
            "pathtraq:hits": 349873
          },
          {
            "title":         "My Yahoo!",
            "link":          "http://my.yahoo.co.jp/", 
            "pathtraq:hits": 66785
          }
      })

RSS 形式

RSS 形式のレスポンスはニュースランキング取得APIのRSS形式レスポンスと同様です。

アニメ/マンガカテゴリから定番ページ一覧をJSON形式で取得するサンプルとして、http://api.pathtraq.com/popular?category=anime&m=popular のようにアクセスした際のレスポンスの例は下記になります。(簡略化の為に item の件数を実際の結果より少なくしております。)


      <?xml version="1.0" encoding="utf-8" ?>
      <rss version="2.0" xmlns:pathtraq="http://api.pathtraq.com/xml/pathtraq/0.1/">
        <channel>
      	<title>Pathtraq - 定番のページ</title>
      	<link>http://pathtraq.com/ranking/popular</link>
      
      	<item>
      	  <title>ランキング‐ニコニコ動画(夏)</title>
      	  <link>http://www.nicovideo.jp/ranking/view/daily/all</link>
      	  <description>ハルヒ 「あたしって、別にツンデレじゃないわよね?」
      	  ハルヒ 「どっちかっていうと、それはあんたのほうじゃないの」「あたしは男にこびを売ったりしないわよ...
      	  </description>
      	  <pathtraq:hits>12328</pathtraq:hits>
      	</item>
      
      	<item>
      	  <title>無料動画 アニメ スクープ</title>
      	  <link>http://animescoop.aki.gs/</link>
      	  <description>無料アニメ動画が見放題!名作から最新作までアニメ動画を幅広くご紹介。Youtube等で 視聴できる無料アニメ動画リンク集。無料ゲーム特集やアニメソング等多彩なコンテンツ!
      	  </description>
      	  <pathtraq:hits>9994</pathtraq:hits>
      	</item>
      
      	<item>
      	  <title>Yahoo!ニュース -  漫画、アニメーション</title>
      	  <link>http://dailynews.yahoo.co.jp/fc/entertainment/comics_and_animation/</link>
      	  <description>吉田戦車さん「マンガ家」婚 不条理ギャグマンガ「伝染るんです。」のヒットで知られるマンガ家の吉田戦車さんが、同じくマンガ家の伊藤理佐さんと結婚したことが20日、分かった。吉田さんが雑誌「ビッグコミックスピリッツ」の公式サイト上で結婚についてのメッセージを</description>
      	  <pathtraq:hits>3746</pathtraq:hits>
      	</item>
        </channel>
      </rss>

キーワード・URL検索API

パストラックの検索機能を rss または json 形式で取得する API です。キーワードやURLパターン、カテゴリを指定して検索を行う事が出来ます。

リクエスト形式

URL

http://api.pathtraq.com/pages

リクエストパラメータ

全てクエリ変数として指定します。

api

(任意) json または rss を指定します。省略した場合は rss が指定されます。

m

(任意) スコープ (popular: 定番, hot: 人気, upcoming: 注目) を指定します。省略すると hot になります。

callback

(任意) api パラメータが json の時のみ有効です。JSONP 形式でリクエストしたい際にコールバック関数を指定します。

url

指定したいキーワード、URLを半角スペース区切りで指定します。また下記のようにカテゴリ指定 (cat:) や前後に見ていたサイト (prevsite:, nextsite:)、ページ (prevpage:, nextpage:) などを条件に指定して検索する事も出来ます。

cat:: (任意) カテゴリの指定はcat:scienceのように指定します。指定出来るカテゴリ一覧はカテゴリランキング取得APIにあるカテゴリ一覧になります。
in:: (任意) 値として指定出来るのは現在の所newsのみとなります。ニュースランキングで扱われているサイトにあるページ中から検索を行います。
desc:: (任意) 検索結果にタイトルを付けます。
prevpage:: (任意) 指定したURLの後に見ていたページを検索します。
nextpage:: (任意) 指定したURLの前に見ていたページ一覧を検索します。いわゆるリファラーとして記録されるURLです。
prevsite:: (任意) 指定したURLパターンにマッチするページの後に見ていたページ一覧を検索します。
nextsite:: (任意) 指定したURLパターンにマッチするページの前に見ていたページを検索します。いわゆるリファラーとして記録されるURLです。

レスポンス形式

JSON 形式

JSON 形式のレスポンスはニュースランキング取得APIのJSON形式レスポンスと同様です。

ニュースランキングが対象とするサイトから殺害予告を含むページのランキングを検索したい場合に、http://api.pathtraq.com/pages?url=%E6%AE%BA%E5%AE%B3%E4%BA%88%E5%91%8A%20in%3Anews&callback=myobj.extract&api=json のようにアクセスした際のレスポンスの例は下記になります。(簡略化の為に item の件数を実際の結果より少なくしております。)


      myobj.extract({
        "title": "Pathtraq - \u6bba\u5bb3\u4e88\u544a\u306e\u4eba\u6c17\u30da\u30fc\u30b8",
        "link":  "http://pathtraq.com/analytics?q=%E6%AE%BA%E5%AE%B3%E4%BA%88%E5%91%8A%20in%3Anews",
        "items": [
          {
            "title":         "\u300c\u5c0f\u5973\u5b50\u713c\u304d\u6bba\u3059\u300d\u30cd\u30c3\u30c8\u306b\u6bba\u5bb3\u4e88\u544a\u3000\uff12\uff13\u6b73\u7121\u8077\u7537\u3092\u902e\u6355  - MSN\u7523\u7d4c\u30cb\u30e5\u30fc\u30b9",
            "link":          "http://sankei.jp.msn.com/affairs/crime/080716/crm0807161657034-n1.htm", 
            "pathtraq:hits": 54
          },
          {
            "title":         "\u300c\uff12\u3061\u3083\u3093\u306d\u308b\u300d\u306b\uff24\uff2a\u6bba\u5bb3\u4e88\u544a\u3001\uff13\uff15\u6b73\u4f1a\u793e\u54e1\u3092\u902e\u6355  - MSN\u7523\u7d4c\u30cb\u30e5\u30fc\u30b9",
            "link":          "http://sankei.jp.msn.com/affairs/crime/080702/crm0807021644023-n1.htm", 
            "pathtraq:hits": 2
          },
          {
            "title":         "\u6a4b\u4e0b\u77e5\u4e8b\u3000\u516c\u7528\u8eca\u3067\u629c\u3051\u51fa\u3057\u30b8\u30e0\u901a\u3044  - MSN\u7523\u7d4c\u30cb\u30e5\u30fc\u30b9",
            "link":          "http://sankei.jp.msn.com/politics/local/080716/lcl0807161128000-n1.htm", 
            "pathtraq:hits": 16
          }
        ]
      });

RSS 形式

RSS 形式のレスポンスはニュースランキング取得APIのRSS形式レスポンスと同様です。

次は IT戦記を参照しているサイトがどれくらいあるかを調べてみます。http://api.pathtraq.com/pages?url=nextsite%3Ahttp%3A%2F%2Fd.hatena.ne.jp%2Famachang のようにアクセスした際のレスポンスの例は下記になります。(簡略化の為に item の件数を実際の結果より少なくしております。)


      <?xml version="1.0" encoding="utf-8" ?>
      <rss version="2.0" xmlns:pathtraq="http://api.pathtraq.com/xml/pathtraq/0.1/">
        <channel>
      	<title>Pathtraq - d.hatena.ne.jp/amachang の前に見ていたページ</title>
      	<link>http://pathtraq.com/analytics?q=nextsite%3Ahttp%3A%2F%2Fd.hatena.ne.jp%2Famachang</link>
      
      	<item>
      	  <title>はてな</title>
      	  <link>http://www.hatena.ne.jp/</link>
      	  <description></description>
      	  <pathtraq:hits>7</pathtraq:hits>
      	</item>
      
      	<item>
      	  <title>ie8 - Google Search</title>
      	  <link>http://www.google.com/search?q=ie8&ie=utf-8</link>
      	  <description></description>
      	  <pathtraq:hits>2</pathtraq:hits>
      	</item>
      
      	<item>
      	  <title>MixClips ソーシャルブックマーク横断サイト</title>
      	  <link>http://www.mixclips.org/</link>
      	  <description>Mix clipsは『はてなブックマーク』『del.icio.us』『@nifty クリップ』『livedoor clip』『buzzurl』といったソーシャルブックマークを横断的に表示するリミックスサイトです。 ベータ版につき、ご意見・ご要望を募集して</description>
      	  <pathtraq:hits>2</pathtraq:hits>
      	</item>
        </channel>
      </rss>

URL正規化API

パストラック内でURLの正規化を行う機能をAPI化した物です。同一リソースを指すURLをシンプルな形に変換する際に利用出来ます。(Amazonの商品リンクなど)

リクエスト形式

URL

http://api.pathtraq.com/normalize_url2

リクエストパラメータ

全てクエリ変数として指定します。

api: json または xml を指定します。
url: 正規化を行いたい URL を指定します。

レスポンス形式

JSON 形式

ちょいデキ - http://www.amazon.co.jp/exec/obidos/ASIN/4166605917/cybozulabs-22/ のような URL を正規化し、JSON 形式で取得したい場合に、http://api.pathtraq.com/normalize_url2?url=http%3A%2F%2Fwww.amazon.co.jp%2Fexec%2Fobidos%2FASIN%2F4166605917%2Fcybozulabs-22%2F のようにアクセスした際のレスポンス例は次のようになります。


      "http://www.amazon.co.jp/gp/product/4166605917"

XML 形式

Jythonプログラミング - http://www.amazon.co.jp/exec/obidos/ASIN/4839922829/cybozulabs-22/と言ったURLを正規化し、XML形式で取得したい場合に、http://api.pathtraq.com/normalize_url2?url=http%3A%2F%2Fwww.amazon.co.jp%2Fexec%2Fobidos%2FASIN%2F4839922829%2Fcybozulabs-22%2F&api=xml のようにアクセスした際のレスポンス例は次のようになります。


      <result>
        <url>http://www.amazon.co.jp/gp/product/4839922829</url>
      </result>

ページカウンタAPI

注目・人気・定番と言う時間帯で区切った特定の URL 単位のアクセス数を返します。

リクエスト形式

URL

http://api.pathtraq.com/page_counter2

リクエストパラメータ

全てクエリ変数として指定します。

api: (任意) json または xml を指定します。省略した場合は json が指定されます。
m: (任意) スコープ (popular: 定番, hot: 人気, upcoming: 注目) を指定します。省略すると hot になります。
url: ヒット数のカウントを取得したい URL を指定します。この url パラメータは複数(最大50個まで)指定出来ます。
callback: (任意) api パラメータが json の時のみ有効です。JSONP 形式でリクエストしたい際にコールバック関数を指定します。

レスポンス形式

JSON形式

サイボウズのコーポレートサイトトップページとビジネスポータル cybozu.net のトップページのヒット数のカウントをJSON形式で取得する場合、http://api.pathtraq.com/page_counter2?url=http%3A%2F%2Fcybozu.co.jp%2F&url=http%3A%2F%2Fwww.cybozu.net%2F&callback=myobj.extract のようにアクセスした際のレスポンスの例は以下になります。


      myobj.extract({
        "mode": "hot",
        "items": {
          "http://www.cybozu.net/": 24,
          "http://cybozu.co.jp/": 22
        }
      })

XML形式

JSON形式と同様にしてサイボウズ本社のページとcybozu.netの注目スコープでのヒット数のカウントをXML形式で取得する場合、http://api.pathtraq.com/page_counter2?api=xml&url=http%3A%2F%2Fcybozu.co.jp%2F&url=http%3A%2F%2Fwww.cybozu.net%2F&m=upcoming のようにアクセスした際のレスポンスの例は下記になります。


      <?xml version="1.0" encoding="utf-8"?>
      <result>
        <mode>upcoming</mode>
        <items>
          <item>
            <url>http://cybozu.co.jp/</url>
            <count>9</count>
          </item>
      
          <item>
            <url>http://www.cybozu.net/</url>
            <count>13</count>
          </item>
        </items>
      </result>

ページチャートAPI

特定の期間内での時系列のアクセス数の一覧を返す API です。

リクエスト形式

URL

http://api.pathtraq.com/page_chart

リクエストパラメータ

全てクエリ変数として指定します。

api: json または xml を指定します。省略した場合は json となります。
url: アクセスチャートデータを取得したい URL を指定します。
scale: 24h (24時間)、1w (1週間)、1m (1ヶ月)、3m (3ヶ月)のいずれかを指定します。省略した場合は 24h となります。

レスポンス形式

JSON 形式

レスポンスデータに含まれる各項目の意味は以下になります。

step: 各プロットデータの時間軸の単位時間 (hour) です。例えば 24 ならば 24時間ごとのデータと言うことです。
plots: アクセス数を表す数値のリストです。
url: 指定された URL が返ってきます
start: RFC 1123 で規定された HTTP での日付形式の文字列です。JavaScript の Date オブジェクトコンストラクタの引数にそのまま利用することが出来ます。

サイボウズ本社のアクセスチャートデータを直近1ヶ月で取得したい場合に、http://api.pathtraq.com/page_chart?url=http%3A%2F%2Fcybozu.co.jp%2F&callback=myobj.extract&scale=1m にアクセスした場合のレスポンス例は以下になります。(可読性の為に整形してあります)


      myobj.extract({ 
        step: 24, 
        plots: [ 8, 10, 6, 4, 2, 14, 21, 55, 46, 41, 8, 10, 43, 29, 31, 34, 25, 11, 10, 37, 34, 35, 40, 24, 10, 9, 33, 31, 18, 33, 29 ], 
        url: "http://cybozu.co.jp/", 
        start: "Wed, 01 Aug 2007 10:00:00 GMT" 
      });

XML形式

レスポンスに含まれる項目の意味はJSON形式と同様です。各プロットデータは <plots> 要素の子要素である <plot> 要素の内容として提供されます。

比較表コミュニティ - ならべて.comのアクセスチャートを直近24時間で取得したい場合に、http://api.pathtraq.com/page_chart?api=xml&url=http%3A%2F%2Fnarabete.com%2F にアクセスした場合のレスポンス例は以下になります。


      <?xml version="1.0" encoding="utf-8"?>
      <result>
        <url>http://narabete.com/</url>
        <plots>
          <plot>0</plot>
          <plot>0</plot>
          <plot>0</plot>
          <plot>1</plot>
          <plot>0</plot>
          <plot>0</plot>
          <plot>0</plot>
          <plot>0</plot>
          <plot>0</plot>
          <plot>0</plot>
          <plot>0</plot>
          <plot>0</plot>
          <plot>0</plot>
          <plot>0</plot>
          <plot>0</plot>
          <plot>1</plot>
          <plot>0</plot>
          <plot>0</plot>
          <plot>0</plot>
          <plot>0</plot>
          <plot>0</plot>
          <plot>0</plot>
          <plot>0</plot>
          <plot>0</plot>
          <plot>1</plot>
        </plots>
        <start>Thu, 24 Jul 2008 18:00:00 GMT</start>
        <step>1</step>
      <result>

開発者向け情報 開発者向けAPIの利用方法について解説します。

開発者向け情報のインデックス

リクエスト形式

URL

リクエストパラメータ

レスポンス形式

リクエスト形式

URL

リクエストパラメータ

レスポンス形式

JSON 形式

RSS 形式

リクエスト形式

URL

リクエストパラメータ

レスポンス形式

JSON 形式

RSS 形式

リクエスト形式

URL

リクエストパラメータ

レスポンス形式

JSON 形式

XML 形式

リクエスト形式

URL

リクエストパラメータ

レスポンス形式

JSON形式

XML形式

リクエスト形式

URL

リクエストパラメータ

レスポンス形式

XML形式

開発者向け情報開発者向けAPIの利用方法について解説します。