← APIs / Perigon News API
Verified

Perigon News API

Apiosk Basicsby Apiosk Basics · General

Structured global news articles and AI-clustered stories.

newsapi
Price per request
$0.08
About

Perigon provides global news, web content, AI-clustered stories, source metadata and entity-aware search. This listing exposes article search and clustered stories with the upstream apiKey injected by Apiosk.

Base URL
https://gateway.apiosk.com/perigon
Technical Specs
Auth MethodapiKey
Response FormatJSON
Endpoints2
Endpoints
MethodPathDescriptionCost
GET /articles/all Search/filter individual news articles with query, date, source, country, language and topic filters.
$0.08 default
 View details
GET /stories/all Search AI-clustered news stories and summaries by topic, entity, location and time filters.
$0.12 default
 View details
Endpoint documentation
GET/articles/all
$0.08 default
Description

Search/filter individual news articles with query, date, source, country, language and topic filters.

Pricing
$0.08 default
Parameters
{
  "country": {
    "required": false,
    "type": "string"
  },
  "from": {
    "required": false,
    "type": "string"
  },
  "language": {
    "required": false,
    "type": "string"
  },
  "q": {
    "required": false,
    "type": "string"
  },
  "size": {
    "required": false,
    "type": "integer"
  },
  "sourceGroup": {
    "required": false,
    "type": "string"
  },
  "to": {
    "required": false,
    "type": "string"
  }
}
Response schema
{
  "properties": {
    "articles": {
      "type": "array"
    },
    "numResults": {
      "type": "number"
    },
    "status": {
      "type": "number"
    }
  },
  "type": "object"
}
Example response
{
  "articles": [
    {
      "title": "Example article",
      "url": "https://example.com/article"
    }
  ],
  "numResults": 1,
  "status": 200
}
GET/stories/all
$0.12 default
Description

Search AI-clustered news stories and summaries by topic, entity, location and time filters.

Pricing
$0.12 default
Parameters
{
  "country": {
    "required": false,
    "type": "string"
  },
  "from": {
    "required": false,
    "type": "string"
  },
  "language": {
    "required": false,
    "type": "string"
  },
  "q": {
    "required": false,
    "type": "string"
  },
  "size": {
    "required": false,
    "type": "integer"
  },
  "to": {
    "required": false,
    "type": "string"
  },
  "topic": {
    "required": false,
    "type": "string"
  }
}
Response schema
{
  "properties": {
    "numResults": {
      "type": "number"
    },
    "results": {
      "type": "array"
    },
    "status": {
      "type": "number"
    }
  },
  "type": "object"
}
Example response
{
  "numResults": 1,
  "results": [
    {
      "articleCount": 5,
      "name": "Example story",
      "summary": "Cluster summary"
    }
  ],
  "status": 200
}
Home · Documentation · Apiosk.com