# GEN Watchlists API

**Canonical:** https://apis.io/apis/gen-pro/gen-pro-watchlists-api/  
**Provider:** GEN — https://apis.io/providers/gen-pro/  
**Base URL:** https://api.gen.pro/v1  
**Documentation:** https://gen.pro/docs

GEN Watchlists API is one of 27 APIs that [GEN](https://apis.io/providers/gen-pro/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 5 JSON Schema definitions. Tagged areas include Watchlist. The published artifact set on APIs.io includes an OpenAPI specification and 5 JSON Schemas.

Named collections of monitoring sources (accounts, hashtags, keywords) per agent. Base URL `https://agent-core.gen.pro/v1`. Scraped data feeds back into agent chat and content idea generation. CRUD operations are free; downstream scrapes bill normally.

## Operations (8)

| Method | Path | Summary |
|---|---|---|
| GET | `/agents/{agent_id}/watchlists` | List active watchlists for an agent |
| POST | `/agents/{agent_id}/watchlists` | Create a watchlist (idempotent on name) |
| GET | `/agents/{agent_id}/watchlists/{watchlist_id}` | Get a single watchlist with sources |
| PATCH | `/agents/{agent_id}/watchlists/{watchlist_id}` | Update a watchlist (also used for pause/resume) |
| DELETE | `/agents/{agent_id}/watchlists/{watchlist_id}` | Soft-delete a watchlist |
| POST | `/agents/{agent_id}/watchlists/{watchlist_id}/sources` | Add or restore a source on a watchlist |
| DELETE | `/agents/{agent_id}/watchlists/{watchlist_id}/sources` | Remove a source by (platform, target_type, target_value) |
| DELETE | `/agents/{agent_id}/watchlists/{watchlist_id}/sources/{source_id}` | Remove a source by id |

## Machine-readable artifacts (6)

- **OpenAPI** — https://artifacts.apis.io/gen-pro/openapi/gen-pro-watchlists-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/gen-pro/json-schema/gen-pro-watchlist-schema.json
- **JSONSchema** — https://artifacts.apis.io/gen-pro/json-schema/gen-pro-watch-source-input-schema.json
- **JSONSchema** — https://artifacts.apis.io/gen-pro/json-schema/gen-pro-watchlist-create-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/gen-pro/json-schema/gen-pro-watch-source-schema.json
- **JSONSchema** — https://artifacts.apis.io/gen-pro/json-schema/gen-pro-watchlist-update-request-schema.json

## Other GEN APIs (12)

- [GEN Agent Chat API](https://apis.io/apis/gen-pro/gen-pro-agent-chat-api/)
- [GEN Agent Core API](https://apis.io/apis/gen-pro/gen-pro-agent-core-api/)
- [GEN Agent Profile API](https://apis.io/apis/gen-pro/gen-pro-agent-profile-api/)
- [GEN Agent Voice API](https://apis.io/apis/gen-pro/gen-pro-agent-voice-api/)
- [GEN Agents API](https://apis.io/apis/gen-pro/gen-pro-agents-api/)
- [GEN API Keys API](https://apis.io/apis/gen-pro/gen-pro-api-keys-api/)
- [GEN Asset Libraries API](https://apis.io/apis/gen-pro/gen-pro-asset-libraries-api/)
- [GEN Billing API](https://apis.io/apis/gen-pro/gen-pro-billing-api/)
- [GEN Cells API](https://apis.io/apis/gen-pro/gen-pro-cells-api/)
- [GEN Characters API](https://apis.io/apis/gen-pro/gen-pro-characters-api/)
- [GEN Columns API](https://apis.io/apis/gen-pro/gen-pro-columns-api/)
- [GEN Content Monitoring API](https://apis.io/apis/gen-pro/gen-pro-content-monitoring-api/)

## Tags

Watchlist

---

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