The news search API allows you to filter and search for semantic entities. Entities are concepts that share a specific meaning but can be addressed with different names. For example, the entity "USA" has alternative names such as "US" or "United States of America" but they all refer to the same country.
When filtering for news by a certain entity, you don't have to worry about the synonym to use as the API will normalize it and find all instances of the concept regardless of the synonym you use. For example, it makes no difference whether you search for LOC:USA or LOC:United States of America
The following table shows all supported types with examples of how to use them in the entities filter in the news search endpoint.
| Type | Code | Example |
|---|---|---|
| Location | LOC | LOC:Ireland |
| Person | PER | PER:Michael Jordan |
| Organization | ORG | ORG:Tesla |
1% for fighting climate change