Understanding SearchContent functionality helps you optimize which product data fields are searchable and how search results are generated. When you control searchable content effectively, you help improve search relevance and ensure customers find products through varied search terms, which tends to enhance search-to-purchase conversion and supports better overall product discovery.
SearchContent configuration enables you to fine-tune search behavior to match customer search patterns. This helps improve search relevance and conversion rates by ensuring that product attributes most relevant to customer queries are properly indexed and weighted, supporting better product discovery through more intelligent search result generation.
Body Params
userobjectrequireduser objectt_clientstringrequiredqstring
Search query
typearray of stringsrequired
Array of requested content providers
stringADD stringsortarray of objects
Array of sort fields
objectfieldstringrequired
field
orderstringrequired
order
ADD objectoffsetint32Defaults to 0limitint32Defaults to 24
max = 120
filtersarray of objectsobjectnamestringrequiredtypestringrequiredvaluesarray of stringsrequiredDefaults toADD stringADD object
Responses
200
200
Response bodyobjectmetaobjectqstringoffsetintegerDefaults to 0limitintegerDefaults to 0totalintegerDefaults to 0filtersarray of objectsobjectnamestringtypestringvaluesarray of objectsobjectvaluestringsortarraytypearray of stringsridstringquery_typestringfacetsarrayitemsarray of objectsobjectsourcestringidstringimage_idstringlow_resolution_image_urlstringoriginal_image_urlstringimage_urlstringexternal_media_idstringtagged_productsarray of objectsobjectidintegerDefaults to 0namestringdomain_keystringproduct_linkstringproduct_urlstringimage_urlstringpostobjectpost objectprofile_picturestringusernamestringlocation_namestringcreated_timestringhashtagsarray of stringscontentstringvotes_upintegerDefaults to 0votes_downintegerDefaults to 0
Credentials
Header 2e963f3e-38bd-4c00-9636-c00e48945eb7
Shell
curl --request POST --url https://api-v3.findify.io/v3/search/content --header "X-Key: 680d373d-06b3-442b-bebc-d35a5b0868b3" --header "Content-Type: application/json" --data '{"user":{"lang":["en-GB"],"uid":"test1","sid":"ssid","email":"test@test .com","ip":"192.168.0.1","ua":"Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2228.0 Safari/537.36"},"q":"Socks","type": ["instagram"],"t_client":1484742065791,"filters":[{ "name": "post.hashtags", "type": "text", "values": [{ "value": "bamboosocks" }] }], "sort":[],"offset":0,"limit":20}'
Javascript Default
//Please, don't forget to include the SDK script
//Which you can find here: https://github.com/findify/javascript-sdk
var client = FindifySDK.init({
key: '680d373d-06b3-442b-bebc-d35a5b0868b3',
user: {
uid: 'test1',
sid: 'ssid',
email: 'test@test .com'
},
log: false
});
var request = {
q: 'Socks',
type: ['instagram'],
filters: [{
name: 'post.hashtags',
type: 'text',
values: [{"value": "bamboosocks"}]
}],
sort: [],
offset: 0,
limit: 20,
};
client.search.content(request).then(function (response) {
console.log(response);
});
Javascript Node
var request = require("request");
var options = {
method: 'POST',
url: 'https://api-v3.findify.io/v3/search/content',
headers: {
"X-key": "680d373d-06b3-442b-bebc-d35a5b0868b3"
},
body: {
user: {
lang: ['en-GB'],
uid: 'test1',
sid: 'ssid',
email: 'test@test .com',
ip: '192.168.0.1',
ua: 'Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2228.0 Safari/537.36'
},
t_client: "1484742065791",
q: 'Socks',
type: ['instagram'],
t_client: 1484742065791,
filters: [{
name: 'post.hashtags',
type: 'text',
values: [{"value": "bamboosocks"}]
}
],
sort: [],
offset: 0,
limit: 20
},
json: true
};
request(options, function(error, response, body) {
if (error) throw new Error(error);
console.log(body);
})
PHP
<?php
require_once(__DIR__ . '/vendor/autoload.php');
// Configure API key authorization: key
Swagger\Client\Configuration::getDefaultConfiguration()->setApiKey('X-Key', '680d373d-06b3-442b-bebc-d35a5b0868b3');
$api_instance = new Swagger\Client\Api\DefaultApi();
$search = new \Swagger\Client\Model\SearchRequest(array(
'user' => array(
'uid' => 'test1',
'sid' => 'ssid',
'email' => 'test@test .com',
'ip' => '192.168.0.1',
'ua' => 'Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/41.0.2228.0 Safari/537.36',
'lang' => array(
'en-US',
'en-GB',
'no'
)
),
'q' => 'Socks',
't_client' => 1484741395471,
'filters' => array(
array(
'name' => 'post.hashtags',
'type' => 'text',
'values' => array(
array(
'value' => array('bamboosocks')
)
)
)
),
'sort' => array(),
'offset' => 0,
'limit' => 20
));
try {
$result = $api_instance->contentSearchePost($search);
echo $result;
}
catch (Exception $e) {
echo 'Exception when calling DefaultApi->searchePost: ', $e->getMessage(), PHP_EOL;
}
?>
Related Articles
Search & Discovery:
Product Recommendations:
Conversion Optimization: