Content

Get a list of topics in the content graph. Topics are ordered by that occur on the most documents will be returned first.

curl -s -H "Authorization: $LIOKEY" \
 -XGET "https://api.lytics.io/api/content/topic" | jq '.'

Content-Type: application/json

{
  "status": 200,
  "message": "success",
  "data": [
    {
      "label": "Data-First Marketing",
      "doc_count": 275,
      "total": 380636,
      "missing": 216048,
      "present": 143710,
      "avg": 0.5983867964798089,
      "tags": [
        "custom"
      ]
    },
    {
      "label": "User Data Unification",
      "doc_count": 273,
      "total": 380636,
      "missing": 216048,
      "present": 154068,
      "avg": 0.6036863622558337,
      "tags": [
        "custom"
      ]
    },
    {
      "label": "Customer Data Platform",
      "doc_count": 313,
      "total": 380260,
      "missing": 216043,
      "present": 159628,
      "avg": 0.9704200631406573,
      "tags": [
        "custom"
      ]
    }
  ]
}

Get list of topic rollups.

curl "$LIOAPI/api/content/topicrollup" -s -H "Authorization: $LIOKEY" | jq '.'

Content-Type: application/json

{
    "data": [
        {
            "id": "6a7f76ff97ad0e3e96c162f74aee8f8f",
            "account_id": "2b15cafb441e477cad3ffbe62c4d5966",
            "label": "Baking rollup",
            "created": "2014-08-04T21:18:20.124Z",
            "updated": "2014-08-04T21:18:20.124Z",
            "topics": [
              {
                "label": "Recipe",
                "value": 0.66
              },
              {
                "label": "baking",
                "value": 0.55
              }
            ]
        }
    ]
}

Fetch a topic rollup by id

Content-Type: application/json

{
  "data": {
    "id": "6a7f76ff97ad0e3e96c162f74aee8f8f",
    "account_id": "2b15cafb441e477cad3ffbe62c4d5966",
    "label": "Baking rollup",
    "created": "2014-08-04T21:18:20.124Z",
    "updated": "2014-08-04T21:18:20.124Z",
    "topics": [
      {
        "label": "Recipe",
        "value": 0.66
      },
      {
        "label": "baking",
        "value": 0.55
      }
    ]
  }
}

Topic Rollups can be created with a variety of different configurations. To determine the right configuration for you, please consult the following examples:

Suppose the topic-affinities (lytics_content) for a given user is defined as:

{
  "Chex Mix": 0.5,
  "Cheetos": 0.3,
  "Pretzel": 0.2
}

1) Overwriting Topic Affinities

// topic rollup
{
  "overwrite": "replace",
  "label": "Snacks",
  "topics": [
    {
      "label": "Cheetos",
      "value": 1.0
    },
    {
      "label": "Chex Mix",
      "value": 1.0
    }
  ]
}

// topic affinites for user: 
{
  "Snacks": 0.4,
  "Pretzel": 0.2
}

2) Add to Topic Affinities

// topic rollup
{
  "overwrite": "append",
  "label": "Snacks",
  "topics": [
    {
      "label": "Cheetos",
      "value": 1.0
    },
    {
      "label": "Chex Mix",
      "value": 1.0
    }
  ]
}

// topic affinites for user: 
{
  "Snacks": 0.4,
  "Chex Mix": 0.5,
  "Cheetos": 0.3,
  "Pretzel": 0.2
}

Creating new Topic Rollups:

curl -s -XPOST "https://api.lytics.io/api/content/topicrollup" \
    -H "Content-type: application/json" \
    -H "Authorization: $LIOKEY" \
    -d'
{
  "label": "Baking rollup",
  "acctid": "123456",
  "topics": [
      {"label": "Recipe"},
      {"label": "baking"}
  ]
}
' | jq '.'

Content-Type: application/json

{
  "data": {
    "id": "6a7f76ff97ad0e3e96c162f74aee8f8f",
    "account_id": "2b15cafb441e477cad3ffbe62c4d5966",
    "label": "Baking rollup",
    "created": "2014-08-04T21:18:20.124Z",
    "updated": "2014-08-04T21:18:20.124Z",
    "topics": [
      {
        "label": "Recipe",
        "value": 0.66
      },
      {
        "label": "baking",
        "value": 0.55
      }
    ]
  }
}

Delete a topic rollup

Fetch the blacklisted topics

Content-Type: application/json

  {
    "status": 200,
    "message": "success",
    "data": [
      {
        "label": "Data-First Marketing",
        "doc_count": 275,
        "total": 380636,
        "missing": 216048,
        "present": 143710,
        "avg": 0.5983867964798089,
        "tags": [
          "blacklisted"
        ]
      },
      {
        "label": "User Data Unification",
        "doc_count": 273,
        "total": 380636,
        "missing": 216048,
        "present": 154068,
        "avg": 0.6036863622558337,
        "tags": [
          "blacklisted"
        ]
      }
    ]
  }

Blacklist or un-blacklist topics to an account's topic-blacklist

