pub.chive.discovery.settings

chive.pub

Documentation

User discovery preferences for personalized recommendations

main record

User discovery preferences for personalized recommendations

Record Key self

Properties

citationNetworkDisplay string Optional

How to display citation network

Known values: hidden, preview, expanded
Default: preview
enablePersonalization boolean Optional

Enable personalized recommendations based on profile

Default: true
followedFieldUris array of string at-uri Optional

Field URIs the user follows for discovery (distinct from work fields in profile)

maxLength: 50 items
followingTabIncludesWorkFields boolean Optional

Whether the Following tab also includes the user's work fields

Default: false
minimumEndorsementThreshold integer Optional

Minimum number of endorsements for a paper to appear in recommendations

minimum: 0maximum: 10
Default: 0
recommendationDiversity string Optional

How diverse recommendations should be relative to user's fields

Known values: low, medium, high
Default: medium
schemaRevision integer Optional

Schema revision this record was created with. Absent means revision 1.

minimum: 1
showRecommendationReasons boolean Optional

Show explanations for why papers are recommended

Default: true
View raw schema 
{
  "key": "self",
  "type": "record",
  "record": {
    "type": "object",
    "properties": {
      "schemaRevision": {
        "type": "integer",
        "minimum": 1,
        "description": "Schema revision this record was created with. Absent means revision 1."
      },
      "followedFieldUris": {
        "type": "array",
        "items": {
          "type": "string",
          "format": "at-uri"
        },
        "maxLength": 50,
        "description": "Field URIs the user follows for discovery (distinct from work fields in profile)"
      },
      "trendingPreferences": {
        "ref": "#trendingPreferences",
        "type": "ref",
        "description": "Preferences for the trending feed"
      },
      "relatedPapersSignals": {
        "ref": "#relatedPapersSignals",
        "type": "ref",
        "description": "Signals to use for related papers"
      },
      "relatedPapersWeights": {
        "ref": "#relatedPapersWeights",
        "type": "ref",
        "description": "Relative weights for related papers signals"
      },
      "enablePersonalization": {
        "type": "boolean",
        "default": true,
        "description": "Enable personalized recommendations based on profile"
      },
      "citationNetworkDisplay": {
        "type": "string",
        "default": "preview",
        "description": "How to display citation network",
        "knownValues": [
          "hidden",
          "preview",
          "expanded"
        ]
      },
      "recommendationDiversity": {
        "type": "string",
        "default": "medium",
        "description": "How diverse recommendations should be relative to user's fields",
        "knownValues": [
          "low",
          "medium",
          "high"
        ]
      },
      "relatedPapersThresholds": {
        "ref": "#relatedPapersThresholds",
        "type": "ref",
        "description": "Thresholds for related papers filtering"
      },
      "showRecommendationReasons": {
        "type": "boolean",
        "default": true,
        "description": "Show explanations for why papers are recommended"
      },
      "minimumEndorsementThreshold": {
        "type": "integer",
        "default": 0,
        "maximum": 10,
        "minimum": 0,
        "description": "Minimum number of endorsements for a paper to appear in recommendations"
      },
      "followingTabIncludesWorkFields": {
        "type": "boolean",
        "default": false,
        "description": "Whether the Following tab also includes the user's work fields"
      }
    }
  },
  "description": "User discovery preferences for personalized recommendations"
}
relatedPapersSignals object

Configuration for related papers panel signals

Properties

authors boolean Optional

Show papers by overlapping authors

bibliographicCoupling boolean Optional

Show papers that cite the same references

citations boolean Optional

Show citation-based relationships

coCitation boolean Optional

Show papers frequently cited together

collaborative boolean Optional

Show collaborative filtering recommendations

semantic boolean Optional

Show semantically similar papers (SPECTER2 / MLT)

topics boolean Optional

Show topic/concept-based relationships

