v1

latestOpenAPI 3.1.02026-07-244727109.8 KB
Entity Lists

Get Intel Profile data

Returns all intel profiles associated with the authenticated enterprise account. When details=true is passed, each list includes its full entity membership. Entity lists group named entities (companies, technologies, threat actors, custom text terms) that can be used to scope and filter intelligence feeds.

Entity members may be resolved Feedly entities (returned with an id) or unresolved custom text strings (returned with a text field only).

get/enterprise/entityLists

Query parameters

detailsboolean

When true, each entity list object includes the full entities array with all member IDs and text values. When omitted or false, the entities array is empty or absent.

Response

An array of entity list objects for the enterprise account. Returns all lists when details=true, each fully populated with its entity membership.

idstring required

Unique identifier for the entity list. Follows the pattern nlp/f/entity/cl:{teamId}:{label}-{shortHash}.

labelstring required

Human-readable name for the entity list, as set by the creator.

type'customTopic' required

The list type. Always customTopic for enterprise entity lists created via the Feedly UI or API.

descriptionstring required

Auto-generated comma-separated summary of the entity labels contained in the list. Truncated for large lists.

createdBystring uuid required

UUID of the Feedly user who created this entity list.

createdinteger required

Unix timestamp in milliseconds when the list was created.

inferredTypestring

The dominant entity category inferred from the list's members. Common values include org, tech, person, malware, vulnerability. Present in most lists; may be absent if the list is empty or type cannot be determined.

updatedinteger

Unix timestamp in milliseconds when the list was last modified. Only present if the list has been edited after initial creation.

updatedBystring uuid

UUID of the Feedly user who last modified this entity list. Only present alongside updated.

Example response

[
  {
    "id": "nlp/f/entity/cl:christeam:A1Customers-lr7vjf",
    "label": "A1 Customers",
    "type": "customTopic",
    "description": "Adobe, Apple, Cisco, Fortinet, Google",
    "createdBy": "7b966855-c953-4ec8-b271-cf554996c1ab",
    "created": 1679494776618,
    "inferredType": "org",
    "updated": 1774032310459,
    "updatedBy": "d7fa6923-61da-4f14-abc2-4871d985bb30",
    "entities": [
      {
        "id": "nlp/f/entity/gz:org:microsoft",
        "text": "adope"
      }
    ]
  }
]