Appearance
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).
OpenAPI definition
json
{
"openapi": "3.1.0",
"info": {
"title": "Get Intel Profiles",
"description": "API for Feedly Enterprise features including Entity Lists — curated collections of named entities (companies, technologies, threat actors, etc.) used to scope and filter intelligence feeds across your organization.\n",
"version": "3.0",
"contact": {
"name": "Feedly Support",
"url": ""
}
},
"servers": [
{
"url": "https://api.feedly.com/v3",
"description": "Feedly Production API"
}
],
"security": [
{
"BearerAuth": []
}
],
"tags": [
{
"name": "Entity Lists",
"description": "Manage and retrieve enterprise entity lists"
}
],
"paths": {
"/enterprise/entityLists": {
"get": {
"operationId": "getEntityLists",
"summary": "Get Intel Profile data",
"description": "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.\n\nEntity members may be resolved Feedly entities (returned with an `id`) or unresolved custom text strings (returned with a `text` field only).\n",
"tags": [
"Entity Lists"
],
"parameters": [
{
"name": "details",
"in": "query",
"required": false,
"description": "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.\n",
"schema": {
"type": "boolean",
"default": false
},
"example": true
}
],
"security": [
{
"BearerAuth": []
}
],
"responses": {
"200": {
"description": "An array of entity list objects for the enterprise account. Returns all lists when `details=true`, each fully populated with its entity membership.\n",
"headers": {
"Content-Type": {
"schema": {
"type": "string",
"example": "application/json;charset=UTF-8"
}
}
},
"content": {
"application/json": {
"schema": {
"type": "array",
"items": {
"$ref": "#/components/schemas/EntityList"
}
},
"example": [
{
"label": "A1 Customers",
"id": "nlp/f/entity/cl:christeam:A1Customers-lr7vjf",
"type": "customTopic",
"description": "adope, Adobe, Apple, Microsoft, Microsoft Azure",
"createdBy": "7b966855-c953-4ec8-b271-cf554996c1ab",
"created": 1679494776618,
"inferredType": "org",
"entities": [
{
"text": "adope"
},
{
"id": "nlp/f/entity/gz:org:adobe"
},
{
"id": "nlp/f/entity/gz:org:apple"
},
{
"id": "nlp/f/entity/gz:org:microsoft"
},
{
"id": "nlp/f/entity/gz:org:microsoft-azure"
}
]
},
{
"label": "ACME Tech Stack",
"id": "nlp/f/entity/cl:christeam:ACMETechStack-yzg276",
"type": "customTopic",
"description": "Adobe, Apple, Cisco, Fortinet, Google, Google Chrome, Mandiant, Microsoft, UXLINK, Log4j",
"createdBy": "31b26dc3-6b98-4192-b906-89aa8952fe47",
"created": 1750963550938,
"inferredType": "org",
"updated": 1774032310459,
"updatedBy": "d7fa6923-61da-4f14-abc2-4871d985bb30",
"entities": [
{
"id": "nlp/f/entity/gz:org:adobe"
},
{
"id": "nlp/f/entity/gz:org:apple"
},
{
"id": "nlp/f/entity/gz:org:cisco-systems"
},
{
"id": "nlp/f/entity/gz:org:fortinet"
},
{
"id": "nlp/f/entity/gz:org:google"
},
{
"id": "nlp/f/entity/gz:org:mandiant"
},
{
"id": "nlp/f/entity/gz:org:microsoft"
},
{
"id": "nlp/f/entity/gz:org:log4j"
}
]
}
]
}
}
},
"400": {
"description": "Bad request — invalid query parameter value.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"example": {
"errorCode": 400,
"message": "Invalid value for parameter 'details'. Expected boolean."
}
}
}
},
"401": {
"description": "Unauthorized — the Bearer token is missing, expired, or invalid.\n",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"example": {
"errorCode": 401,
"message": "Unauthorized. Please provide a valid Bearer token."
}
}
}
},
"403": {
"description": "Forbidden — the authenticated user does not have enterprise access or lacks permission to view entity lists.\n",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"example": {
"errorCode": 403,
"message": "Access denied. Enterprise subscription required."
}
}
}
},
"429": {
"description": "Rate limit exceeded.",
"headers": {
"Retry-After": {
"description": "Number of seconds to wait before retrying.",
"schema": {
"type": "integer"
}
}
},
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
},
"example": {
"errorCode": 429,
"message": "Too many requests. Please slow down."
}
}
}
},
"500": {
"description": "Internal server error.",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/ErrorResponse"
}
}
}
}
}
}
}
},
"components": {
"securitySchemes": {
"BearerAuth": {
"type": "http",
"scheme": "bearer",
"bearerFormat": "JWT",
"description": "Feedly personal access token. Pass as `Authorization: Bearer <token>`. Tokens can be generated from your Feedly account settings or provisioned by your Feedly Enterprise admin.\n"
}
},
"schemas": {
"EntityList": {
"type": "object",
"description": "A named collection of entities used to scope monitoring within Feedly Enterprise. Lists always have type `customTopic` and contain a mix of resolved Feedly entities (with `id`) and unresolved custom text terms (with `text` only).\n",
"required": [
"id",
"label",
"type",
"description",
"createdBy",
"created",
"entities"
],
"properties": {
"id": {
"type": "string",
"description": "Unique identifier for the entity list. Follows the pattern `nlp/f/entity/cl:{teamId}:{label}-{shortHash}`.\n",
"example": "nlp/f/entity/cl:christeam:A1Customers-lr7vjf"
},
"label": {
"type": "string",
"description": "Human-readable name for the entity list, as set by the creator.",
"example": "A1 Customers"
},
"type": {
"type": "string",
"description": "The list type. Always `customTopic` for enterprise entity lists created via the Feedly UI or API.\n",
"enum": [
"customTopic"
],
"example": "customTopic"
},
"description": {
"type": "string",
"description": "Auto-generated comma-separated summary of the entity labels contained in the list. Truncated for large lists.\n",
"example": "Adobe, Apple, Cisco, Fortinet, Google"
},
"createdBy": {
"type": "string",
"format": "uuid",
"description": "UUID of the Feedly user who created this entity list.",
"example": "7b966855-c953-4ec8-b271-cf554996c1ab"
},
"created": {
"type": "integer",
"format": "int64",
"description": "Unix timestamp in milliseconds when the list was created.",
"example": 1679494776618
},
"inferredType": {
"type": "string",
"description": "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.\n",
"example": "org"
},
"updated": {
"type": "integer",
"format": "int64",
"description": "Unix timestamp in milliseconds when the list was last modified. Only present if the list has been edited after initial creation.\n",
"example": 1774032310459
},
"updatedBy": {
"type": "string",
"format": "uuid",
"description": "UUID of the Feedly user who last modified this entity list. Only present alongside `updated`.\n",
"example": "d7fa6923-61da-4f14-abc2-4871d985bb30"
},
"entities": {
"type": "array",
"description": "The members of this entity list. Each member is either a resolved Feedly entity (has an `id`) or an unresolved custom text term (has a `text` field only). Only populated when the request is made with `details=true`.\n",
"items": {
"$ref": "#/components/schemas/EntityMember"
}
}
}
},
"EntityMember": {
"type": "object",
"description": "A member of an entity list. Members are one of two forms:\n- **Resolved entity**: has an `id` pointing to a known Feedly entity\n (e.g., `nlp/f/entity/gz:org:microsoft`). These are matched against\n Feedly's knowledge graph.\n\n- **Custom text term**: has only a `text` field. These are free-text strings\n that do not resolve to a known entity but are still tracked as keywords.\n\nExactly one of `id` or `text` will be present on each member object.\n",
"properties": {
"id": {
"type": "string",
"description": "Feedly entity identifier. Format: `nlp/f/entity/gz:{type}:{slug}`. Present when the member is a resolved entity in Feedly's knowledge graph.\n",
"example": "nlp/f/entity/gz:org:microsoft"
},
"text": {
"type": "string",
"description": "Raw custom text string. Present when the member is an unresolved or user-defined term that does not map to a known Feedly entity.\n",
"example": "adope"
}
}
},
"ErrorResponse": {
"type": "object",
"properties": {
"errorCode": {
"type": "integer",
"description": "HTTP status code echoed in the response body.",
"example": 401
},
"message": {
"type": "string",
"description": "Human-readable description of the error.",
"example": "Unauthorized. Please provide a valid Bearer token."
}
}
}
}
},
"x-readme": {
"explorer-enabled": true,
"proxy-enabled": true
},
"_id": {
"buffer": {
"0": 105,
"1": 221,
"2": 22,
"3": 183,
"4": 152,
"5": 183,
"6": 126,
"7": 155,
"8": 82,
"9": 246,
"10": 86,
"11": 86
}
}
}