AI Recommendations API

Use the AI Recommendations API to power AI recommendations on your own content. It uses a RAG (Retrieval-Augmented Generation) model to return article recommendations from your content based on the input query or URL. You’ll need an API key to access this API. Visit Dappier Platform to sign up and create an API key under Settings > Profile > API Keys.

Using AI Recommendations API

This section demonstrates retrieving recommendations based on natural language queries or URLs. The data model id for your own content is shown as DataModel ID on the Configure tab of your AI agent, and starts with dm_. See the AI Recommendations endpoint reference for all parameters.

import requests
import json

url = "https://api.dappier.com/app/datamodel/dm_01j0pb465keqmatq9k83dthx34"
payload = json.dumps({
"query": "lifestyle new articles",
"similarity_top_k": 3,
"ref": "",
"num_articles_ref": 0,
"search_algorithm": "most_recent",
"page": 1,
"num_results" : 10

})
headers = {
'Content-Type': 'application/json',
'Authorization': 'Bearer <YOUR_DAPPIER_API_KEY>'
}

response = requests.post(url, headers=headers, data=payload)

print(response.text)

package main

import (
"bytes"
"fmt"
"net/http"
"io/ioutil"
)

func main() {
url := "https://api.dappier.com/app/datamodel/dm_01j0pb465keqmatq9k83dthx34"
apiKey := "<YOUR_DAPPIER_API_KEY>"
query := `{
    "query": "lifestyle new articles",
    "similarity_top_k": 3,
    "ref": "",
    "num_articles_ref": 0,
    "search_algorithm": "most_recent",
    "page": 1,
    "num_results" : 10
}`

req, err := http.NewRequest("POST", url, bytes.NewBuffer([]byte(query)))
if err != nil {
fmt.Println("Error creating request:", err)
return

}

req.Header.Set("Authorization", "Bearer "+apiKey)
req.Header.Set("Content-Type", "application/json")

client := &http.Client{}
resp, err := client.Do(req)
if err != nil {
fmt.Println("Error making request:", err)
return

}
defer resp.Body.Close()

body, _ := ioutil.ReadAll(resp.Body)
fmt.Println(string(body))

}

curl --location --request POST 'https://api.dappier.com/app/datamodel/dm_01j0pb465keqmatq9k83dthx34' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer <YOUR_DAPPIER_API_KEY>' \
--data-raw '{
    "query": "lifestyle new articles",
    "similarity_top_k": 3,
    "ref": "",
    "num_articles_ref": 0,
    "search_algorithm" : "most_recent",
    "page": 1,
    "num_results" : 10
}'

response

{
"results": [
    {
        "author": "Rusty Weiss",
        "image_url": "https://images.dappier.com/dm_01j0pb465keqmatq9k83dthx34/Olympics-Rugby-Sevens-Women-Semifinal-USA-vs-NZL-23861886-scaled-e1725556056406_.jpg?width=428&height=321",
        "preview_content": "<p>American rugby player Ilona Maher&#8217;s popularity is at its absolute peak. Demand for her has skyrocketed since her performance in [&#8230;]</p>\n<p>The post <a href=\"https://www.boundingintosports.com/2024/09/olympic-rugby-hero-ilona-maher-joins-dancing-with-the-stars/\">Olympic Rugby Hero Ilona Maher Joins &#8216;Dancing With The Stars&#8217;</a> appeared first on <a href=\"https://www.boundingintosports.com\">Bounding Into Sports</a>.</p>",
        "pubdate": "Thu, 05 Sep 2024 17:30:27 +0000",
        "site": "Bounding Into Sports",
        "site_domain": "www.boundingintosports.com",
        "title": "Olympic Rugby Hero Ilona Maher Joins ‘Dancing With The Stars’",
        "url": "https://api.dappier.com/app/track/NB2HI4DTHIXS653XO4XGE33VNZSGS3THNFXHI33TOBXXE5DTFZRW63JPGIYDENBPGA4S633MPFWXA2LDFVZHKZ3CPEWWQZLSN4WWS3DPNZQS23LBNBSXELLKN5UW44ZNMRQW4Y3JNZTS253JORUC25DIMUWXG5DBOJZS6===?type=article_click&site_domain=www.boundingintosports.com&datamodel_id=dm_01j0pb465keqmatq9k83dthx34&request_id=3ac73c01974c-kqHLh38Cqy-2824988&origin="
    },
    ...
]
}

Developer APIs

Publisher APIs

ZeroClick APIs

Analytics APIs

Using AI Recommendations API