apiacre-com Advertising API

openapi: 3.2.0
info:
  title: Acre Advertising API
  summary: 74 pay-per-call services for autonomous agents
  description: Machine-discoverable web, document, data, developer, research, and EVM utilities. Every paid POST returns structured JSON and uses x402 v2 exact USDC settlement on Base and Solana. Start with GET /.well-known/x402 or GET /catalog.
  contact:
    name: API Acre
    email: hello@apiacre.com
  license:
    name: Proprietary
  version: 0.1.0
  x-guidance: 'Start with GET /recommend?task=<intent>&max_price=<USDC> to get compact rankings without loading every schema; follow service.purchase.fullHandoffUrl for one chosen service, or use GET /catalog for every complete contract. Intent map: public-site research -> web metadata, audits, or business due diligence; supplied documents and data -> extract, redact, profile, or schema tools; code and API changes -> code-change review, OpenAPI audit, test generation, or x402 preflight; official public records -> SEC, OFAC, GLEIF, VIN, World Bank, US address geocoding, or US weather; Base read-only evidence -> address, account, transaction, or contract tools. Paid POST routes use x402 v2 exact USDC on Base: inspect PAYMENT-REQUIRED, obtain explicit buyer authorization, then retry with PAYMENT-SIGNATURE. Samples are free over HTTP and the MCP resource template at /samples/<service-slug>?format=json. One bounded live developer.code-metrics trial is free at /trials/developer.code-metrics; it rejects payment headers; no endpoint signs or broadcasts transactions.'
  x-apiacre-custom-work:
    requestUrl: https://apiacre.com/request-api
    proofUrl: https://apiacre.com/request-api#proof-case
    contactEmail: hello@apiacre.com
    scope:
    - custom_api
    - evidence_audit
    - volume_integration
    - structured_json_workflow
    requestCreatesOrder: false
    requestCreatesCharge: false
    marketplaceOffers: []
    deliveryProof:
      platform: Taskmarket
      completedOn: '2026-08-14'
      taskId: '0xe9fb8fe4e6f83b54d4850efd1c5b6aef6d1bbd7f9f91921d4329f404e64c5682'
      taskUrl: https://taskmarket.dev/tasks/0xe9fb8fe4e6f83b54d4850efd1c5b6aef6d1bbd7f9f91921d4329f404e64c5682
      result:
        role: primary
        rank: 1
        requesterRating: 99
      workerPayment:
        amount: '4.625'
        currency: USDC
        network: eip155:8453
        transactionHash: '0xe580591abe9df357abf20f1d45b3ad26381583719a3bcac7d9297fb9c2e81e7d'
        transactionUrl: https://basescan.org/tx/0xe580591abe9df357abf20f1d45b3ad26381583719a3bcac7d9297fb9c2e81e7d
      claimBoundary: One completed commission evidences delivery, not future outcomes.
  x-apiacre-customer-evidence:
    evidenceType: minimum-independent-production-settlement-aggregate
    observedThrough: '2026-09-01T11:24:57.584032Z'
    settlementNetwork: eip155:8453
    minimumIndependentSettlements: 34
    minimumUniquePayers: 17
    minimumRevenueUsdc: '0.331'
    operatorValidationExcluded: true
    buyerDataPublished: false
    settlementIdentifiersPublished: false
    humanReadableUrl: https://apiacre.com/use-cases#customer-evidenced
    claimBoundary: Each listed service had at least one independently attributed production settlement by observedThrough. Totals are minimum aggregate evidence, exclude operator validation, and do not establish per-service unique buyers, endorsement, repeat demand, a forecast, or a guarantee.
    services:
    - slug: web.metadata
      title: Webpage metadata extraction
      method: POST
      endpointUrl: https://apiacre.com/v1/web/metadata
      priceUsdc: '0.002'
      serviceDocumentationUrl: https://apiacre.com/services/web.metadata
      sampleUrl: https://apiacre.com/samples/web.metadata
      minimumIndependentSettlements: 1
    - slug: crypto.base-network-status
      title: Base network and fee status
      method: POST
      endpointUrl: https://apiacre.com/v1/crypto/base-network-status
      priceUsdc: '0.001'
      serviceDocumentationUrl: https://apiacre.com/services/crypto.base-network-status
      sampleUrl: https://apiacre.com/samples/crypto.base-network-status
      minimumIndependentSettlements: 1
    - slug: data.schema
      title: JSON Schema generator
      method: POST
      endpointUrl: https://apiacre.com/v1/data/schema
      priceUsdc: '0.025'
      serviceDocumentationUrl: https://apiacre.com/services/data.schema
      sampleUrl: https://apiacre.com/samples/data.schema
      minimumIndependentSettlements: 1
    - slug: data.convert
      title: Data conversion
      method: POST
      endpointUrl: https://apiacre.com/v1/data/convert
      priceUsdc: '0.005'
      serviceDocumentationUrl: https://apiacre.com/services/data.convert
      sampleUrl: https://apiacre.com/samples/data.convert
      minimumIndependentSettlements: 1
    - slug: crypto.address-inspect
      title: EVM address inspection
      method: POST
      endpointUrl: https://apiacre.com/v1/crypto/address-inspect
      priceUsdc: '0.002'
      serviceDocumentationUrl: https://apiacre.com/services/crypto.address-inspect
      sampleUrl: https://apiacre.com/samples/crypto.address-inspect
      minimumIndependentSettlements: 1
    - slug: developer.code-metrics
      title: Code metrics
      method: POST
      endpointUrl: https://apiacre.com/v1/developer/code-metrics
      priceUsdc: '0.025'
      serviceDocumentationUrl: https://apiacre.com/services/developer.code-metrics
      sampleUrl: https://apiacre.com/samples/developer.code-metrics
      minimumIndependentSettlements: 1
    - slug: crypto.base-account-status
      title: Base account status
      method: POST
      endpointUrl: https://apiacre.com/v1/crypto/base-account-status
      priceUsdc: '0.003'
      serviceDocumentationUrl: https://apiacre.com/services/crypto.base-account-status
      sampleUrl: https://apiacre.com/samples/crypto.base-account-status
      minimumIndependentSettlements: 1
    - slug: developer.code-change-review
      title: Code change review
      method: POST
      endpointUrl: https://apiacre.com/v1/developer/code-change-review
      priceUsdc: '0.05'
      serviceDocumentationUrl: https://apiacre.com/services/developer.code-change-review
      sampleUrl: https://apiacre.com/samples/developer.code-change-review
      minimumIndependentSettlements: 1
    - slug: developer.x402-preflight
      title: x402 endpoint preflight
      method: POST
      endpointUrl: https://apiacre.com/v1/developer/x402-preflight
      priceUsdc: '0.05'
      serviceDocumentationUrl: https://apiacre.com/services/developer.x402-preflight
      sampleUrl: https://apiacre.com/samples/developer.x402-preflight
      minimumIndependentSettlements: 1
    - slug: data.deduplicate
      title: Record deduplication
      method: POST
      endpointUrl: https://apiacre.com/v1/data/deduplicate
      priceUsdc: '0.01'
      serviceDocumentationUrl: https://apiacre.com/services/data.deduplicate
      sampleUrl: https://apiacre.com/samples/data.deduplicate
      minimumIndependentSettlements: 1
    - slug: data.schema-validate
      title: JSON Schema validation
      method: POST
      endpointUrl: https://apiacre.com/v1/data/schema-validate
      priceUsdc: '0.01'
      serviceDocumentationUrl: https://apiacre.com/services/data.schema-validate
      sampleUrl: https://apiacre.com/samples/data.schema-validate
      minimumIndependentSettlements: 1
    - slug: data.json-repair
      title: Deterministic JSON repair
      method: POST
      endpointUrl: https://apiacre.com/v1/data/json-repair
      priceUsdc: '0.005'
      serviceDocumentationUrl: https://apiacre.com/services/data.json-repair
      sampleUrl: https://apiacre.com/samples/data.json-repair
      minimumIndependentSettlements: 1
    - slug: web.links
      title: Link and site-map analysis
      method: POST
      endpointUrl: https://apiacre.com/v1/web/links
      priceUsdc: '0.005'
      serviceDocumentationUrl: https://apiacre.com/services/web.links
      sampleUrl: https://apiacre.com/samples/web.links
      minimumIndependentSettlements: 1
    - slug: crypto.base-block-inspect
      title: Base block inspection
      method: POST
      endpointUrl: https://apiacre.com/v1/crypto/base-block-inspect
      priceUsdc: '0.001'
      serviceDocumentationUrl: https://apiacre.com/services/crypto.base-block-inspect
      sampleUrl: https://apiacre.com/samples/crypto.base-block-inspect
      minimumIndependentSettlements: 1
    - slug: data.current-weather
      title: Current weather snapshot
      method: POST
      endpointUrl: https://apiacre.com/v1/data/current-weather
      priceUsdc: '0.002'
      serviceDocumentationUrl: https://apiacre.com/services/data.current-weather
      sampleUrl: https://apiacre.com/samples/data.current-weather
      minimumIndependentSettlements: 1
  x-apiacre-external-reliability:
    provider: The x402 Register
    reportUrl: https://x402register.com/s/apiacre.com
    attributionUrl: https://x402register.com
    measurement: independent-hourly-x402-payment-handshake
    listing: free-and-automatic
    paidPlacement: false
    evaluates:
    - payment-challenge-availability
    - handshake-latency
    - advertised-versus-live-price
    - x402-protocol-version
    - cross-vantage-consistency
    limitations:
    - The grade samples shared infrastructure and a rotating subset of products, not every product every hour.
    - The probes do not pay endpoints or verify paid-output correctness or completeness.
    - Measurements can change; read the linked report for current values and its observation timestamp.
