{"slug":"apiacre-com-v1-advertising-pixel-claim-96f23c","title":"Claim atomically reserved pixels or multi-colour blocks with optional public not","host":"apiacre.com","method":"POST","resource":"https://apiacre.com/v1/advertising/pixel-claim","category":"other","description":"Claim atomically reserved pixels or multi-colour blocks with optional public notes and sponsored HTTPS links, covering up to API Acre's full 1,250 x 800 exact-million advertising grid. Each pixel costs exactly 1 USDC; the pixel_count query parameter sets the x402 amount. Create the free reservation ","price_listed":1.0,"price_asked":1.0,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":341,"reported_calls_30d":2,"reported_payers_30d":1,"networks":["eip155:8453","solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"pixel_count":1,"reservation_token":"AAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA","rules_version":"2026-08-18.3"},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":false,"properties":{"pixel_count":{"maximum":1000000,"minimum":1,"title":"Pixel Count","type":"integer"},"reservation_token":{"maxLength":43,"minLength":43,"pattern":"^[A-Za-z0-9_-]{43}$","title":"Reservation Token","type":"string"},"rules_version":{"maxLength":32,"minLength":10,"title":"Rules Version","type":"string"}},"required":["reservation_token","pixel_count","rules_version"],"title":"PixelClaimInput","type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST","PUT","PATCH"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"properties":{"data":{"description":"Structured Pixel Acre advertising claim result","properties":{"bounds":{"type":"string"},"gridUrl":{"type":"string"},"linkPolicy":{"type":"string"},"pixelCount":{"type":"string"},"pricePerPixelUsdc":{"type":"string"},"reservationId":{"type":"string"},"rulesVersion":{"type":"string"},"status":{"type":"integer"},"statusPath":{"type":"string"},"totalPriceUsdc":{"type":"string"}},"type":"object"},"meta":{"properties":{"cached":{"type":"boolean"},"duration_ms":{"minimum":0,"type":"integer"},"next_actions":{"description":"Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.","items":{"properties":{"authorization_required":{"const":true,"type":"boolean"},"checkout_path":{"pattern":"^/try/","type":"string"},"executes_automatically":{"const":false,"type":"boolean"},"handoff_path":{"description":"Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.","pattern":"^/catalog/","type":"string"},"handoff_payment_required":{"const":false,"type":"boolean"},"input_template":{"description":"Client-side template only: $request refers to the original input, $result to this response, and $json(...) serializes its argument. The server does not execute the follow-up.","type":"object"},"maximum_atomic_usdc":{"pattern":"^[1-9][0-9]*$","type":"string"},"method":{"const":"POST","type":"string"},"path":{"pattern":"^/v1/","type":"string"},"price":{"pattern":"^\\$[0-9]+","type":"string"},"reason":{"type":"string"},"sample_path":{"pattern":"^/samples/","type":["string","null"]},"service":{"type":"string"},"title":{"type":"string"},"use_output":{"type":"string"}},"required":["service","title","reason","method","path","price","input_template","use_output","handoff_path","checkout_path","sample_path","maximum_atomic_usdc","handoff_payment_required","executes_automatically","authorization_required"],"type":"object"},"type":"array"},"sources":{"items":{"type":"string"},"type":"array"},"warnings":{"items":{"type":"string"},"type":"array"}},"required":["duration_ms","cached","sources","warnings","next_actions"],"type":"object"},"request_id":{"description":"Unique request identifier","type":"string"},"service":{"const":"advertising.pixel-claim","type":"string"},"version":{"const":"1","type":"string"}},"required":["request_id","service","version","data","meta"],"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-09-24","reachable":true,"status":402,"valid_402":true,"asked_usdc":1.0,"price_match":true,"latency_ms":341,"error":null}],"description_full":"Claim atomically reserved pixels or multi-colour blocks with optional public notes and sponsored HTTPS links, covering up to API Acre's full 1,250 x 800 exact-million advertising grid. Each pixel costs exactly 1 USDC; the pixel_count query parameter sets the x402 amount. Create the free reservation first at POST /pixel-acre/reservations.","last_updated":"2026-08-31T23:39:32.546Z","schemes":["exact"]}