---
title: "All Articles"
method: GET
path: "/v1/articles/all"
tags: ["v1"]
---

# All Articles

`GET /v1/articles/all`

Search and filter all news articles available via the Perigon API. The result includes a list of individual articles that were matched to your specific criteria.

## Query parameters

- `q` string
- `title` string
- `desc` string
- `content` string
- `summary` string
- `url` string
- `articleId` string[]
- `clusterId` string[]
- `sortBy` 'relevance' | 'date' | 'reverseDate' | 'reverseAddDate' | 'addDate' | 'pubDate' | 'refreshDate'
- `page` integer
- `size` integer
- `from` string, date-time
- `to` string, date-time
- `addDateFrom` string, date-time
- `addDateTo` string, date-time
- `refreshDateFrom` string, date-time
- `refreshDateTo` string, date-time
- `medium` string[]
- `source` string[]
- `sourceGroup` string[]
- `excludeSourceGroup` string[]
- `excludeSource` string[]
- `watchlist` string[]
- `excludeWatchlist` string[]
- `paywall` boolean
- `byline` string[]
- `author` string[]
- `excludeAuthor` string[]
- `journalistId` string[]
- `excludeJournalistId` string[]
- `language` string[]
- `excludeLanguage` string[]
- `searchTranslation` boolean
- `label` string[]
- `excludeLabel` string[]
- `category` string[]
- `excludeCategory` string[]
- `topic` string[]
- `excludeTopic` string[]
- `linkTo` string
- `showReprints` boolean
- `reprintGroupId` string
- `city` string[]
- `excludeCity` string[]
- `area` string[]
- `state` string[]
- `excludeState` string[]
- `county` string[]
- `excludeCounty` string[]
- `locationsCountry` string[]
- `country` string[]
- `excludeLocationsCountry` string[]
- `location` string[]
- `lat` number, double
- `lon` number, double
- `maxDistance` number, double
- `sourceCity` string[]
- `excludeSourceCity` string[]
- `sourceCounty` string[]
- `excludeSourceCounty` string[]
- `sourceCountry` string[]
- `excludeSourceCountry` string[]
- `sourceState` string[]
- `excludeSourceState` string[]
- `sourceLat` number, double
- `sourceLon` number, double
- `sourceMaxDistance` number, double
- `personWikidataId` string[]
- `excludePersonWikidataId` string[]
- `personName` string[]
- `excludePersonName` string[]
- `companyId` string[]
- `excludeCompanyId` string[]
- `companyName` string
- `companyDomain` string[]
- `excludeCompanyDomain` string[]
- `companySymbol` string[]
- `excludeCompanySymbol` string[]
- `showNumResults` boolean
- `positiveSentimentFrom` number, float
- `positiveSentimentTo` number, float
- `neutralSentimentFrom` number, float
- `neutralSentimentTo` number, float
- `negativeSentimentFrom` number, float
- `negativeSentimentTo` number, float
- `taxonomy` string[]
- `prefixTaxonomy` string
- `showHighlighting` boolean
- `highlightFragmentSize` integer
- `highlightNumFragments` integer
- `highlightPreTag` string
- `highlightPostTag` string
- `highlightQ` string

## Response `200`

200 - Success