servers:
- url: https://apiacre.com
  description: API Acre
tags:
- name: Advertising
paths:
  /v1/advertising/pixel-claim:
    post:
      tags:
      - Advertising
      summary: Pixel Acre advertising claim
      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 first at POST /pixel-acre/reservations.


        Price: **$1 x pixel_count USDC** via x402 exact payment on Base and Solana.'
      operationId: advertising_pixel-claim
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PixelClaimInput'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceResponse'
        '402':
          description: Payment Required. Decode PAYMENT-REQUIRED, satisfy the x402 requirement, and retry with PAYMENT-SIGNATURE.
          headers:
            PAYMENT-REQUIRED:
              description: Base64-encoded x402 v2 payment requirements
              schema:
                type: string
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security: []
      x-x402-price: $1 x pixel_count
      x-x402-network: eip155:8453
      x-x402-networks:
      - eip155:8453
      - solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp
      x-payment-info:
        price:
          mode: dynamic
          currency: USD
          min: '1'
          max: '1000000'
          unitAmount: '1'
          unit: pixel
          queryParameter: pixel_count
          bodyField: pixel_count
          minimumQuantity: 1
          maximumQuantity: 1000000
        protocols:
        - x402: {}
      parameters:
      - name: pixel_count
        in: query
        required: true
        description: 'Sets the exact x402 amount: quantity x $1 USDC. It must match JSON field pixel_count.'
        schema:
          type: integer
          minimum: 1
          maximum: 1000000
      x-agent-tags:
      - advertising
      - pixel-grid
      - x402
      - base
      - pixel-art
      - agent-marketing
      - sponsored-link
      x-output-schema:
        type: object
        required:
        - request_id
        - service
        - version
        - data
        - meta
        properties:
          request_id:
            type: string
            description: Unique request identifier
          service:
            type: string
            const: advertising.pixel-claim
          version:
            type: string
            const: '1'
          data:
            type: object
            description: Structured Pixel Acre advertising claim result
            properties:
              status:
                type: string
              reservationId:
                type: string
              pixelCount:
                type: integer
              pricePerPixelUsdc:
                type: string
              totalPriceUsdc:
                type: string
              bounds:
                type: object
              gridUrl:
                type: string
              statusPath:
                type: string
              rulesVersion:
                type: string
              linkPolicy:
                type: string
          meta:
            type: object
            required:
            - duration_ms
            - cached
            - sources
            - warnings
            - next_actions
            properties:
              duration_ms:
                type: integer
                minimum: 0
              cached:
                type: boolean
              sources:
                type: array
                items:
                  type: string
              warnings:
                type: array
                items:
                  type: string
              next_actions:
                type: array
                description: Optional separately priced follow-up calls. Each action requires a new payment challenge and explicit buyer authorization.
                items:
                  type: object
                  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
                  properties:
                    service:
                      type: string
                    title:
                      type: string
                    reason:
                      type: string
                    method:
                      type: string
                      const: POST
                    path:
                      type: string
                      pattern: ^/v1/
                    price:
                      type: string
                      pattern: ^\$[0-9]+
                    input_template:
                      type: object
                      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.'
                    use_output:
                      type: string
                    handoff_path:
                      type: string
                      pattern: ^/catalog/
                      description: Free full contract and spend-capped command handoff; reading it does not execute or purchase the follow-up.
                    checkout_path:
                      type: string
                      pattern: ^/try/
                    sample_path:
                      type:
                      - string
                      - 'null'
                      pattern: ^/samples/
                    maximum_atomic_usdc:
                      type: string
                      pattern: ^[1-9][0-9]*$
                    handoff_payment_required:
                      type: boolean
                      const: false
                    executes_automatically:
                      type: boolean
                      const: false
                    authorization_required:
                      type: boolean
                      const: true
      x-output-example:
        request_id: 018f1f54-7f38-7ba2-8dc3-5f90272d9f1a
        service: advertising.pixel-claim
        version: '1'
        data:
          status: claimed
          reservationId: 018f1f54-7f38-7ba2-8dc3-5f90272d9f1a
          pixelCount: 1
          pricePerPixelUsdc: '1'
          totalPriceUsdc: '1'
          bounds:
            minX: 4
            minY: 7
            maxX: 4
            maxY: 7
            width: 1
            height: 1
          gridUrl: /pixel-acre
          statusPath: /pixel-acre/status
          rulesVersion: 2026-08-18.3
          linkPolicy: Destinations are rendered as sponsored, nofollow, ugc links and remain subject to moderation.
        meta:
          duration_ms: 42
          cached: false
          sources: []
          warnings: []
          next_actions: []
