AIsa Ads
DirectDisponível245 APIsPor usoAtualizado em 1 de jan. de 1
Gerencie campanhas, conjuntos de anúncios, anúncios, públicos e relatórios nas contas de anúncios que você conecta, com o mesmo formato de solicitação para os anúncios no Meta, Google, TikTok, LinkedIn, Pinterest, X, Reddit e OpenAI (ChatGPT).
Faça uma chamada
Uma só chave para todos os fornecedores. Este exemplo chama List ads. Por uso
A resposta é o JSON original de AIsa Ads, repassado sem alterações.
Como é cobrado
- Por requisição245 APIs
- Um preço fixo por chamada, mostrado em cada API.
APIs245
Todas as APIs que a AIsa oferece para AIsa Ads, como a api.aisa.one as lista hoje. Cada caminho abre a sua página na documentação.
- GET
/apis/v1/adsList ads · Ad Campaigns. Read only. Lists your ads with their performance over a date range, including ads created directly in each platform's ads manager. Returns a paginated list of ads with metrics computed over an optional date range. Use source=all to include externally-synced ads from platform ad managers. If no date range is provided, it defaults to the last 90 days. The date range is capped at 730 days max. ### HistoryPor uso - GET
/apis/v1/ads/accountsList ad accounts · Ad Accounts. Read only. Lists the ad accounts a connection can manage, such as Meta ad accounts, TikTok advertisers or Google Ads customers. Returns the platform ad accounts available for the given account (e.g. Meta ad accounts, TikTok advertiser IDs, Google Ads customer IDs). ### Meta Meta business-login accounts use their own system-user token.Por uso - POST
/apis/v1/ads/accountsCreate ad account · Ad Accounts. Can spend money or change spend: needs the ads:spend scope and X-Aisa-Confirm: spend; without the header the request is refused with confirmation_required and nothing is sent. Creates a new ad account. validateOnly=true checks the request without acting and needs no confirmation. Creates a new Meta ad account in the user's own business portfolio, or a Google Ads client account under a manager (MCC) account the connection reaches. Billing must then be set up on the platform. Meta (omit `platform` or send `meta`). Creates a durable Meta ad account in the end user's own business portfolio using their connected Meta Ads token. ### Meta requirementsPor uso - PATCH
/apis/v1/ads/accountsUpdate ad account settings · Ad Accounts. Can spend money or change spend: needs the ads:spend scope and X-Aisa-Confirm: spend; without the header the request is refused with confirmation_required and nothing is sent. Changes ad account settings, including its spend cap. Changes a Meta ad account's name, spend cap or default EU DSA beneficiary and payor. Pass any combination of fields. On Google Ads, only URL tracking fields apply (see below). Other platforms return 400. ### Spend cap `spendCap` is the total the account may spend before Meta pauses every campaign in it, in whole units of the account currency. `spendCap: null` removes the cap.Por uso - GET
/apis/v1/ads/accounts/billingGet ad account billing · Ad Accounts. Read only. Reads the payments accounts a Google Ads account can be billed to, plus its billing setups and account budgets. ### Payments accounts Payments accounts come from Google's PaymentsAccountService, read as the manager above the customer. They are the monthly invoicing (consolidated billing) accounts of that manager.Por uso - POST
/apis/v1/ads/accounts/billingSet up ad account billing (monthly invoicing) · Ad Accounts. Can spend money or change spend: needs the ads:spend scope and X-Aisa-Confirm: spend; without the header the request is refused with confirmation_required and nothing is sent. Sets up billing for the ad account, with its spending limit. validateOnly=true checks the request without acting and needs no confirmation. Bills a Google Ads account to a monthly invoicing payments account of a manager above it, and proposes its account budget, so the account can serve without anyone opening Google Ads. ### Monthly invoicing only Google's API cannot add a card or other payment method.Por uso - GET
/apis/v1/ads/accounts/calloutsList account callouts · Ad Accounts. Read only. Lists the callouts attached at account level in Google Ads, which can show on ads across all campaigns. Fresh reads are cached for 10 minutes; exhausted quota may return the last successful read with stale=true. Inherited assets are not included. Preserves Google RMF C.75 account-level callouts.Por uso - POST
/apis/v1/ads/accounts/calloutsAdd account callouts · Ad Accounts. Changes the ad account without starting or raising spend; audited. Creates callouts and attaches them at account level in Google Ads so they can show on ads across all campaigns. Creates assets and customer_asset links for this Google customer. Links apply at account level.Por uso - PUT
/apis/v1/ads/accounts/calloutsUpdate account callouts · Ad Accounts. Changes the ad account without starting or raising spend; audited. Edits existing Google Ads callouts in place; the change applies everywhere that callout is used. Send updates with assetResourceName and the fields to change. An asset is shared: changes affect every attachment using it. Omitted fields stay unchanged. The operation consumes the Google operations budget and invalidates affected cached lists.Por uso - DELETE
/apis/v1/ads/accounts/calloutsRemove account callout · Ad Accounts. Changes the ad account without starting or raising spend; audited. Detaches a callout from the Google Ads account level, leaving it on any campaigns or ad groups that still use it. Removes the customer_asset attachment only. The underlying shared asset and its campaign or ad-group attachments remain. Fields go in the query string. A JSON body with the same fields is also accepted and, when sent, the query string is ignored.Por uso - GET
/apis/v1/ads/accounts/financeAd account finances · Ad Accounts. Read only. Shows a Meta ad account's balance, total spend, spend cap and funding source. Finances of one Meta ad account: prepaid `balance`, lifetime `amountSpent`, account `spendCap` (null = no cap) and the `fundingSource`. Money values are converted from Meta's minor units to whole units of `currency`.Por uso - GET
/apis/v1/ads/accounts/healthCheck an ad account before creating ads · Ad Accounts. Read only. Checks whether a Meta ad account can run ads right now, with a fix link for each problem. ### What is checked the account status the payment method the account spending limit the Facebook Page and its Instagram account the Page's Lead Ads terms the newest pixel event the WhatsApp number linked to the PagePor uso - GET
/apis/v1/ads/accounts/hierarchyGet manager account hierarchy · Ad Accounts. Read only. Shows the Google Ads manager (MCC) and client account tree for a connection, including pending invitations and link status. ### How the tree is built It starts from every customer the Google user behind the connection can access directly and walks each tree to any depth with `customer_client`.Por uso - GET
/apis/v1/ads/accounts/liveRead an ad account's campaigns and ad sets live · Ad Accounts. Read only. Reads an ad account's campaigns and ad sets straight from Meta or TikTok, so checks like budget limits see current values. It reads one Meta ad account or TikTok advertiser live from the platform, so it is cheap enough to run before every write. For example, a per-ad-account spend ceiling that must see the current daily / lifetime budget rather than the synced copy.Por uso - POST
/apis/v1/ads/accounts/manager-linksInvite a client account to a manager · Ad Accounts. Changes the ad account without starting or raising spend; audited. validateOnly=true checks the request without acting and needs no confirmation. Invites a Google Ads account to be managed by one of your manager accounts; the link stays pending until the client accepts. Sends a manager-to-client link invitation from `managerCustomerId` to `clientCustomerId` (Google's CustomerClientLinkService). The manager must be one the connection's Google user reaches, directly or under another manager (see GET /apis/v1/ads/accounts/hierarchy).Por uso - PATCH
/apis/v1/ads/accounts/manager-linksAccept, decline, cancel or end a manager link · Ad Accounts. Changes the ad account without starting or raising spend; audited. validateOnly=true checks the request without acting and needs no confirmation. Accepts, declines or cancels a Google Ads manager invitation, or ends an existing manager-client link. Changes one manager-client link, identified by `managerCustomerId`, `clientCustomerId` and `managerLinkId` (all from GET /apis/v1/ads/accounts/hierarchy). ### Actions `accept` and `decline`: answer a pending invitation as the client (CustomerManagerLinkService).Por uso - GET
/apis/v1/ads/accounts/negative-keyword-listsList negative keyword lists · Ad Accounts. Read only. Lists the shared negative keyword lists in a Google Ads account, which you can apply to many campaigns at once. Google Ads shared negative keyword lists (shared_set type NEGATIVE_KEYWORDS). Reads are cached for 10 minutes; quota exhaustion may return the last successful result for up to 7 days with stale=true. Customer selection is limited to this connection and its account scope.Por uso - POST
/apis/v1/ads/accounts/negative-keyword-listsCreate a negative keyword list · Ad Accounts. Changes the ad account without starting or raising spend; audited. Creates a shared Google Ads negative keyword list, optionally with starting keywords; it is not attached to any campaign yet. Creates one Google Ads shared negative keyword list with optional initial keywords in a single atomic mutation. Daily quota is reserved for every mutate item, so large batches may return 429 before any change. This operation is not idempotent.Por uso - GET
/apis/v1/ads/accounts/negative-keyword-lists/{listId}Get a negative keyword list · Ad Accounts. Read only. Shows one shared Google Ads negative keyword list with all of its keywords. Google Ads shared negative keyword lists (shared_set type NEGATIVE_KEYWORDS). Reads are cached for 10 minutes; quota exhaustion may return the last successful result for up to 7 days with stale=true. Customer selection is limited to this connection and its account scope. Includes the keywords and their criterion ids.Por uso - PUT
/apis/v1/ads/accounts/negative-keyword-lists/{listId}Rename a negative keyword list · Ad Accounts. Changes the ad account without starting or raising spend; audited. Renames a shared Google Ads negative keyword list without changing its keywords or the campaigns using it. Keywords and campaign associations are unchanged. Use the keywords endpoint to edit the desired keyword set.Por uso