# Quick Start

Make your first request to the View REST API in minutes!

This API is intended for client-side use and is read-only.

## Local Development

### Authentication Token <a href="#get-your-okendo-user-id" id="get-your-okendo-user-id"></a>

Every instance of Mercury generates a token that can be passed to Mercury to fetch a respective stores content from anywhere.

Visit the settings area of Mercury to see your BypassToken.

In production apps, approved domain names are used to fetch a store's content, but a token can also be specified.

{% hint style="danger" %}
Bypass Tokens are useful for local development - however, abuse of a token will result in it being removed and a new token generated.

Production Mercury relies on the Origin verification method over the token method
{% endhint %}

### Make Your First Request <a href="#make-your-first-request" id="make-your-first-request"></a>

To make your first request, send a request to the `/search` endpoint. This will fetch some of your published `products`.

To make the request, use a networking client of your choice or follow this example using [fetch](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API):

```
fetch('https://mercury.plutocracy.io/search/{term}?' + new URLSearchParams({
    bypassToken: 'your token'
}))
  .then(response => response.json())
  .then(data => console.log(data));
```

**Got it working? Nice!**

Do something cool with your newfound powers.

**Struggle city?**

[Send Help](/plutocracy/working-with-plutocracy/support.md), We're here to make it easy, our chat is manned by people who can answer your problem on the spot.

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td>Search</td><td>Learn how Mercury Search can be customised to meet your merchant's particular requirements</td><td></td><td><a href="/pages/QYM9eo5HTodgRmbFWeOb">/pages/QYM9eo5HTodgRmbFWeOb</a></td></tr><tr><td>Collections</td><td>Super speedy collections with configurable Facets and Inline Merchandising</td><td></td><td><a href="/pages/acJWd7INLlqc1MBOvUBa">/pages/acJWd7INLlqc1MBOvUBa</a></td></tr><tr><td>Products</td><td>Pulling products from our latency optimised products</td><td>No GraphQL required</td><td><a href="/pages/dxTD7auMlgdDegN5aQEZ">/pages/dxTD7auMlgdDegN5aQEZ</a></td></tr><tr><td>Endpoints</td><td>Get the skinny on every endpoint available to you.</td><td></td><td><a href="/pages/MrWOSNnWVaQAereZOvRV">/pages/MrWOSNnWVaQAereZOvRV</a></td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.plutocracy.io/plutocracy/mercury/quick-start.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.