Search Nitro Inventory API

The Search Nitro Inventory API is available to select partners to provide automotive dealership inventory data in bulk.



Access

Access is governed a secret account id and api key pair. To request access, email admin@searchnitro.io.



Cost

API fees are paid at a negotiated rate per domain per calendar month.



Functions

Each function may be called at the respective endpoint/pathname on this domain as a POST request encoded as 'x-www-form-encoded'.



Variables

Each of the examples included below may use variables to designate the api key, account, and domain. To run tests using the browser console, fill in the blanks with the appropriate values provided during setup and declare these variable before running the example Javascript snippets.



Example - Javascript
const myAccount = _________________________; const myApi = _________________________; const myDomain = _________________________;

Domains

Add

Description

Used to add domains to the Search Nitro account. Parent designations allow for combined requests group by parent domain.


Endpoint
/domains/add/

Parameters
{ "api":"", // Required "account":"", // Required "domain":"", // Required "parent":"", // Optional }

List Active

Description

List of each active domain for the account. Parent domains also list children domains.

Endpoint
/domains/list/

Parameters
{ "api":"", // Required "account":"", // Required }

Example - Javascript const myHeaders = new Headers(); myHeaders.append("Content-Type", "application/x-www-form-urlencoded"); const urlencoded = new URLSearchParams(); urlencoded.append("api", "${api}"); urlencoded.append("account",myAccount); const requestOptions = { method: "POST", headers: myHeaders, body: urlencoded, redirect: "follow" }; fetch("https://vehicles.streamlinedealer.com/domains/list/", requestOptions) .then((response) => response.text()) .then((result) => console.log(result)) .catch((error) => console.error(error));

List All

Description

List all available domains for export.

Endpoint
/domains/list/all/

Parameters
{ "api":"", // Required "account":"", // Required }

Example - Javascript const myHeaders = new Headers(); myHeaders.append("Content-Type", "application/x-www-form-urlencoded"); const urlencoded = new URLSearchParams(); urlencoded.append("api", "${api}"); urlencoded.append("account",myAccount); const requestOptions = { method: "POST", headers: myHeaders, body: urlencoded, redirect: "follow" }; fetch("https://vehicles.streamlinedealer.com/domains/list/all/", requestOptions) .then((response) => response.text()) .then((result) => console.log(result)) .catch((error) => console.error(error));

Remove

Description

Used to remove domains from the Search Nitro account.


Endpoint
/domains/remove/

Parameters
{ "api":"", // Required "account":"", // Required "domain":"", // Required "parent":"", // Optional }

Inventory

Query

Description

Used to fetch inventory by domain.


Endpoint:
/inventory/query/

Parameters
{ "api":"", // Required "account":"", // Required "domain":"", // Required }

Example - Javascript const myHeaders = new Headers(); myHeaders.append("Content-Type", "application/x-www-form-urlencoded"); const urlencoded = new URLSearchParams(); urlencoded.append("api", myApi); urlencoded.append("account",myAccount); urlencoded.append("domain", myDomain); const requestOptions = { method: "POST", headers: myHeaders, body: urlencoded, redirect: "follow" }; fetch("https://vehicles.streamlinedealer.com/inventory/query/", requestOptions) .then((response) => response.text()) .then((result) => console.log(result)) .catch((error) => console.error(error));

Refresh

Description

Refresh the inventory feed cache daily and after adjusting the active domains


Endpoint:
/inventory/refresh/

Parameters
{ "api":"", // Required "account":"", // Required "domain":"", // Required }

Example - Javascript const myHeaders = new Headers(); myHeaders.append("Content-Type", "application/x-www-form-urlencoded"); const urlencoded = new URLSearchParams(); urlencoded.append("api", myApi); urlencoded.append("account",myAccount); urlencoded.append("domain", myDomain); const requestOptions = { method: "POST", headers: myHeaders, body: urlencoded, redirect: "follow" }; fetch("https://vehicles.streamlinedealer.com/inventory/refresh/", requestOptions) .then((response) => response.text()) .then((result) => console.log(result)) .catch((error) => console.error(error));

Query Summary Data (Version 1.1)

Description

Summary data about vehicle count and average price by make/model is now in early development available at the version 1.1 endpoint. This information is delivered in the "summary" key rather than the "data" key.


Endpoint:
/v1.1/inventory/query/

Parameters
{ "api":"", // Required "account":"", // Required "domain":"", // Required }

Example - Javascript const myHeaders = new Headers(); myHeaders.append("Content-Type", "application/x-www-form-urlencoded"); const urlencoded = new URLSearchParams(); urlencoded.append("api", myApi); urlencoded.append("account",myAccount); urlencoded.append("domain", myDomain); const requestOptions = { method: "POST", headers: myHeaders, body: urlencoded, redirect: "follow" }; fetch("https://vehicles.streamlinedealer.com/v1.1/inventory/query/", requestOptions) .then((response) => response.text()) .then((result) => console.log(result)) .catch((error) => console.error(error));