ContentGems Developer Documentation

Developer documentation home

API documentation

Website widget documentation

ContentGems web app

API info page

Interest Folders and Interests

Returns a list of all Interest Folders and their included Interests for the authenticated user.

Resource URL

GET https://contentgems.com/api/v1/interest_folders.json

Request Parameters

N/A

Response Attributes

The response is an array of Interest Folder objects with the following attributes:

Interest Folder Attributes:

NameDescription
idThe Interest Folder's id.
nameThe Interest Folder's name.
interestsA list of Interests inside the current Interest Folder. See below for the Interest attributes.

Interest Attributes:

NameDescription
idThe Interest's id.
nameThe Interest's name.
queryThe Interest's query.

Example

Request:

GET https://contentgems.com/api/v1/interest_folders.json

Response:

[
  {
    "id": 1789,
    "name": "Content Marketing",
    "interests": [
      {
        "id": 1433,
        "name": "Curation",
        "query": "curation \"content curation\" curate"
      },
      ... (more interests)
    ]
  },
  ... (more interest folders)
]