Findify

Findify Developer Hub

Welcome to the Findify Developer Hub. Here you'll find comprehensive guides and documentation to help you start working with Findify as quickly as possible, as well as support if you get stuck. Let's jump right in!

Findify Agent

Intro

Findify Agent was made to simplify data fetching process and to be framework and platform agnostic.
The Agent could be easily injected in jQuery, Angular or even React-Native project with minimal overhead.

Integrate

🚧

Obtaining Findify API Key

Before you start, you need to get the Findify API Key in order to get access to the API. You need to follow the onboarding process or get the API key from your Merchant Dashboard

Script tag

In order to use Findify Agent directly in the browser, you need to include the following scripts on your page:

<script src="https://cdn.jsdelivr.net/npm/@findify/[email protected]/dist/findify-analytics.js"></script>

<!-- Findify Agent -->
<script src="https://cdn.jsdelivr.net/npm/@findify/[email protected]/dist/findify-agent.js"></script>

Findify Agent and Findify Analytics will be available in the window object as window.FindifyAnalytics and window.FindifyAgent

NPM

If you are using NPM, just install the libraries from our public NPM registry

npm i --save @findify/agent @findify/analytics

Minimal Setup

The minimal setup requires you to just create the instance of Findify Analytics and Findify Agent, the rest will be handled automatically.

var API_KEY ='YOUR_API_KEY';
var Autocomplete = window.FindifyAgent.Autocomplete;
var Analytics = window.FindifyAnalytics;

// Initialize libraries
var analyticsInstance = Analytics({ key: API_KEY });
var autocompleteInstance = new Autocomplete({
  key: API_KEY,
  user: analytics.user
});

// Subscribe to changes in suggestions
autocompleteInstance.on('change:suggestions', function(suggestions) {
  // render suggestion
});

// Send request with some query
autocompleteInstance.set('q', 'white');
const Autocomplete = require('@findify/Agent').Autocomplete;
const Analytics = require('@findify/Analytics');

// Initialize libraries
const analyticsInstance = new Analytics({ key: API_KEY });
const autocompleteInstance = new Search({
  key: API_KEY,
  user: analytics.user
});

// Subscribe to changes in suggestions
autocompleteInstance.on('change:suggestions', function(suggestions) {
  // render suggestion
});

// Send request with some query
autocompleteInstance.set('q', 'white');

Live example

Updated 2 months ago


Findify Agent


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.