View as Markdown
Dappier icon

Dappier ACTION

Get AI Recommendations

Get AI-ranked content recommendations for a Dappier data model (POST /app/v2/search, with data_model_id passed as a query parameter). Returns a structured results array of ranked articles (title, summary, url, score, source, pubdate, etc.). Provide a dataModelId (prefix dm_, e.g. dm_01hpsxyfm2fwdt2zet9cg6fdxt - a known real-time web search data model). NOTE dm_ data-model IDs are distinct from the am_ AI-model IDs used by Search Real-Time Data. There is no listing endpoint in the Dappier API; discover valid data model IDs in the Dappier Marketplace at https://platform.dappier.com/marketplace. Example: dataModelId=dm_01hpsxyfm2fwdt2zet9cg6fdxt, query=top technology stories today returns the top-ranked matching articles; pass fields=["title","url","summary"] to trim each result to just those keys. See the documentation.
  • Action
  • Read only
  • API key
  • SDK
  • MCP

IMPLEMENTATION

Call this tool

Connect a user's Dappier account once, then configure and run Get AI Recommendations from your backend or agent.

import { PipedreamClient } from "@pipedream/sdk"

const pd = new PipedreamClient({
  projectId: process.env.PIPEDREAM_PROJECT_ID!,
  clientId: process.env.PIPEDREAM_CLIENT_ID!,
  clientSecret: process.env.PIPEDREAM_CLIENT_SECRET!,
  projectEnvironment: "production",
})

const result = await pd.actions.run({
  id: "dappier-get-ai-recommendations",
  externalUserId: "{external_user_id}", // any stable ID for this user in your system
  configuredProps: {
    dappier: { authProvisionId: "apn_xxxxxxx" },
    dataModelId: "Data Model ID",
    query: "Query",
  },
})

console.log(result)

SCHEMA

Inputs

Pipedream supplies the connected account. Your application provides the operation-specific values below. Dynamic inputs are resolved against that user's account.

Get AI Recommendations inputs
Property Type Description
dataModelId Data Model ID string
The Dappier data model ID to query (prefix dm_, e.g. dm_01hpsxyfm2fwdt2zet9cg6fdxt, a known real-time web search data model). This is a data-model ID, distinct from the am_ AI-model IDs used by Search Real-Time Data. Discover valid IDs in the Dappier Marketplace: https://platform.dappier.com/marketplace (the Dappier API exposes no listing endpoint). Sent as the data_model_id query parameter.
Required
query Query string
The natural-language query or context used to rank recommendations. Example: top technology stories today.
Required
searchAlgorithm Search Algorithm string
Ranking algorithm to apply. One of: most_recent, semantic, most_recent_semantic, trending. Defaults to semantic.
Optional
similarityTopK Similarity Top K integer
Number of top semantically similar items to consider. Min 1, max 1000. Defaults to 9.
Optional
numResults Number of Results integer
Number of recommendation results to return. Min 1, max 100. Defaults to 10.
Optional
numArticlesRef Number of Articles from Ref integer
Minimum number of articles to return from the ref domain. Min 0 (0 = no domain-specific articles required), max 100. Defaults to 0.
Optional
ref Ref Domain string
Site domain to prioritize for display in results (e.g. example.com). Optional.
Optional
page Page integer
Result page number for pagination. Min 1. Defaults to 1.
Optional
fields Fields string[]
Optional allow-list of keys to keep on each returned article, to trim large payloads (e.g. title, url, summary, score). Omit to return every field. Available keys: author, image_url, preview_content, pubdate, pubdate_unix, score, site, site_domain, source_url, summary, title, url.
Optional

REFERENCE

Tool details

Behavior hints are published with the component in the Pipedream registry and surface as MCP tool annotations, so an agent can reason about a tool before it calls it.

Registry key
dappier-get-ai-recommendations
Version
0.0.2
App
Dappier
Authentication
API key
Read-only
Yes
Destructive
No
Open world
Yes