# AdCrunch Ad groups API

**Canonical:** https://apis.io/apis/adcrunch-dev/adcrunch-dev-ad-groups-api/  
**Provider:** AdCrunch — https://apis.io/providers/adcrunch-dev/  
**Base URL:** https://api.adcrunch.dev  
**Documentation:** https://docs.adcrunch.dev/api

AdCrunch Ad groups API is one of 20 APIs that [AdCrunch](https://apis.io/providers/adcrunch-dev/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Ad Groups. The published artifact set on APIs.io includes an OpenAPI specification.

The ad groups of your advertisers. The providers use different words for one concept. Meta calls it an **ad set**. TikTok and Google Ads call it an **ad group**. Each row keeps the word of its provider in `type`. A Performance Max campaign has no ad groups. Read its asset groups instead. This tag holds the live reads and the changes of one advertiser. For the stored list of every advertiser of your organization, see **Stored reads**. On Meta, you can also change the status, the name, the budget, the bidding and the schedule of an ad set. You can also create an ad set or copy one. A change is asynchronous. The operation answers `202` and starts a Mutation. You poll the Mutation for its outcome.

## Operations (9)

| Method | Path | Summary |
|---|---|---|
| GET | `/observe/{advertiserId}/ad-groups` | List an advertiser’s ad groups |
| GET | `/observe/{advertiserId}/ad-groups/{id}` | Get one ad group |
| POST | `/mutations/{advertiserId}/ad-groups` | Create an ad group |
| PATCH | `/mutations/{advertiserId}/ad-groups/{id}/status` | Update an ad group’s status |
| PATCH | `/mutations/{advertiserId}/ad-groups/{id}/budget` | Update an ad group’s budget |
| PATCH | `/mutations/{advertiserId}/ad-groups/{id}/schedule` | Update an ad group’s schedule |
| PATCH | `/mutations/{advertiserId}/ad-groups/{id}/bidding` | Update an ad group’s bidding |
| PATCH | `/mutations/{advertiserId}/ad-groups/{id}/name` | Update an ad group’s name |
| POST | `/mutations/{advertiserId}/ad-groups/{id}/copies` | Copy an ad group |

## Machine-readable artifacts (2)

- **OpenAPI** — https://artifacts.apis.io/adcrunch-dev/openapi/adcrunch-dev-ad-groups-api-openapi.yml
- **APIsJSON** — https://artifacts.apis.io/adcrunch-dev/apis.yml

## Other AdCrunch APIs (12)

- [AdCrunch Ads API](https://apis.io/apis/adcrunch-dev/adcrunch-dev-ads-api/)
- [AdCrunch Asset groups API](https://apis.io/apis/adcrunch-dev/adcrunch-dev-asset-groups-api/)
- [AdCrunch Assets API](https://apis.io/apis/adcrunch-dev/adcrunch-dev-assets-api/)
- [AdCrunch Brands API](https://apis.io/apis/adcrunch-dev/adcrunch-dev-brands-api/)
- [AdCrunch Campaign Plans API](https://apis.io/apis/adcrunch-dev/adcrunch-dev-campaign-plans-api/)
- [AdCrunch Campaigns API](https://apis.io/apis/adcrunch-dev/adcrunch-dev-campaigns-api/)
- [AdCrunch Creatives API](https://apis.io/apis/adcrunch-dev/adcrunch-dev-creatives-api/)
- [AdCrunch Custom audiences API](https://apis.io/apis/adcrunch-dev/adcrunch-dev-custom-audiences-api/)
- [AdCrunch Custom conversions API](https://apis.io/apis/adcrunch-dev/adcrunch-dev-custom-conversions-api/)
- [AdCrunch Documents API](https://apis.io/apis/adcrunch-dev/adcrunch-dev-documents-api/)
- [AdCrunch Insights API](https://apis.io/apis/adcrunch-dev/adcrunch-dev-insights-api/)
- [AdCrunch Line Items API](https://apis.io/apis/adcrunch-dev/adcrunch-dev-line-items-api/)

## Tags

Ad Groups

---

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