Skip to main content

Recommendations

Workspace-specific sponsorship targets — brands algorithmically matched to your profile, hot brands active in your signals, and their key contacts.


get_recommendations​

Your workspace's current sponsorship targets with match rationale and attack angles.

Parameters​

NameTypeRequiredDescription
limitnumberNoMax rows per list (default: 100, max: 100). Lower it for a lighter response.

The workspace is resolved from your sign-in.

Returns​

The /targets payload:

  • recommendations: ranked list of { brandId, name, domain, angles, whyItFits, whatsHappening, signalsShown, signalTokens, ... }, capped at limit rows
  • hotBrands: brands recently active in signals relevant to your workspace, same shape and cap
  • totalRecommendations / totalHotBrands: full counts, so a cap is never silent
  • Workspace daily insight metadata (updatedAt, hotCoverage)

Each row's heavier fields are size-capped for the same reason the row lists are: angles/signalTokens/signalsShown to 5 items, sources to 3, and whyItFits.explanation/whyItFits.insight/whatsHappening.latest.summary to a few hundred characters. This keeps a 100-row response well within a normal tool-result budget without losing the fields' meaning — nothing here is the place to look for a full press-article body (see get_signal in Signals for that).

Example prompt​

"What brands should I pitch this week?"


get_hot_brands​

Materialized list of brands that appeared in signals matching your workspace's filters.

Parameters​

NameTypeRequiredDescription
limitnumberNoMax brands (default: 20)

Returns​

{ brands, signals, bucketCounts, updatedAt, totalBrands, totalSignals }. limit caps both brands and signals; compare against totalBrands/totalSignals to see whether the list was truncated. signals are feed-style rows with a single collapsed title/summary (truncated to a preview length — use get_signal for the full article). Each brand row's signalTokens is capped at 5.

Example prompt​

"Which brands are most active in sports sponsorship signals for my workspace right now?"


get_hot_brand_contacts​

Key decision-makers (email, phone, LinkedIn) for your hot brands, identified via the Lemlist people database.

Parameters​

NameTypeRequiredDescription
brand_namestringNoFilter to one brand name. Omit to get all hot brand contacts.

Returns​

List of { brand_name, person: { full_name, current_role, company, email, phone, linkedin_url }, starred }.

starred: true means this person was mentioned in a recent signal or is in the top-N contacts for their brand.

Example prompt​

"Who are the decision-makers at Adidas France I should contact?"


get_targets​

Return the workspace's full target set — recommendations plus hot brands in one payload. A convenience read that combines what get_recommendations and get_hot_brands surface.

Parameters​

NameTypeRequiredDescription
limitnumberNoMax rows per list (default: 100, max: 100).

Returns​

{ recommendations, hotBrands, totalRecommendations, totalHotBrands, updatedAt, hotCoverage } scoped to the workspace — same shape and same per-row field capping as get_recommendations.

Example prompt​

"Give me my targets for this week"