CrawlForge
Advanced Tool3 credits

form_submit

Auto-detect form fields, fill data, validate, and submit with support for file uploads and multi-step forms. Perfect for automated data entry, form testing, job applications, and survey automation.

Use Cases

Automated Data Entry

Fill and submit forms automatically for bulk data entry tasks

Form Testing

Test form validation, error handling, and submission workflows

Job Applications

Automate filling and submitting job application forms

Survey Automation

Complete surveys and questionnaires programmatically

Lead Generation

Submit contact forms and lead capture forms across multiple sites

Multi-Step Forms

Handle complex multi-step wizards with conditional logic

Endpoint

POST/api/v1/tools/form_submit
Auth Required
2 req/s on Free plan
3 credits

Parameters

NameTypeRequiredDefaultDescription
url
stringRequired-
The URL of the page containing the form
Example: https://example.com/contact
fields
arrayRequired-
Array of form fields to fill with selectors and values
Example: [{"selector": "#email", "value": "user@example.com", "type": "text"}]
submitSelector
stringOptional-
CSS selector of the submit button (auto-detected if not provided)
Example: #submit-button
waitForNavigation
booleanOptionaltrue
Wait for navigation after form submission
Example: true
captureResponse
booleanOptionaltrue
Capture the response page content after submission
Example: true

Supported Field Types

textText input field
emailEmail input field
passwordPassword input field
numberNumber input field
selectDropdown select element
checkboxCheckbox input (value: true/false)
radioRadio button input
textareaMulti-line text area
fileFile upload input (base64 encoded)

Request Examples

terminalBash

Response Example

200 OK3240ms
{
  "success": true,
  "data": {
    "success": true,
    "submittedData": {
      "name": "John Doe",
      "email": "john@example.com",
      "message": "Hello, I am interested in your services",
      "newsletter": true
    },
    "responseUrl": "https://example.com/thank-you",
    "responseContent": "
Thank you for contacting us!
...",
    "validationErrors": [],
    "formDetails": {
      "action": "/api/contact",
      "method": "POST",
      "fieldCount": 4,
      "requiredFields": 3
    }
  },
  "credits_used": 3,
  "credits_remaining": 997,
  "processing_time": 3240
}
Field Descriptions
data.successWhether the form was submitted successfully
data.submittedDataObject containing all field values that were submitted
data.responseUrlURL of the page after form submission (may redirect)
data.responseContentHTML content of the response page (if captureResponse: true)
data.validationErrorsArray of validation errors (empty if successful)
data.formDetailsInformation about the form (action, method, field count)
credits_usedCredits deducted for this request (3 per form submission)
processing_timeTotal time including form filling and submission

Error Handling

Field Not Found (404 Not Found)

One or more field selectors didn't match any elements. Verify the CSS selectors are correct.

Validation Failed (422 Unprocessable Entity)

The form validation failed. Check the validationErrors array in the response for details.

Submit Button Not Found (404 Not Found)

The submit button selector didn't match any element. Try omitting submitSelector for auto-detection.

Insufficient Credits (402 Payment Required)

Your account doesn't have enough credits (need 3). Purchase more credits or upgrade your plan.

Rate Limit Exceeded (429 Too Many Requests)

You've exceeded your plan's rate limit. Wait a moment or upgrade your plan for higher limits.

Credit Cost

3 credits
3 credits per submission
Each successful form_submit request costs 3 credits, regardless of the number of fields.

Free Plan: 1,000 credits/month = 333 form submissions

Hobby Plan: 5,000 credits/month = 1,666 form submissions ($19/mo)

Professional Plan: 50,000 credits/month = 16,666 form submissions ($99/mo)

Business Plan: 250,000 credits/month = 83,333 form submissions ($399/mo)

Related Tools

scrape_with_actions
More control with action chains for complex forms (5 credits)
fetch_url
Fetch the form page before submitting (1 credit)