トピックリスト
トピックイットAPIで取得できるデータの種類を詳しくご説明します。
なお、各リクエストの{ } 部分は、必ずURLエンコードしてください。文字コードはShift-JISです。
リクエストURL
- 機能：
- 条件にマッチしたトピックリストを取得する。
上記のリクエスト例の場合は、タグに「apple」がつけられているトピックを3件取得します。
リクエスト
| No. | GET | 内容 |
|---|---|---|
| 1 | /api/v1/topics | 全トピック |
| 2 | /api/v1/topics/categories/{category name} | {category name}のトピック |
| 3 | /api/v1/topics/categories/{category name}/{subcategory name} | {category name}の {subcategory name}のトピック |
| 4 | /api/v1/topics/tags/{tag name} | {tag name}が付いているトピック |
| 5 | /api/v1/topics/{topic id} | {topic id}のトピック |
| 6 | /api/v1/topics/{comma-separated list of topic ids} | {topic id}にマッチするトピック (E.g., GET /topics/984,1489,8575,174) |
| 7 | /api/v1/topics/keyword/{keyword} | {keyword}にマッチするトピック |
| 8 | /api/v1/topics/feeling/{feeling} | {feeling}にマッチするトピック |
| 9 | /api/v1/topics/users/{user name}/submissions | {user name}が投稿したトピック |
| 10 | /api/v1/topics/users/{user name}/comments | {user name}がコメントしたトピック |
| 11 | /api/v1/topics/users/{user name}/votes | {user name}が投票したトピック |
共通パラメータ
| パラメータ名 | パラメータ | 値 | デフォルト | 内容 |
|---|---|---|---|---|
| 検索開始投稿日時 | min_day | Number | - | UNIX epoch |
| 検索終了投稿日時 | max_day | Number | - | UNIX epoch |
| 検索開始ポイント | min_point | Number | 0 | limit=9999 |
| 検索終了ポイント | max_point | Number | 9999 | limit=9999 |
| ソート（投稿日時） | sort_day | String | desc | desc, asc |
| ソート（話題度） | sort_wadai | String | desc | desc, asc |
| ソート（ポイント） | sort_point | String | desc | desc, asc |
| ソート（コメント） | sort_comment | String | desc | desc, asc |
| ソート（表情） | sort_feeling | Number | - | ex 12345 1:うれしい、2:面白い、3:怒り、4:悲しい、5:驚き |
| トピック数 | count | Number | - | 取得件数 |
| 元記事ドメイン | domain | String | - | {domain1,domain2,,,}複数指定可能（5個まで） |
| 元記事リンク | link | String | - | {link2,link2,,,}複数指定可能（5個まで） |
| キーワード | keyword | String | - | No.=4,5,7は使用不可 |
| タグ | tag | String | - | No.=4,5,7は使用不可 |
| ユーザー名 | user_name | String | - | No.=5,9,10,11のみ使用不可 |
| 表情 | feeling | Number | - | 1:うれしい、2:面白い、3:怒り、4:悲しい、5:驚き No.8は使用不可 |
レスポンス
| 項目名 | パラメータ |
|---|---|
| タイトル | title |
| 本文 | body |
| URL | topic_url |
| 元記事URL | url |
| 携帯版URL | mobile_url |
| 投稿日時 | created |
| 閲覧数 | views |
| ポイント数 | points |
| コメント数 | comments |
| 矢印 | trend |
| 投稿者 | nickname |
| カテゴリ名 | cat_name |
| サブカテゴリ名 | subcat_name |
| カテゴリURL | cat_url |
| タグid | tag_id |
| タグ名 | tag_name |
| 感情 | feeling |
| トピックid | topic_id |
サンプルレスポンス
以下は、/api/v1/topics/tags/apple?count=3のリクエストに対するレスポンスです。
