ドキュメント

認証

FastNews API は認証に API キーを使用します。API キーはアカウントページから取得できます。

すべてのリクエストにクエリパラメータ apiKey として API キーを含めてください。

curl -X GET "https://api.fast-news.biz/v1/articles?apiKey=YOUR_API_KEY"

ニュース記事のリストを取得します。

Base URL

curl -X GET "https://api.fast-news.biz/v1/articles?apiKey=YOUR_API_KEY"

Query Parameters

• apiKey

  required

  あなたのAPIキー。

• limit

  optional

  取得する記事の数。（最小: 1, 最大: 100, デフォルト: 1）

• cursor

  optional

  指定した時間以前に作成された記事を取得するためのUnixタイムスタンプ。（デフォルト: 現在時刻）

• genre

  optional

  特定のジャンルIDで記事をフィルタリングします。

• region

  optional

  記事のリージョンを指定します（global | jp）。未指定の場合は jp。

Response Model (ArticleListResponse)

type ArticleListResponse struct {
    Articles  []ArticleResponse `json:"articles"`
    NextToken string            `json:"next_token,omitempty"`
    Total     int               `json:"total"`
}

type ArticleResponse struct {
    ID         string    `json:"id"`
    Title      string    `json:"title"`
    Summary    string    `json:"summary"`
    Body       string    `json:"body"`
    KeyPoints  []string  `json:"key_points"`
    Region     string    `json:"region"`
    GenreID    string    `json:"genre_id"`
    Genre      string    `json:"genre"`
    Tags        []string  `json:"tags"`
    PublishedAt time.Time `json:"published_at"`
    CreatedAt   time.Time `json:"created_at"`
}

利用可能なニュースジャンルを取得します。

Base URL

curl -X GET "https://api.fast-news.biz/v1/genres?apiKey=YOUR_API_KEY"

Query Parameters

• apiKey

  required

  あなたのAPIキー。

Response Model (GenreListResponse)

type GenreListResponse struct {
    Genres []Genre `json:"genres"`
    Total  int     `json:"total"`
}

type Genre struct {
    ID        string    `json:"id"`         // e.g., "technology"
    Name      string    `json:"name"`       // e.g., "テクノロジー"
    CreatedAt time.Time `json:"created_at"`
}