AdCrunch

AdCrunch Ads API

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.

GitHub OpenAPI

Operations 5

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 #

Specifications

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

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/adcrunch-dev:adcrunch-dev-ads-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

adcrunch-dev-ads-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  contact:
    email: tech@adcrunch.dev
  description: 'Every AdCrunch API, in one document. Each API also publishes its own, at `/openapi/.json`.


    One origin serves the four, and the first segment of a path names the API. `/observe` reads the campaigns, the ads and the Insights of the ad accounts your organization connects. `/mutations` changes what runs on them. `/context` holds the Skills, Brands, Personas, Documents and Campaign Plans an organization writes down for its agents. `/assets` holds your images and videos, and places them in the library of an ad account.


    One credential works on the four — see the security scheme.


    The guide explains what these operations share: authentication, the failure shape, and the conventions for ids, money, time and pagination. It also describes three flows that span several operations: a change, an upload, and an edit that does not overwrite.


    Start at https://docs.adcrunch.dev/api/introduction.'
  license:
    name: Proprietary
    url: https://adcrunch.dev
  title: AdCrunch Ads API
  version: 1.0.0
servers:
- description: production stage
  url: https://api.adcrunch.dev
security:
- bearerAuth: []
tags:


# --- truncated at 32 KB (85 KB total) ---
# Full source: https://artifacts.apis.io/adcrunch-dev/openapi/adcrunch-dev-ads-api-openapi.yml