Entity Relevance Tiers
When articles are returned from the Read Articles Endpoint, each article contains three separate arrays of entity IDs. These arrays represent different levels of relevance — how central a given entity is to the article's content.
| Field | Tier | Relevance Level | Description |
|---|---|---|---|
primary_entities |
Primary | Highest | Core entities the article is primarily about |
secondary_entities |
Secondary | Medium | Entities meaningfully mentioned or discussed |
tertiary_entities |
Tertiary | Lowest | Entities briefly or peripherally referenced |
All three arrays contain integer entity IDs. Use the Entity Lookup Endpoint to convert any of these IDs into entity names and metadata.
Note
An entity ID will appear in only one tier per article. The tiers are mutually exclusive.
Primary Entities
Primary entities are the most highly relevant entities in the article — the subjects the piece is principally about. These are the entities you should display prominently when presenting the article (e.g., as headline tags or in a company card).
Field name: primary_entities
Format: Array of integer entity IDs
Example use cases:
- Displaying key company/person tags on an article card
- Filtering or grouping articles by their main subjects
- Building entity-centric dashboards
Secondary Entities
Secondary entities are tagged with medium relevance — they are meaningfully discussed in the article but are not its primary focus.
Field name: secondary_entities
Format: Array of integer entity IDs
Example use cases:
- Showing a broader set of related entities in a detail view
- Building relationship graphs between entities mentioned together
Tertiary Entities
Tertiary entities are tagged with low relevance — they appear briefly or peripherally in the article.
Field name: tertiary_entities
Format: Array of integer entity IDs
Example use cases:
- Comprehensive entity extraction for data pipelines
- Background context for advanced analytics
Converting IDs to Names
All three arrays contain raw integer IDs. To display entity names, pass the IDs to the Entity Lookup Endpoint. You can pass IDs from multiple tiers in a single call.
Read Articles Endpoint Entity Lookup Endpoint
Home PowerIntell.AI™ Apollo Pro® RegLens®