---
title: "Search and Recommendation API参照およびデータモデル"
slug: "search-and-recommendation-api-reference-and-data-model"
abstract: "SearchおよびSitecore Searchの推奨APIの参考情報はどこで見つけられますか。"
---
# Search and Recommendation API参照およびデータモデル

Sitecore SearchのSearchおよび推薦APIは、開発者がコンテンツをクエリし、パーソナライズされたrecommendationsを受け取ることを可能にします。このトピックでは、公式API参照の入手方法を説明し、リクエストに必要なデータモデルの概要を提供します。

> !重要データオブジェクトはすべての利用可能なオブジェクトを投稿する際には[API参照](https://doc.sitecore.com/search/en/developers/search-and-recommentation-api/index.html) を参照してください

以下のコードブロックはサンプルAPIリクエストを示し、いくつかの一般的なオブジェクトを一覧にしています。

{
 "context": {
 "ids": {
 "property1": 
 "string"
 ,
 "property2": 
 "string"
 
 },
 "locale": {
 "country": "us",
 "language": "en"
 },
 "page": {
 "uri": "string"
 },
 "user": {
 "uuid": "string" //or "user\_id": "string" if your uuid does not follow the example here (https://doc.sitecore.com/search/en/developers/search-developer-guide/using-a-uuid-to-track-site-visitors.html)
 }
 },
 "widget": {
 "items": 
 {
 "entity": "string",
 "rfk\_flags": 
 "+semsearch"
 ,
 "rfk\_id": "string",
 "search": {
 "content": {
 "fields": 
 "name",
 "price"
 
 },
 "facet": {
 "all": true,
 "max": 10,
 "sort": {
 "name": "text",
 "order": "asc"
 },
 "types": 
 {
 "after": "facetid\_123",
 "exclude": 
 "val1",
 "val2"
 ,
 "filter": {
 "type": "or",
 "values": 
 "facetid\_123",
 "facetid\_123"
 
 },
 "filtering\_options": 
 "hard\_filters",
 "other\_facet\_values"
 ,
 "keyphrase": "Sitecore",
 "max": 10,
 "min\_count": 1,
 "name": "brands",
 "sort": {
 "name": "text",
 "order": "asc"
 }
 }
 
 },
 "filter": {
 "type": "string"
 },
 "group\_by": "group\_id",
 "limit": 10,
 "offset": 0,
 "personalization": {
 "algorithm": "hard\_filters",
 "fields": 
 "brand",
 "color"
 ,
 "ids": 
 "id1",
 "id2"
 
 },
 "query": {
 "highlight": {
 "post\_tag": "</em>",
 "pre\_tag": "<em>"
 },
 "keyphrase": "Sitecore",
 "operator": "or",
 "relevance": 
 {
 "analyzer": "rfk\_standard",
 "name": "color",
 "weight": 1
 }
 
 },
 "ranking": 
 {
 "name": "sales",
 "weight": 1
 }
 ,
 "related\_questions": {
 "highlight": {
 "post\_tag": "</em>",
 "pre\_tag": "<em>"
 },
 "max": 10
 },
 "rule": {
 "behaviors": true,
 "blacklist": {
 "filter": {
 "type": "string"
 }
 },
 "boost": 
 {
 "filter": {
 "type": "string"
 },
 "slots": 
 1,
 5
 
 }
 ,
 "bury": {
 "filter": {
 "type": "string"
 }
 },
 "include": 
 {
 "filter": {
 "type": "string"
 },
 "slots": 
 1,
 5
 
 }
 ,
 "pin": 
 {
 "id": "id1",
 "slot": 1
 }
 
 },
 "sort": {
 "choices": true,
 "value": 
 {
 "name": "color",
 "order": "desc"
 }
 
 },
 "suggestion": 
 {
 "max": 2,
 "name": "my\_suggester"
 }
 ,
 "swatch": {
 "fields": 
 "name",
 "price"
 ,
 "group\_by": "group\_id",
 "max": 10
 }
 },
 "sources": 
 "sourceID1",
 "sourceID2"
 
 }
 
 }
}