components:
  schemas:
    ServiceResponse:
      properties:
        request_id:
          type: string
          title: Request Id
        service:
          type: string
          title: Service
        version:
          type: string
          title: Version
          default: '1'
        data:
          additionalProperties: true
          type: object
          title: Data
        meta:
          $ref: '#/components/schemas/ServiceMeta'
      type: object
      required:
      - request_id
      - service
      - data
      - meta
      title: ServiceResponse
    PixelClaimInput:
      properties:
        reservation_token:
          type: string
          maxLength: 43
          minLength: 43
          pattern: ^[A-Za-z0-9_-]{43}$
          title: Reservation Token
        pixel_count:
          type: integer
          maximum: 1000000.0
          minimum: 1.0
          title: Pixel Count
        rules_version:
          type: string
          maxLength: 32
          minLength: 10
          title: Rules Version
      additionalProperties: false
      type: object
      required:
      - reservation_token
      - pixel_count
      - rules_version
      title: PixelClaimInput
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ServiceMeta:
      properties:
        duration_ms:
          type: integer
          title: Duration Ms
        cached:
          type: boolean
          title: Cached
          default: false
        sources:
          items:
            type: string
          type: array
          title: Sources
        warnings:
          items:
            type: string
          type: array
          title: Warnings
        next_actions:
          items:
            $ref: '#/components/schemas/ServiceNextAction'
          type: array
          title: Next Actions
      type: object
      required:
      - duration_ms
      title: ServiceMeta
    ServiceNextAction:
      properties:
        service:
          type: string
          title: Service
        title:
          type: string
          title: Title
        reason:
          type: string
          title: Reason
        method:
          type: string
          const: POST
          title: Method
          default: POST
        path:
          type: string
          title: Path
        price:
          type: string
          title: Price
        input_template:
          additionalProperties: true
          type: object
          title: Input Template
        use_output:
          type: string
          title: Use Output
        handoff_path:
          type: string
          title: Handoff Path
        checkout_path:
          type: string
          title: Checkout Path
        sample_path:
          anyOf:
          - type: string
          - type: 'null'
          title: Sample Path
        maximum_atomic_usdc:
          type: string
          title: Maximum Atomic Usdc
        handoff_payment_required:
          type: boolean
          const: false
          title: Handoff Payment Required
          default: false
        executes_automatically:
          type: boolean
          const: false
          title: Executes Automatically
          default: false
        authorization_required:
          type: boolean
          title: Authorization Required
          default: true
      type: object
      required:
      - service
      - title
      - reason
      - path
      - price
      - input_template
      - use_output
      - handoff_path
      - checkout_path
      - sample_path
      - maximum_atomic_usdc
      title: ServiceNextAction
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
externalDocs:
  description: API Acre x402 buyer and integration guide
  url: https://apiacre.com/buyers
x-agentcash-guidance:
  llmsTxtUrl: https://apiacre.com/llms.txt