カメリオAPI

API利用方法

APIの利用はHTTPアクセスのプログラミング経験のある方でしたら簡単に利用することができます。
結果はJSON形式のデータで返されますのでお客様のアプリケーションで容易に利用することができます。

cURLを使った例

$ curl -X POST -H 'X-KML-APP-TOKEN: ****app_token****' \
>      -H 'Content-Type: application/json' \
>      -d '{"query": "シェアリングエコノミー"}' https://bi.kamelio-api.com/api/v1/search/contents

Pythonを使った例

import requests

headers = {

  'X-KML-APP-TOKEN': '****app_token****',

}

body = {

  'query': 'シェアリングエコノミー'

}

response = requests.post('https://bi.kamelio-api.com/api/v1/search/contents', 

  headers=headers, json=body)

print(response.json())

レスポンス例

APIのレスポンスはJSON形式のデータで返されます。

{

      "status": "OK",

      "error": "",

      "error_code": "",

      "total": 4,

      "limit": 50,

      "contents": [

          {

                "description": "質量分析技術を用いた新しいがん免疫療法の確立へ米プロビデンスがん研究センターとの共同研究を本格化",

                "id": "2554543632509692014",

                "image_urls": [

                      "https://www.shimadzu.co.jp/sites/shimadzu.co.jp/files/news/press/images/nexeraMikros_system01.jpg"

                ],

                "offset": 0,

                "published_at": "2019-12-26T06:00:00Z",

                "score": 0.43455884,

                "score_detail": {},

                "source_id": 9692,

                "source_name": "株式会社島津製作所",

                "title": "質量分析技術を用いた新しいがん免疫療法の確立へ
米プロビデンスがん研究センターとの共同研究を本格化",

                "updated_at": "2019-12-26T07:17:40Z",

                "url": "https://www.shimadzu.co.jp/news/press/7pbyeadoef_1h1yk.html",

                "guid": "https://www.shimadzu.co.jp/news/press/7pbyeadoef_1h1yk.html",

                "lang": "ja"

          },

          {

                "description": "自動合否判定と360検体連続分析を実現紫外可視分光光度計の新ブランド「UV-i Selection」6機種を発売",

                "id": "2534796528909692014",

                "image_urls": [

                      "https://www.shimadzu.co.jp/sites/shimadzu.co.jp/files/news/images/20191224_uv.jpg",

                      "https://www.shimadzu.co.jp/sites/shimadzu.co.jp/files/news/images/20191224_uv.jpg"

                ],

                "offset": 1,

                "published_at": "2019-12-24T00:00:00Z",

                "score": 0.2530022,

                "score_detail": {},

                "source_id": 9692,

                "source_name": "株式会社島津製作所",

                "title": "自動合否判定と360検体連続分析を実現
紫外可視分光光度計の新ブランド「UV-i Selection」6機種を発売",

                "updated_at": "2019-12-24T00:28:28Z",

                "url": "https://www.shimadzu.co.jp/news/press/6_02-9f190vi02d4.html",

                "guid": "https://www.shimadzu.co.jp/news/press/6_02-9f190vi02d4.html",

                "lang": "ja"

          }

      ],

      "topics_words": {

            "id": 2114,

            "name": "島津製作所",

            "synonyms": [],

            "field_words": []

      }

}

レスポンス例をすべて表示

レスポンスの内容の詳細

APIのレスポンスはJSON形式のデータで取得します

検索で返される記事情報(抜粋)

記事のタイトル
記事の見出しや概要(150文字まで)
記事のURL
サイト名称
記事の公開日時
OGP画像や記事本文中の画像URL(複数)
検索に使用した評価値

提供API

記事検索API

キーワードや検索式を指定して記事を検索します。検索スコアーに基づいて検索結果が返されます。

トピック記事検索API

事前に設定したトピックを使って検索します。新着記事ほどスコアーが高くなります。

その他機能・サービス

管理画面

APIで提供されているほぼ全ての機能を管理画面で操作できます。お客様のアプリケーションに組み込む際に事前の評価やトピックの登録などに利用できます。

アカウント管理

カメリオAPI管理画面やAPIアクセス時にに、利用する機能に制限を付けた個別のアカウントを発行できます。

ソースの追加

新規ソースを追加することができます。お問い合わせください。

カスタムサーチ

社内ドキュメントなど非公開の記事を利用したい場合や、他のお客様に公開したくない記事(外部サイトの有料記事など)をカメリオAPIで利用したい場合に利用できます。詳しくはお問い合わせ下さい。

用途に合わせた2つの記事検索方法

記事検索には記事検索APIとトピック記事検索APIの2つの方法を提供しています。

機能	記事検索API	トピック記事検索API
検索条件設定	検索式のみ	関連語記述方式と検索式の2つの方式
検索	検索の度に検索式を記述して検索	事前に登録・保存しトピックを利用して検索
記事のマッチ度	検索スコアーのみ	検索スコアー＋記事の新しさで補正したもの (新着記事ほどスコアーが高い)
不適切記事API	利用不可	利用可能
クエリー改善API	利用不可	利用可能
用途	調査・分析などのへの記事収集	キュレーション、記事クリッピングなどの自動的な記事収集

カメリオAPI