Get Form

Use this endpoint to scrape and return form information in the correct format, which is required to retrieve the necessary details to apply to a job through Wrangle.

Form Structure

The form model contains all the scraped information about the job application form, including labels, tags, types, selectors, and descriptions.

Form Output Structure

Name
label
Type
string
Description
Label for the form field.
Name
required
Type
boolean
Description
Indicates if the field is required.
Name
tag
Type
string
Description
HTML tag for the form field (input, checkbox, dropdown, etc.).
Name
type
Type
string
Description
Type of the form field (text, number, etc.).
Name
selector
Type
string
Description
CSS selector for the form field (id).
Name
description
Type
string
Description
Description or instruction related to the form field.

POST/api/api-get-form

Retrieve Form Information

This endpoint allows the retrieval of the form information related to a job application, given an ATS job link (Greenhouse, Lever, Workable, etc).

Input

Name
appLink
Type
string
Description
ATS job link (output from get-link).

Request

POST

/api/api-get-form

curl -X POST https://app.wranglejobs.com/api/api-get-form \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer ${api-key}" \
  -d '{"appLink": "link-to-application"}'

Response

{
  "finalUrl": "post-redirect ATS job URL",
  "formInfo": [
    // Array of form_section dictionaries
  ]
}

Errors

500: “Error while getting form information”