# EcomScout Audiences API

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

EcomScout Audiences 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 Audiences. The published artifact set on APIs.io includes an OpenAPI specification and 4 JSON Schemas.

Segment sizing, compact exports, enrichment, lookalikes, saved audiences. Rows are tiers, not raw metrics; per-store detail stays on /v1/stores/{domain}.

## Operations (14)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/audiences/options` | Filter vocabulary with store counts: verticals, categories, industries… |
| GET | `/v1/audiences/preview` | Size a segment: count, withEmail, emailCoveragePct, ceiling, exportable… |
| POST | `/v1/audiences/preview` | Same as GET with a JSON body (arrays for domains / excludeDomains) |
| GET | `/v1/audiences/export` | Export compact rows for a segment. |
| POST | `/v1/audiences/export` | Export with a JSON body: filters plus include[], format, requireEmail, sort… |
| POST | `/v1/audiences/enrich` | Compact rows for up to 500 domains you supply; missing[] for unknown domains. |
| POST | `/v1/audiences/lookalike` | Scored lookalikes from 1 to 25 seed domains: learned profile (categories… |
| POST | `/v1/audiences` | Save an audience: name, description, definition. |
| GET | `/v1/audiences` | List your saved audiences |
| GET | `/v1/audiences/{id}` | One saved audience |
| PATCH | `/v1/audiences/{id}` | Update name, description and/or definition. |
| DELETE | `/v1/audiences/{id}` | Delete a saved audience |
| GET | `/v1/audiences/{id}/changes` | Stores that entered (rows) or left (domains) since the snapshot. |
| GET | `/v1/audiences/{id}/export` | Export the saved definition (same params and charges as /v1/audiences/export) |

## Machine-readable artifacts (5)

- **OpenAPI** — https://artifacts.apis.io/ecomscout-com/openapi/ecomscout-com-audiences-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 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 Signals API](https://apis.io/apis/ecomscout-com/ecomscout-com-signals-api/)
- [EcomScout Stores API](https://apis.io/apis/ecomscout-com/ecomscout-com-stores-api/)

## Tags

Audiences

---

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