Check a product page

POST

/mc4p/page-checks

curl --request POST \
  --url https://api.mintall.ai/api/v1/mc4p/page-checks \
  --header 'Content-Type: application/json' \
  --data '{ "url": "example", "freshness": "cached" }'

• Production

Fetch a public product page, extract the commercial facts, and report whether an MC4P document is present on it.

freshness: cached serves a recent observation of the page. freshness: fresh refetches it. Fresh checks are rate limited per caller and return 429 once the limit is reached.

Request Body^required

Media typeapplication/json

PageCheckRequest

object

url

required

Url

string

<= 2048 characters

freshness

Freshness

string

default: cached

Allowed values: cached fresh

Responses

200

Successful Response

Media typeapplication/json

PageCheckResponse

The full report for one page check.

object

id

required

Id

string format: uuid

report_schema_version

Report Schema Version

integer

default: 1

url

required

Url

string

final_url

Any of:

string

string

null

null

fetched_at

required

Fetched At

string format: date-time

platform_detected

required

Platform Detected

string

Allowed values: shopify woocommerce unknown

verdict

required

Verdict

string

facts

required

ProductFactsResponse

Every fact the page stated, each with where it was read.

A null field means the page did not state it.

object

name

Any of:

ProductFactResponse

ProductFactResponse

object

value

required

Value

string

source

required

Source

string

field

required

Field

string

null

null

description

Any of:

ProductFactResponse

ProductFactResponse

object

value

required

Value

string

source

required

Source

string

field

required

Field

string

null

null

price

Any of:

ProductFactResponse

ProductFactResponse

object

value

required

Value

string

source

required

Source

string

field

required

Field

string

null

null

currency

Any of:

ProductFactResponse

ProductFactResponse

object

value

required

Value

string

source

required

Source

string

field

required

Field

string

null

null

availability

Any of:

ProductFactResponse

ProductFactResponse

object

value

required

Value

string

source

required

Source

string

field

required

Field

string

null

null

sku

Any of:

ProductFactResponse

ProductFactResponse

object

value

required

Value

string

source

required

Source

string

field

required

Field

string

null

null

brand

Any of:

ProductFactResponse

ProductFactResponse

object

value

required

Value

string

source

required

Source

string

field

required

Field

string

null

null

images

Images

Array<object>

default:

ProductFactResponse

object

value

required

Value

string

source

required

Source

string

field

required

Field

string

mc4p

required

Mc4pPresenceResponse

object

present

Present

boolean

shape

Any of:

string

string

null

null

snapshot_at

Any of:

string

string

null

null

spec_version

Any of:

string

string

null

null

canonical_source

Any of:

string

string

null

null

product_id

Any of:

string

string

null

null

issued_to

Any of:

string

string

null

null

status

Any of:

string

string

Allowed values: verified failed unverified

null

null

checks

Any of:

object

object

key

additional properties

any

null

null

images

Any of:

Array<object>

Array<object>

CertifiedImageResponse

One image the registry certified for the product the page’s document names.

Registry data, not a page observation: it says what Mintall issued for the listing, not whether the bytes the page serves are this image. Observed page images stay in facts.images.

object

asset_id

required

Asset Id

string

certificate_url

required

Certificate Url

string

content_url

Any of:

string

string

null

null

has_c2pa

required

Has C2Pa

boolean

minted

required

Minted

boolean

null

null

findings

Findings

Array<string>

default:

warnings

Warnings

Array<string>

default:

errors

Errors

Array<string>

default:

Example

{
  "report_schema_version": 1,
  "platform_detected": "shopify",
  "facts": {
    "images": []
  },
  "mc4p": {
    "present": false,
    "status": "verified"
  },
  "findings": [],
  "warnings": [],
  "errors": []
}

422

Validation Error

Media typeapplication/json

HTTPValidationError

object

detail

Detail

Array<object>

ValidationError

object

loc

required

Location

Array

msg

required

Message

string

type

required

Error Type

string

input

Input

ctx

Context

object

Example ^generated

{
  "detail": [
    {
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example",
      "input": "example",
      "ctx": {}
    }
  ]
}

429

Fresh page check rate limit reached.

502

The page check failed.