# EcomScout Signals API

**Canonical:** https://apis.io/apis/ecomscout-com/ecomscout-com-signals-api/  
**Provider:** EcomScout — https://apis.io/providers/ecomscout-com/  
**Base URL:** https://api.ecomscout.com  
**Documentation:** https://app.ecomscout.com/docs

EcomScout Signals API is one of 9 APIs that [EcomScout](https://apis.io/providers/ecomscout-com/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 4 JSON Schema definitions. Tagged areas include Signals. The published artifact set on APIs.io includes an OpenAPI specification and 4 JSON Schemas.

Your competitor watches — sales, ads, insights (user-scoped)

## Operations (17)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/signals` | List your tracked stores + plan caps |
| POST | `/v1/signals` | Create a signal (auto-track bestsellers). Example domain: gruntstyle.com |
| GET | `/v1/signals/insights` | Account insight feed across all watches |
| GET | `/v1/signals/{id}` | One signal (watch id or domain) incl. |
| PATCH | `/v1/signals/{id}` | Edit status, products, name |
| DELETE | `/v1/signals/{id}` | Delete your watch (shared observations may remain) |
| POST | `/v1/signals/{id}/stop` | Pause a signal (alias for status=paused) |
| GET | `/v1/signals/{id}/probe` | Inventory probe status (queued\|probing\|computing\|done\|failed). |
| POST | `/v1/signals/{id}/probe` | Queue an inventory probe (5 min cooldown) |
| GET | `/v1/signals/{id}/stats` | Tracked totals + store profile. Grunt Style ≈ $10.8k / 19d |
| GET | `/v1/signals/{id}/sales` | Daily units/revenue + variant inventory deltas |
| GET | `/v1/signals/{id}/daily` | One-day store payload: daily_summary → products → variants (orders = lower… |
| GET | `/v1/signals/{id}/inventory` | Inventory timeline + restocks |
| GET | `/v1/signals/{id}/ads/overview` | Ads vs revenue, productImpact, events. MagBak iPhone 15 +82.7% lift |
| GET | `/v1/signals/{id}/ads` | Paginated Meta/TikTok/Google creatives |
| GET | `/v1/signals/{id}/apps` | Installed apps on the watched store |
| GET | `/v1/signals/{id}/insights` | Insights for one signal |

## Machine-readable artifacts (5)

- **OpenAPI** — https://artifacts.apis.io/ecomscout-com/openapi/ecomscout-com-signals-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/ecomscout-com/json-schema/ecomscout-com-audience-definition-schema.json
- **JSONSchema** — https://artifacts.apis.io/ecomscout-com/json-schema/ecomscout-com-store-inventory-probe-schema.json
- **JSONSchema** — https://artifacts.apis.io/ecomscout-com/json-schema/ecomscout-com-competitor-store-schema.json
- **JSONSchema** — https://artifacts.apis.io/ecomscout-com/json-schema/ecomscout-com-product-inventory-probe-schema.json

## Other EcomScout APIs (8)

- [EcomScout Analytics API](https://apis.io/apis/ecomscout-com/ecomscout-com-analytics-api/)
- [EcomScout Apps API](https://apis.io/apis/ecomscout-com/ecomscout-com-apps-api/)
- [EcomScout Audiences API](https://apis.io/apis/ecomscout-com/ecomscout-com-audiences-api/)
- [EcomScout Changes API](https://apis.io/apis/ecomscout-com/ecomscout-com-changes-api/)
- [EcomScout Discovery API](https://apis.io/apis/ecomscout-com/ecomscout-com-discovery-api/)
- [EcomScout Products API](https://apis.io/apis/ecomscout-com/ecomscout-com-products-api/)
- [EcomScout Scrapes API](https://apis.io/apis/ecomscout-com/ecomscout-com-scrapes-api/)
- [EcomScout Stores API](https://apis.io/apis/ecomscout-com/ecomscout-com-stores-api/)

## Tags

Signals

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/ecomscout-com/ecomscout-com-signals-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/ecomscout-com/.