Skip to main content

Update filter links

Migration Guide for Adapting existing filter-links to the new Social Knowledge Graph

1. Background​

With the introduction of the Social Knowledge Graph, the data model has been extended to include namespaces. Every property or type name must now be prefixed with its corresponding namespace. At the same time, the delimiter for logical OR constructs in path segments has changed.

2. Summary of changes​

  1. The colon (:) used as an OR operator in path segments has been replaced by the pipe (|).
  2. Namespace prefixes are now required for all data elements (types, terms, properties).

Namespace definitions All data elements (types, terms, properties) must be prefixed with their namespace. Example:

  • Types: schema:Event, schema:MusicEvent
  • Terms: venus:architectural_monument_single, venus:topic_xyz

3. Detailed changes​

3.1 OR operator in path segments​

Before:

/type=Person:Organization

After:

/type=Person|Organization

Further documentation: Pipe (vertical bar) as a delimiter

3.2 Namespace prefix​

Every filter parameter referring to a type or term must include a namespace.

Types:

  • schema:Event instead of Event
  • schema:MusicEvent instead of MusicEvent

Terms / Topics:

  • venus:architectural_monument_single instead of architectural_monument_single

See: Namespaces in the data model

4. Example migration​

Before

GET /entities/filter?type=Event&time=2025-05-06,2025-05-09

GET /entities/filter?type=MusicEvent&topic=architectural_monument_single&time=2025-05-06,2025-05-09

After

GET /entities/filter?type=schema:Event&time=2025-05-06,2025-05-09

GET /entities/filter?type=schema:MusicEvent&topic=venus:architectural_monument_single&time=2025-05-06,2025-05-09

5. References & further links​

  • All available types and terms A complete overview of all namespaces, types, and terms can be found here.
  • Filter link path segments Details on using pipes as OR delimiters can be found here