# to blacklist certain topics
curl -s -XPOST "https://api.lytics.io/api/content/topicblacklist" \
    -H "Content-type: application/json" \
    -H "Authorization: $LIOKEY" \
    -d'
{
  "method": "add",
  "ids": ["Data-First Marketing", "User Data Unification"]
}
' | jq '.'

# to unblacklist certain topics
curl -s -XPOST "https://api.lytics.io/api/content/topicblacklist" \
    -H "Content-type: application/json" \
    -H "Authorization: $LIOKEY" \
    -d'
{
  "method": "delete",
  "ids": ["Data-First Marketing", "User Data Unification"]
}
' | jq '.'

Content-Type: application/json

  {
    "status": 200,
    "message": "success",
    "data": [
      {
        "label": "Data-First Marketing",
        "doc_count": 275,
        "total": 380636,
        "missing": 216048,
        "present": 143710,
        "avg": 0.5983867964798089,
        "tags": [
          "blacklisted"
        ]
      },
      {
        "label": "User Data Unification",
        "doc_count": 273,
        "total": 380636,
        "missing": 216048,
        "present": 154068,
        "avg": 0.6036863622558337,
        "tags": [
          "blacklisted"
        ]
      }
    ]
  }

Replace topics in an account's topic-blacklist

curl -s -XPOST "https://api.lytics.io/api/content/topicblacklist" \
    -H "Content-type: application/json" \
    -H "Authorization: $LIOKEY" \
    -d'
{
  "ids": ["Data-First Marketing", "User Data Unification"]
}
' | jq '.'

Content-Type: application/json

  {
    "status": 200,
    "message": "success",
    "data": [
      {
        "label": "Data-First Marketing",
        "doc_count": 275,
        "total": 380636,
        "missing": 216048,
        "present": 143710,
        "avg": 0.5983867964798089,
        "tags": [
          "blacklisted"
        ]
      },
      {
        "label": "User Data Unification",
        "doc_count": 273,
        "total": 380636,
        "missing": 216048,
        "present": 154068,
        "avg": 0.6036863622558337,
        "tags": [
          "blacklisted"
        ]
      }
    ]
  }

Add a document to the content table corpus. Either a URL or text must be provided. This allows entry of documents/content that get added to content table, content-graph and available for usage in recommendation, as well as content-explorer.

• id if you upload the document more than once, ensure it has common id so only one document is created

• Custom Attributes Any attributes you upload that are not reserved, will be added to content document.

# Upsert a document into content table and classify it
curl -s -XPOST "https://api.lytics.io/api/content/corpus" \
  -H "Authorization: $LIOKEY" \
  -H "Content-Type: application/json" \
  -d '{
    "id":"doc_id_123",
    "text":"big-long-body-of text for classification",
    "custom_attribute_name":"custom attribute"
}' | jq '.'


# upsert a url into db
#  url is used as document id
curl -s -XPOST "https://api.lytics.io/api/content/corpus" \
  -H "Authorization: $LIOKEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url":"http://www.validdomain/validurl.html",
    "custom_attribute_name":"custom attribute"
}' | jq '.'

Content-Type: application/json

{
    "status": 200,
    "message": "success",
    "data": {
        "body": "here is some body text for the Corpus API",
        "source": "upload",
        "updated": "2016-09-13 21:59:38.551972802 -0400 EDT",
        "created": "2016-09-13 21:59:38.551972802 -0400 EDT",
        "url": "https://www.getlytics.com/blog/post/improving_google_analytics?utm_source=linkedin",
        "global": {
            "Topic A": 1.0,
            "Topic B": 1.0
        }
     }
}

Add a topic to a Document. Note that while this API will add the topic to a Document, it may take several days or the topic to appear in a users's topic-affinity.

# Add a topic to a document
curl -s -XPOST "https://api.lytics.io/api/content/doc/hashedurl/4525087172572165639/topic/Chocolate?relevance=1.0" \
  -H "Authorization: $LIOKEY" \
| jq '.'

Content-Type: application/json

{
    "status": 200,
    "message": "success",
    "data": {
        "author": "Cookie Monster",
        "created": "2016-01-14T08:39:01.354824186-07:00",
        "description": "you should definitely make these cookies",
        "fetched": "2016-07-19T13:39:20.158747984-04:00",
        "id": "4525087172572165639",
        "meta": [
            "og:locale/en_US"
        ],
        "primary_image": "http://cookdiary.net/wp-content/uploads/images/Oatmeal-Chocolate-Chip-Cookies_1441.jpg",
        "stream": "default",
        "title": "how to make some cookies",
        "topic_relevances": {
            "Recipe": 0.64,
            "baking": 0.75
        },
        "topic_rollups": {
            "Things": 0.75
        },
        "topics": [
            "baking",
            "Recipe"
        ],
        "updated": "2016-07-19T13:34:18-04:00",
        "url": "www.recipes.com/chocolate-chip-cookies"
    }
}

Remove a topic from a Document. Note that while this API will remove the topic from a Document, it may take several days for the topic to be removed from a user's topic-affininty.

# Remove a topic from a document
curl -s -XDELETE "https://api.lytics.io/api/content/doc/hashedurl/4525087172572165639/topic/Recipe" \
  -H "Authorization: $LIOKEY" \
| jq '.'