View raw schema 
{
  "type": "object",
  "properties": {
    "topics": {
      "type": "boolean",
      "default": true,
      "description": "Show topic/concept-based relationships"
    },
    "authors": {
      "type": "boolean",
      "default": true,
      "description": "Show papers by overlapping authors"
    },
    "semantic": {
      "type": "boolean",
      "default": true,
      "description": "Show semantically similar papers (SPECTER2 / MLT)"
    },
    "citations": {
      "type": "boolean",
      "default": true,
      "description": "Show citation-based relationships"
    },
    "coCitation": {
      "type": "boolean",
      "default": false,
      "description": "Show papers frequently cited together"
    },
    "collaborative": {
      "type": "boolean",
      "default": false,
      "description": "Show collaborative filtering recommendations"
    },
    "bibliographicCoupling": {
      "type": "boolean",
      "default": false,
      "description": "Show papers that cite the same references"
    }
  },
  "description": "Configuration for related papers panel signals"
}
relatedPapersThresholds object

Thresholds for related papers filtering

Properties

maxResults integer Optional

Maximum number of related papers to show

minimum: 1maximum: 50
minScore integer Optional

Minimum combined score to include a paper (0-100, maps to 0.0-1.0)

minimum: 0maximum: 100
View raw schema 
{
  "type": "object",
  "properties": {
    "minScore": {
      "type": "integer",
      "default": 5,
      "maximum": 100,
      "minimum": 0,
      "description": "Minimum combined score to include a paper (0-100, maps to 0.0-1.0)"
    },
    "maxResults": {
      "type": "integer",
      "default": 10,
      "maximum": 50,
      "minimum": 1,
      "description": "Maximum number of related papers to show"
    }
  },
  "description": "Thresholds for related papers filtering"
}
relatedPapersWeights object

Relative importance of each related papers signal (0-100, auto-normalized)

Properties

authorNetwork integer Optional

Weight for co-author network proximity

minimum: 0maximum: 100
coCitation integer Optional

Weight for co-citation and bibliographic coupling

minimum: 0maximum: 100
collaborative integer Optional

Weight for collaborative filtering signal

minimum: 0maximum: 100
conceptOverlap integer Optional

Weight for OpenAlex concept/topic overlap

minimum: 0maximum: 100
semantic integer Optional

Weight for SPECTER2 / MLT semantic similarity

minimum: 0maximum: 100
View raw schema 
{
  "type": "object",
  "properties": {
    "semantic": {
      "type": "integer",
      "default": 30,
      "maximum": 100,
      "minimum": 0,
      "description": "Weight for SPECTER2 / MLT semantic similarity"
    },
    "coCitation": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 0,
      "description": "Weight for co-citation and bibliographic coupling"
    },
    "authorNetwork": {
      "type": "integer",
      "default": 15,
      "maximum": 100,
      "minimum": 0,
      "description": "Weight for co-author network proximity"
    },
    "collaborative": {
      "type": "integer",
      "default": 10,
      "maximum": 100,
      "minimum": 0,
      "description": "Weight for collaborative filtering signal"
    },
    "conceptOverlap": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 0,
      "description": "Weight for OpenAlex concept/topic overlap"
    }
  },
  "description": "Relative importance of each related papers signal (0-100, auto-normalized)"
}
trendingPreferences object

Preferences for the trending feed

Properties

defaultLimit integer Optional

Default number of trending results to show

minimum: 5maximum: 100
defaultWindow string Optional

Default time window for trending

Known values: 24h, 7d, 30d
View raw schema 
{
  "type": "object",
  "properties": {
    "defaultLimit": {
      "type": "integer",
      "default": 20,
      "maximum": 100,
      "minimum": 5,
      "description": "Default number of trending results to show"
    },
    "defaultWindow": {
      "type": "string",
      "default": "7d",
      "description": "Default time window for trending",
      "knownValues": [
        "24h",
        "7d",
        "30d"
      ]
    }
  },
  "description": "Preferences for the trending feed"
}

Lexicon Garden

@