Analyse a sponsored-ads search-term report API
Aggregate ACoS, ROAS, TACoS, CTR and CVR for a search-term report and flag negate, promote and insufficient-data candidates from caller rules.
The Analyse a sponsored-ads search-term report operation is part of the Ecommerce Seller Profitability Unit Economics API on BRAINIAC.software. Aggregate ACoS, ROAS, TACoS, CTR and CVR for a search-term report and flag negate, promote and insufficient-data candidates from caller rules. It is exposed as POST /api/v1/ecommerce-profitability/ppc-report-analyze and priced at $0.04 USDC on Base. Payment uses the x402 exact scheme: an unpaid call returns HTTP 402 with payment requirements; after paying the exact USDC amount, retry the same request with a payment-signature header and Idempotency-Key. No account and no API key are required. Data sources for this product: Caller-supplied marketplace fees, product costs, ads rows, listing text, shipment lines, price history and settlement exports processed locally Limitations: Pure computation on caller input: no marketplace, payment-processor, tariff or tax API is called at request time. Fee schedules, duty rates, VAT rates and listing length limits must be supplied by the caller. Outputs are lookups or prechecks for human review. They are not legal, customs, tax, medical, or identity determinations. Money amounts are integers in minor units of one currency per request unless a fee rate produces a fractional intermediate. Outputs are compliance prechecks, drafts, or data lookups for human review. They are not official determinations, legal advice, identity confirmation, or certified filings. Related operations in this group include Per-unit contribution margin and break-even, Check listing keyword coverage and length limits, Allocate import costs to SKU landed cost, Estimate own-price elasticity from history. Open the group documentation for the full request schema, field notes, and response examples before integrating.
/api/v1/ecommerce-profitability/ppc-report-analyzeExample request
curl -i -X POST "https://www.brainiac.software/api/v1/ecommerce-profitability/ppc-report-analyze" \
-H 'content-type: application/json' \
-H 'Idempotency-Key: <fresh-64-character-random-hex-key>' \
--data-binary @- <<'JSON'
{
"currency": "USD",
"rows": [
{
"campaign": "A",
"adGroup": "g1",
"searchTerm": "steel bottle",
"matchType": "broad",
"impressions": 1000,
"clicks": 40,
"spend": 3200,
"orders": 4,
"sales": 11996
}
],
"totalSales": 500000,
"rules": {
"targetAcos": 0.3,
"minClicksNegate": 15,
"minOrdersPromote": 2
}
}
JSONAn unpaid probe returns HTTP 402 with x402 payment requirements. After paying the exact USDC amount on Base, retry the identical request with a payment-signature header.
FAQ
- Do I need an API key? No. Pay the listed USDC amount with x402.
- What network? Base (eip155:8453), USDC.
- Is this an official determination? No. Results are for human review against the cited sources.
Related operations
- Per-unit contribution margin and break-even — $0.03 USDC
- Check listing keyword coverage and length limits — $0.02 USDC
- Allocate import costs to SKU landed cost — $0.04 USDC
- Estimate own-price elasticity from history — $0.04 USDC
Related APIs
Ecommerce Seller Profitability Unit Economics APIFull docsHow it works