📝 Forms & Applications

Read a form before you touch it, then send an application or a contact request — and have the result actually confirmed. No logins, no payments, no file uploads.

inspect $1.00 · submit $2.00 / 1,000 POST /v1/query USDC on Base · x402

Three modes, one tool

inspect (default) — finds the forms on a page and returns the schema: every field with its HTML type, required flags, choices, hidden CSRF fields, and any captcha with its recognised type. Nothing is submitted.
submit — sends one form with your values, then checks whether it was really accepted: a success phrase, a changed URL, or a JSON echo of the fields.
submit_captcha — same, but solves the captcha first and puts the token in the field the form expects. The captcha is billed as a separate line.

What we refuse — in code, not in policy text

Forms with a password field: that is an account login, not an application.
Forms with payment fields (card, cvv, iban, amount): we do not move money for anyone.
Forms with file uploads: needs the site owner's consent, which we cannot verify.
Cloudflare Challenge: needs a browser session and cookies, not a form field — refused honestly.

Tools in this group

Tool	What it does	Docs
`form_action`	mode=inspect / submit / submit_captcha	Full docs →

Request

# 1) read the form first — fields, required flags, captcha type. Nothing is sent.
curl -X POST https://api.serp-base.com/v1/query \
  -H "Content-Type: application/json" \
  -d '{"tool": "form_action", "query": "https://example.com/contact", "mode": "inspect"}'

# 2) send it
curl -X POST https://api.serp-base.com/v1/query \
  -H "Content-Type: application/json" \
  -d '{"tool": "form_action", "query": "https://example.com/contact", "mode": "submit",
       "values": {"name": "Ivan", "email": "[email protected]", "message": "Hello"}}'

Key parameters

Field	Description
`url`	Page with the form
`mode`	`inspect` (default) · `submit` · `submit_captcha`
`values`	Field name to value — only fields that exist in the form are sent
`form_index`	Which form on the page (default 0)

Response

{
  "status": "submitted",
  "http_status": 200,
  "sent_fields": ["email", "message", "name"],
  "ignored_fields": [],
  "cost_breakdown": {
    "form_call": 0.19,
    "captcha_solution": 0.0
  }
}

status is submitted (a real confirmation signal was found), submitted_rejected, or submitted_unconfirmed — and in the last case you are not charged for a guess.

Payment: pay per call with USDC on Base via the x402 protocol. inspect $1.00/1k · submit $2.00/1k · submit_captcha $2.00/1k plus the captcha solution as a separate line. Reading costs less than sending because it does less. Gas is covered by the facilitator. Refusals and unconfirmed submissions are free.

Read full API docs → Get API key