Copy page

Core Concepts

Working with Entities

Entities are a core concept in the IntelCenter API.

They represent organizations, groups, or sources associated with intelligence content.

---

Using the Entity Parameter

Many endpoints support filtering by entity:

Code
/v1/icdb/videos?entity=Houthis [Ansar Allah]

---

Notes on Entity Usage

• Entity values must match the indexed name
• Entity filters can be combined with other parameters
• Results are limited to records associated with that entity

---

Entity Restrictions

Some API keys may restrict which entities are accessible.

If restrictions apply:

• Only allowed entities will return results
• Other entities may return empty results or be blocked

---

Best Practices

• Use entity filters for precise queries
• Combine entity with date and country filters
• Use Natural Language Search if entity names are unknown

---

Example Combined Query

Code
/v1/icdb/videos?entity=Houthis [Ansar Allah]&country=yemen&date_from=2024-01-01