- QuerySearchResult
  - `status` integer, required
  - `numResults` integer, required
  - `articles` Article[], required
    - `url` string, nullable
    - `authorsByline` string, nullable
    - `articleId` string, nullable
    - `clusterId` string, nullable
    - `source` SourceHolder
      - `domain` string, nullable
      - `paywall` boolean, nullable
      - `location` SourceLocation
        - `country` string, nullable
        - `state` string, nullable
        - `county` string, nullable
        - `city` string, nullable
        - `coordinates` Coordinate
          - `lat` number, double, nullable
          - `lon` number, double, nullable
    - `imageUrl` string, nullable
    - `country` string, nullable
    - `language` string, nullable
    - `pubDate` string, nullable
    - `addDate` string, nullable
    - `refreshDate` string, nullable
    - `score` number, float, nullable
    - `title` string, nullable
    - `description` string, nullable
    - `content` string, nullable
    - `enContentWordCount` integer, nullable
    - `medium` string, nullable
    - `links` string[], nullable
    - `labels` LabelHolder[], nullable
      - `name` string, nullable
    - `eventTypes` EventTypeHolder[], nullable
      - `name` string, nullable
      - `type` string, nullable
    - `matchedAuthors` IdNameHolder[], nullable
      - `id` string, nullable
      - `name` string, nullable
    - `claim` string, nullable
    - `verdict` string, nullable
    - `keywords` KeywordHolder[], nullable
      - `name` string, nullable
      - `weight` number, float, nullable
    - `topics` TopicHolder[], nullable
      - `name` string, nullable
    - `categories` CategoryHolder[], nullable
      - `name` string, nullable
    - `taxonomies` CategoryWithScoreHolder[], nullable
      - `name` string, nullable
      - `score` number, double, nullable
    - `entities` EntityHolder[], nullable
      - `data` string, nullable
      - `type` string, nullable
      - `mentions` integer, nullable
    - `companies` CompanyHolder[], nullable
      - `id` string, nullable
      - `name` string, nullable
      - `domains` string[], nullable
      - `symbols` string[], nullable
    - `sentiment` SentimentHolder
      - `positive` number, float, nullable
      - `negative` number, float, nullable
      - `neutral` number, float, nullable
    - `summary` string, nullable
    - `shortSummary` string, nullable
    - `translation` string, nullable
    - `translatedTitle` string, nullable
    - `translatedDescription` string, nullable
    - `translatedSummary` string, nullable
    - `locations` LocationHolder[], nullable
      - `country` string, nullable
      - `state` string, nullable
      - `county` string, nullable
      - `city` string, nullable
      - `area` string, nullable
    - `reprint` boolean, nullable
    - `reprintGroupId` string, nullable
    - `places` Place[], nullable
      - `osmId` string, nullable
      - `road` string, nullable
      - `quarter` string, nullable
      - `suburb` string, nullable
      - `city` string, nullable
      - `town` string, nullable
      - `county` string, nullable
      - `stateDistrict` string, nullable
      - `state` string, nullable
      - `postcode` string, nullable
      - `country` string, nullable
      - `countryCode` string, nullable
      - `amenity` string, nullable
      - `neighbourhood` string, nullable
      - `coordinates` Coordinate
        - `lat` number, double, nullable
        - `lon` number, double, nullable
    - `people` PersonHolder[], nullable
      - `wikidataId` string, nullable
      - `name` string, nullable
    - `cluster` NewsCluster
      - `createdAt` string, nullable
      - `updatedAt` string, nullable
      - `initializedAt` string, nullable
      - `id` string, nullable
      - `duplicateOf` string, nullable
      - `slug` string, nullable
      - `name` string, nullable
      - `summary` string, nullable
      - `shortSummary` string, nullable
      - `summaryReferences` string[], nullable
      - `imageSource` SourceHolder
        - `domain` string, nullable
        - `paywall` boolean, nullable
        - `location` SourceLocation
          - `country` string, nullable
          - `state` string, nullable
          - `county` string, nullable
          - `city` string, nullable
          - `coordinates` Coordinate
            - `lat` number, double, nullable
            - `lon` number, double, nullable
      - `imageUrl` string, nullable
      - `keyPoints` KeyPoint[], nullable
        - `point` string, nullable
        - `references` string[], nullable
      - `questions` Question[], nullable
        - `question` string, nullable
        - `answer` string, nullable
        - `references` string[], nullable
      - `uniqueSources` string[], nullable
      - `selectedArticles` Article[], nullable
      - `sentiment` SentimentHolder
        - `positive` number, float, nullable
        - `negative` number, float, nullable
        - `neutral` number, float, nullable
      - `uniqueCount` integer, nullable
      - `reprintCount` integer, nullable
      - `totalCount` integer, nullable
      - `countries` RecordStatHolder[], nullable
        - `name` string, nullable
        - `count` integer, nullable
      - `topCountries` string[], nullable
      - `topics` RecordStatHolder[], nullable
        - `name` string, nullable
        - `count` integer, nullable
      - `topTopics` TopicHolder[], nullable
        - `name` string, nullable
      - `categories` RecordStatHolder[], nullable
        - `name` string, nullable
        - `count` integer, nullable
      - `topCategories` CategoryHolder[], nullable
        - `name` string, nullable
      - `taxonomies` RecordStatHolder[], nullable
        - `name` string, nullable
        - `count` integer, nullable
      - `topTaxonomies` CategoryHolder[], nullable
        - `name` string, nullable
      - `people` PersonCount[], nullable
        - `wikidataId` string, nullable
        - `name` string, nullable
        - `count` integer, nullable
      - `topPeople` PersonHolder[], nullable
        - `wikidataId` string, nullable
        - `name` string, nullable
      - `companies` CompanyCount[], nullable
        - `id` string, nullable
        - `name` string, nullable
        - `domains` string[], nullable
        - `symbols` string[], nullable
        - `count` integer, nullable
      - `topCompanies` CompanyHolder[], nullable
        - `id` string, nullable
        - `name` string, nullable
        - `domains` string[], nullable
        - `symbols` string[], nullable
      - `locations` LocationCount[], nullable
        - `country` string, nullable
        - `state` string, nullable
        - `county` string, nullable
        - `city` string, nullable
        - `area` string, nullable
        - `count` integer, nullable
      - `topLocations` LocationHolder[], nullable
        - `country` string, nullable
        - `state` string, nullable
        - `county` string, nullable
        - `city` string, nullable
        - `area` string, nullable
      - `highlights` object, nullable
      - `sourceDiversity` number, double, nullable
    - `journalists` Journalist[], nullable
      - `id` string, nullable
      - `name` string, nullable
      - `fullName` string, nullable
      - `headline` string, nullable
      - `description` string, nullable
      - `title` string, nullable
      - `locations` LocationHolder[], nullable
        - `country` string, nullable
        - `state` string, nullable
        - `county` string, nullable
        - `city` string, nullable
        - `area` string, nullable
      - `updatedAt` string, nullable
      - `topTopics` NameCount[], nullable
        - `name` string, nullable
        - `count` integer, nullable
      - `topSources` NameCount[], nullable
        - `name` string, nullable
        - `count` integer, nullable
      - `topCategories` NameCount[], nullable
        - `name` string, nullable
        - `count` integer, nullable
      - `topLabels` NameCount[], nullable
        - `name` string, nullable
        - `count` integer, nullable
      - `topCountries` NameCount[], nullable
        - `name` string, nullable
        - `count` integer, nullable
      - `avgMonthlyPosts` integer, nullable
      - `twitterHandle` string, nullable
      - `twitterBio` string, nullable
      - `imageUrl` string, nullable
      - `linkedinUrl` string, nullable
      - `linkedinConnections` integer, nullable
      - `linkedinFollowers` integer, nullable
      - `facebookUrl` string, nullable
      - `instagramUrl` string, nullable
      - `websiteUrl` string, nullable
      - `blogUrl` string, nullable
      - `tumblrUrl` string, nullable
      - `youtubeUrl` string, nullable
    - `highlights` object, nullable
    - `vectors` VectorData[], nullable
      - `data` number[], nullable
      - `version` integer, nullable

