APIの提供について
1. 記事情報API
プレスリリース配信サービス「NEWSCAST」が保有する情報をAPI経由で取得可能です。
以下のようなケースでAPI連携可能です。
- 自社ニュースサイトへの記事掲載
- 記事作成時に記事作成補助システムからのニュース検索・取得
- 企業サイトへの自社ニュース記事の掲載
取得方法
curl -X GET https://newscast.jp/api/v3/news/bulk -H "Authorization: Bearer {APIKEY}"レスポンス例
{
"next": "https://newscast.jp/api/v3/news/bulk?last_key=cD00ODY",
"previous": "https://newscast.jp/api/v3/news/bulk?last_key=cj0xJnA9NDg3",
"results": [{
"title": "string",
"description": "string",
"sub_title": "string",
"code": "string",
"profile": {
"code": "string",
"company_name": "string"
},
"publisher": {
"code": "string",
"name": "string",
"url": "string",
"logo_url": "string",
"facebook": "string",
"twitter": "string",
"instagram": "string",
"president": "string",
"address": "string",
"tel": "string",
"listed_market": "string",
"business_contents": "string",
"show_contact": 4294967295
},
"attachment_image_url": "string",
"modified_datetime": "2019-08-24T14:15:22Z",
"open_datetime": "2019-08-24T14:15:22Z",
"genres": [
"string"
],
"tags": [
"string"
],
"news_items": null,
"markdown": "string",
"html": "string"
}]
}
リクエストパラメータ
| パラメータ名 | 型 | 説明 | 必須 | 例 |
|---|---|---|---|---|
| last_key | string | ページネーションのカーソル値 | 任意 | last_key=cD00ODY |
| publisher_code | string | 発行元コード | 任意 | publisher_code=publisher123 |
| genre_code | string | ジャンルごとにニュースを取得します。 選択肢：entertainment, sports, anime_game, business, travel, gourmet, net_it, fashion, cosme, lifestyle, finance_economy, research | 任意 | genre_code=fashion |
| tag | string | 特定のタグに関連するニュースを取得します。 | 任意 | セール |
| addresses | Array of strings | 47都道府県のニュースを取得します。複数の地域を指定した場合は、どちらかの地域が含まれるニュースを取得します（OR検索）。 | 任意 | addresses=東京都&addresses=大阪府 |
| has_image | boolean | 画像があるニュースだけに絞り込みます。 デフォルト: false | 任意 | has_image=true |
| keyword | Array of string | 特定のキーワードを検索できます。複数のキーワードを指定した場合は、どちらかのキーワードが含まれるニュースを取得します（OR検索）。 | 任意 | keyword=新商品&keyword=全国 |
| limit | integer or null | 取得するデータの最大件数。 範囲: 1から100 デフォルト:100 | 任意 | limit=50 |
| lat | number <double> | 指定した緯度の位置情報を基にデータを取得します。lngおよびradiusパラメーターと組み合わせて、特定の地点から一定範囲内の情報を取得するために使用されます。 | 任意 | lat=35.6895 |
| lng | number <double> | 指定した経度の位置情報を基にデータを取得します。latおよびradiusパラメーターと組み合わせて、特定の地点から一定範囲内の情報を取得するために使用されます。 | 任意 | lng=139.6917 |
| radius | integer | 指定した半径内のデータを取得します。latおよびlonパラメーターと組み合わせて、特定の地点から何メートル以内の情報を取得するために使用されます。 | 任意 | radius=5000 |
| open_start_date | string <date> | ニュース公開日の範囲指定(開始日)。形式: YYYY-MM-DD | 任意 | open_start_date=2023-01-01 |
| open_end_date | string <date> | ニュース公開日の範囲指定(終了日)。形式: YYYY-MM-DD | 任意 | open_end_date=2023-12-31 |
| page | integer or null | ページネーション範囲: 1から999999 | 任意 | page=1 |
| sort | string | 並び順を指定します。 選択肢： "asc" (昇順) または "desc" (降順) | 任意 | sort=desc |