# AdCrunch Ads API

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

AdCrunch Ads 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 Ads. The published artifact set on APIs.io includes an OpenAPI specification.

The ads of your advertisers. Meta and TikTok call it an `ad`. Google Ads calls it an **`ad_group_ad`**. That is a link resource, and its id is the composite `{adGroupId}~{adId}`. Filter by `adGroupId` for the ads of one ad group. Filter by `campaignId` for every ad of a campaign. A Performance Max campaign has no ads. 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 and the name of an ad. You can also create an ad. A change is asynchronous. The operation answers `202` and starts a Mutation. You poll the Mutation for its outcome.

## Operations (5)

| Method | Path | Summary |
|---|---|---|
| GET | `/observe/{advertiserId}/ads` | List an advertiser’s ads |
| GET | `/observe/{advertiserId}/ads/{id}` | Get one ad |
| POST | `/mutations/{advertiserId}/ads` | Create an ad |
| PATCH | `/mutations/{advertiserId}/ads/{id}/status` | Update an ad’s status |
| PATCH | `/mutations/{advertiserId}/ads/{id}/name` | Update an ad’s name |

## Machine-readable artifacts (1)

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

## Other AdCrunch APIs (12)

- [AdCrunch Ad groups API](https://apis.io/apis/adcrunch-dev/adcrunch-dev-ad-groups-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

Ads

---

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