## Other responses

- `400` — 400 - Bad Request
- `401` — 401 - Invalid API Key
- `403` — 403 - Request Forbidden
- `429` — 429 - Too Many Requests
- `500` — 500 - Server Error

## Changes

- **2026-05-07** `2c55bf07003a` — 2 info
  - added the optional property `articles/items/cluster/allOf[#/components/schemas/NewsCluster]/sourceDiversity` to the response with the `200` status
  - added the optional property `articles/items/vectors` to the response with the `200` status
- **2026-04-30** `182b74871f6a` — 1 info
  - added the optional property `articles/items/cluster/allOf[#/components/schemas/NewsCluster]/locations/items/country` to the response with the `200` status
- **2026-01-05** `6e5653025581` — 4 info
  - added the new optional `query` request parameter `excludeSourceCity`
  - added the new optional `query` request parameter `excludeSourceCountry`
  - added the new optional `query` request parameter `excludeSourceCounty`
  - added the new optional `query` request parameter `excludeSourceState`
- **2025-09-26** `41e61f364687` — 4 info
  - added the new optional `query` request parameter `excludeWatchlist`
  - added the new optional `query` request parameter `summary`
  - added the new optional `query` request parameter `watchlist`
  - added the optional property `articles/items/enContentWordCount` to the response with the `200` status
- …earlier changes not shown

[Full history](https://skmtc.dev/goperigon/apis/perigon-api/changes/v1/articles/all/get.md)

---

[API](https://skmtc.dev/goperigon/apis/perigon-api.md) · [All operations](https://skmtc.dev/goperigon/apis/perigon-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/goperigon/perigon-api/revisions/2c55bf07003a/schema)