---
title: "Markets, search engines, devices and schedules you can configure"
method: GET
path: "/monitoring-options"
tags: ["Projects"]
---

# Markets, search engines, devices and schedules you can configure

`GET /monitoring-options`

## Request

- Base URL: `https://adslighthouse.com/api/v1`
- URL: `https://adslighthouse.com/api/v1/monitoring-options`
- Auth: HTTP bearer

Lists what a project can be configured with: each market (country) with its default language, the search engines available there and its whole-country location, the devices and the operating systems an on-demand check can pin, and the schedules with whether the account's plan allows them. It also returns the plan's limits on locations checked per run, locations in a project's list, runs per day, projects, keywords and Shopping. Pass country to get one market. Use search_locations for cities and regions.

## Query parameters

- `country` string: Only this market, ISO 3166-1 alpha-2 such as US.

## Response `200`

Markets, search engines, devices and schedules you can configure

- object
  - `plan` object, required
    - `id` 'starter' | 'growth' | 'scale' | 'business' | 'enterprise', required
    - `name` string, required
    - `shopping` boolean, required: Whether the plan includes Google Shopping checks.
    - `locations_per_project` integer, nullable, required: Locations each run of a project may check. Null when unlimited.
    - `location_pool_per_project` integer, required: Locations a project's list may hold: four times locations_per_project, at most 200. With more listed than each run checks, set locations_per_run.
    - `max_runs_per_day` integer, nullable, required: Most scheduled runs per day, such as 24 for every hour. Null when unlimited.
    - `projects` integer, nullable, required
    - `keywords` integer, nullable, required
  - `countries` object[], required
    - `code` string, required: ISO 3166-1 alpha-2.
    - `name` string, required
    - `default_language` string, required
    - `search_engines` string[], required
    - `shopping_available` boolean, required: Shopping needs Google in the market.
    - `whole_country_location` object, required
      - `code` integer, required
      - `name` string, required
  - `devices` object[], required
    - `value` 'desktop' | 'mobile', required
    - `operating_systems` string[], required: Operating systems an on-demand check may pin for this device.
  - `frequencies` object[], required
    - `value` 'manual' | 'daily' | 'twice_daily' | 'four_times_daily' | 'six_times_daily' | 'twelve_times_daily' | 'hourly' | 'every_30_minutes' | 'every_15_minutes', required
    - `label` string, required
    - `runs_per_day` integer, required
    - `interval_minutes` integer, nullable, required: Minutes between scheduled runs; null for manual.
    - `allowed_on_plan` boolean, required
  - `request_id` string

## Other responses

- `400`: Invalid parameters, cursor or body.
- `401`: Missing, invalid, expired or revoked credential.
- `403`: The credential lacks the write scope, the plan does not include the API, or the allowance is used up.
- `404`: Unknown project, keyword or run in this account.
- `409`: The idempotency key was already used for a different request.
- `429`: Rate limit reached. Retry after the Retry-After seconds.
- `503`: The requested service or file is temporarily unavailable.

---

[API](https://skmtc.dev/adslighthouse/apis/ads-lighthouse-api.md) · [All operations](https://skmtc.dev/adslighthouse/apis/ads-lighthouse-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adslighthouse/apis/ads-lighthouse-api/revisions/e1a4a40b11a9?raw)