Skip to content
Elastic Site Search Official Node.js Client
JavaScript
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Replace Travis with CircleCI Aug 1, 2019
fixtures/api.swiftype.com-443 Changes based on feedback. Updated readme, removed semicolon, reverte… Oct 1, 2018
lib Fix typo in missing argument handling #4 (#5) Sep 19, 2019
test Rebranding Aug 1, 2019
.gitignore Disabled package-lock.json Sep 9, 2019
.npmrc Disabled package-lock.json Sep 9, 2019
.nvmrc
LICENSE.txt Rebranding Aug 1, 2019
NOTICE.txt
README.md Added syntax highlighting to README Sep 9, 2019
logo-site-search.png Adds fancy README. Feb 1, 2019
package.json Release v1.0.1 Sep 20, 2019

README.md

Elastic Site Search Logo

CircleCI build

A first-party Node client for the Elastic Site Search API.

Contents


Getting started 🐣

With npm:

npm install @elastic/site-search-node

or clone locally:

$ git clone git@github.com:elastic/site-search-node.git
$ cd site-search-node
$ npm install

Usage

Create a new instance of the client with your api key:

var SiteSearchClient = require("@elastic/site-search-node");
var client = new SiteSearchClient({
  apiKey: "yourApiKey"
});

Searching

Search for cats on the engine my-engine with filters and facets:

client.search(
  {
    engine: "my-engine",
    q: "cats",
    filters: {
      page: {
        enumField: "theFilter"
      }
    },
    facets: {
      page: ["enumField", "anotherField"]
    }
  },
  function(err, res) {
    console.log(res);
  }
);

Autocomplete

Autocomplete suggestion for cat on the engine my-engine with filters:

client.suggest(
  {
    engine: "my-engine",
    q: "cat",
    filters: {
      page: {
        enumField: "theFilter"
      }
    }
  },
  function(err, res) {
    console.log(res);
  }
);

Click

Log clickthrough for cat on the engine my-engine for the documentType page:

client.click(
  {
    engine: "my-engine",
    q: "cat",
    id: "the-document-id",
    documentType: "page"
  },
  function(err, res) {
    console.log(res);
  }
);

Documents

Create a new document:

client.documents.create(
  {
    engine: "my-engine",
    documentType: "books",
    document: {
      external_id: "1",
      fields: [
        { name: "title", value: "The Great Gatsby", type: "string" },
        { name: "author", value: "F. Scott Fitzgerald", type: "string" },
        { name: "genre", value: "fiction", type: "enum" }
      ]
    }
  },
  function(err, res) {
    console.log(res);
  }
);

Engines

Fetch all of your engines:

client.engines.list(function(err, res) {
  console.log(res);
});

Fetch a single engine:

client.engines.get(
  {
    engine: "my-engine"
  },
  function(err, res) {
    console.log(res);
  }
);

Document Types

Fetch all of the document types in the engine my-engine

client.documentTypes.list(
  {
    engine: "my-engine"
  },
  function(err, res) {
    console.log(res);
  }
);

Fetch the document type books in the engine my-engine

client.documentTypes.get(
  {
    engine: "my-engine",
    documentType: "books"
  },
  function(err, res) {
    console.log(res);
  }
);

Create the document type books in the engine my-engine

client.documentTypes.create(
  {
    engine: "my-engine",
    document_type: { name: "books" }
  },
  function(err, res) {
    console.log(res);
  }
);

Check out the tests for more examples!

Running tests

$ npm test

The tests use stubbed HTTP interactions that are recorded with the node-replay module. By default, HTTP interactions are not allowed when running the tests.

The tests can also use environment variables so that you can create new replays against your own account. Don't forget to change the "authorization" header in the replay files to not give away your api key.

  • SITE_SEARCH_TEST_MY_ENGINE = the slug for your 'my-engine' in the tests
  • SITE_SEARCH_TEST_BOOKSTORE_ENGINE = the slug for your 'bookstore' in the tests
  • SITE_SEARCH_TEST_TEMPORARY_ENGINE = the slug for your 'temporary' in the tests
  • SITE_SEARCH_TEST_API_KEY = your api key in the tests
  • REPLAY = 'record' to record new replay files

FAQ 🔮

Where do I report issues with the client?

If something is not working as expected, please open an issue.

Where can I learn more about Site Search?

Your best bet is to read the documentation.

Where else can I go to get help?

You can checkout the Elastic Site Search community discuss forums.

Contribute 🚀

We welcome contributors to the project. Before you begin, a couple notes...

License 📗

Apache 2.0 © Elastic

Thank you to all the contributors!

You can’t perform that action at this time.