# Campaigns

Higher-level monitoring campaigns that provision and manage the backing per-platform webhook subscriptions for you, and expose aggregated delivery stats — for monitoring across platforms under a single construct.

 - [GET /public/v1/social/listening/campaign/](https://docs.influencers.club/openapi/campaigns/public_v1_social_listening_campaign_list.md): Return a paginated list of the client's campaigns, optionally filtered by status and search, with a `status_counts` summary. Monitoring is billed per creator, per day — API calls are included in that
 - [POST /public/v1/social/listening/campaign/](https://docs.influencers.club/openapi/campaigns/public_v1_social_listening_campaign_create.md): Create a campaign and its backing per-platform webhook subscriptions. Monitoring is billed per creator, per day — API calls are included in that price. See [Usage, pricing & limits](guides/usage-limit
 - [GET /public/v1/social/listening/campaign/{campaign_id}/](https://docs.influencers.club/openapi/campaigns/public_v1_social_listening_campaign_retrieve.md): Return the detail representation of a single campaign by id. Team members can view campaigns within their client scope. Monitoring is billed per creator, per day — API calls are included in that price
 - [PATCH /public/v1/social/listening/campaign/{campaign_id}/](https://docs.influencers.club/openapi/campaigns/public_v1_social_listening_campaign_partial_update.md): Update a campaign's status, budget and/or content types. Setting `status` to `paused` or `active` pauses/resumes the campaign and cascades the same status to all its backing subscriptions; resuming ru
 - [DELETE /public/v1/social/listening/campaign/{campaign_id}/](https://docs.influencers.club/openapi/campaigns/public_v1_social_listening_campaign_delete.md): Archive a campaign and disable all its backing subscriptions. This is a soft delete: rows are retained but detection is stopped. Monitoring is billed per creator, per day — API calls are included in t
 - [GET /public/v1/social/listening/campaign/{campaign_id}/creators/](https://docs.influencers.club/openapi/campaigns/public_v1_social_listening_campaign_creators_retrieve.md): Return a paginated list of the campaign's creators with per-creator metrics (posts, views, engagement, ER%, EMV, and a 7-day trend), searchable by handle/name and sortable by any metric column. Creato
 - [POST /public/v1/social/listening/campaign/{campaign_id}/creators/](https://docs.influencers.club/openapi/campaigns/public_v1_social_listening_campaign_creators_create.md): Add creators to one of the campaign's platforms from handles, a discovery list, and/or a CSV file. Monitoring is billed per creator, per day — API calls are included in that price. See [Usage, pricing
 - [DELETE /public/v1/social/listening/campaign/{campaign_id}/creators/](https://docs.influencers.club/openapi/campaigns/public_v1_social_listening_campaign_creators_delete.md): Remove creators from the campaign by creator id (the `id` field from the Creators list). The creators' links are deleted while the campaign and subscriptions are kept; detection stops for the removed
 - [GET /public/v1/social/listening/campaign/{campaign_id}/overview/](https://docs.influencers.club/openapi/campaigns/public_v1_social_listening_campaign_overview_retrieve.md): Return the aggregated overview metrics for a single campaign, including total posts, views, engagement, EMV, and trends. Optionally filter by platform using the `platform` query parameter. Monitoring
 - [GET /public/v1/social/listening/campaign/{campaign_id}/content/](https://docs.influencers.club/openapi/campaigns/public_v1_social_listening_campaign_content_retrieve.md): Return a paginated feed of the campaign's posts (one per detected `new_post` event), optionally narrowed to a single platform and sorted by a metric column (defaults to most recent first). Each post c
 - [GET /public/v1/social/listening/campaign/{campaign_id}/report/](https://docs.influencers.club/openapi/campaigns/public_v1_social_listening_campaign_report_retrieve.md): Return the campaign's most recent AI report. While the report is being generated its `status` is `generating` and `report_data` is empty — poll until `status` becomes `ready` (or `failed`). Monitoring
 - [POST /public/v1/social/listening/campaign/{campaign_id}/report/](https://docs.influencers.club/openapi/campaigns/public_v1_social_listening_campaign_report_create.md): Start asynchronous generation of a new AI report for the campaign (also used to regenerate). Returns the pending report; poll the GET endpoint until its `status` is `ready`. If a generation is already
 - [GET /public/v1/social/listening/campaign/{campaign_id}/report/export/](https://docs.influencers.club/openapi/campaigns/public_v1_social_listening_campaign_report_export_retrieve.md): Download the campaign's raw post-level report data as a CSV file (one row per detected post with its metrics). Monitoring is billed per creator, per day — API calls are included in that price. See [Us