> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scoutlayer.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart

> Make your first ScoutLayer API call in under two minutes.

## Prerequisites

* A ScoutLayer account — [sign up free](https://app.scoutlayer.io/auth/register)
* An API key from [Settings → API Keys](https://app.scoutlayer.io/settings/api-keys)

## 1. Get your API key

Open the [dashboard](https://app.scoutlayer.io/settings/api-keys) and create a new API key. Copy it — you'll need it in the next step.

<Warning>
  Keep your API key secret. Never commit it to source control or expose it in client-side code.
</Warning>

## 2. Make your first request

Fetch the full detail of any Shopify app by its handle (the slug at the end of its App Store URL):

<CodeGroup>
  ```bash cURL theme={null}
  curl https://api.scoutlayer.io/v1/shopify/appstore/app/klaviyo \
    -H "X-API-Key: YOUR_API_KEY"
  ```

  ```typescript TypeScript theme={null}
  const res = await fetch(
    "https://api.scoutlayer.io/v1/shopify/appstore/app/klaviyo",
    { headers: { "X-API-Key": "YOUR_API_KEY" } }
  );
  const app = await res.json();
  console.log(app.name, app.rating, app.reviewCount);
  ```

  ```python Python theme={null}
  import httpx

  res = httpx.get(
      "https://api.scoutlayer.io/v1/shopify/appstore/app/klaviyo",
      headers={"X-API-Key": "YOUR_API_KEY"},
  )
  app = res.json()
  print(app["name"], app["rating"], app["reviewCount"])
  ```
</CodeGroup>

## 3. Explore the response

A successful response looks like this:

```json theme={null}
{
  "name": "Klaviyo: Email Marketing & SMS",
  "handle": "klaviyo",
  "rating": "4.7",
  "reviewCount": 2891,
  "builtForShopify": "TRUE",
  "developer": {
    "name": "Klaviyo",
    "website": "https://www.klaviyo.com"
  },
  "pricings": [
    { "name": "Free", "price": "0", "period": "" },
    { "name": "Email", "price": "20", "period": "month" }
  ],
  "categories": [
    { "name": "Email marketing", "handle": "email-marketing" }
  ]
}
```

## Next steps

<CardGroup cols={2}>
  <Card title="App reviews" icon="star" href="/api-reference">
    Pull paginated reviews sorted by relevance or date.
  </Card>

  <Card title="Keyword search" icon="magnifying-glass" href="/api-reference">
    Search the App Store and get ranked results with sponsorship flags.
  </Card>

  <Card title="Category listings" icon="grid" href="/api-reference">
    Get all apps in a category with pagination.
  </Card>

  <Card title="Developer profiles" icon="user" href="/api-reference">
    Look up a developer and all their published apps.
  </Card>
</CardGroup>
