Skip to main content
POST
Score articles by portfolio relevance
Use this endpoint to rank a news feed for a portfolio without generating a scenario tree. Send up to 100 articles per request and compare relevance_score values within the response. Each article may contain up to 50,000 content characters, with a maximum of 2,000,000 content characters across the request. Supplied article_id values must be unique within the batch. The default response_detail is score. Use explain when you also need the classification reason and leading portfolio contributors. Use full only for debugging or deeper analysis. Article classification is cached independently of the portfolio. Reusing the same headline, content, and publication time across portfolios avoids repeating the classification work, while each portfolio still receives its own relevance score.

Authorizations

X-Api-Key
string
header
required

Body

application/json
portfolio_weights
object
required

Portfolio weights keyed by tilt_id or CUSIP. Mixed identifiers are allowed; CUSIPs are resolved to tilt_ids server-side.

articles
object[]
required
Required array length: 1 - 100 elements
response_detail
enum<string>
default:score

score returns ranking fields only; explain adds the reason and portfolio contribution summary; full also returns the classified impact profile and raw impact measures.

Available options:
score,
explain,
full

Response

200 - application/json

Portfolio relevance scores and any per-article processing errors

success
boolean
required
score_version
string
required
results
object[]
required
errors
object[]
required