Form Filling

Although Airtop already has the necesssary primitives to fill forms (clicking, typing, etc), form filling is such a common use case that we created it’s dedicated API to make it easier and a lot faster to fill forms.

How to fill a form

To fill a form, you need to follow these steps:

1. Create a session and load a website that contains the form you want to fill

   1
     const session = await client.sessions.create();
   2
     const window = await client.windows.create(session.data.id, {
   3
       url: "https://docs.google.com/forms/d/e/1FAIpQLSdR1-QUVcufdr64IMWE-mOaOCjWfU3yudhaAw8unc4UfOqKEQ/viewform",
   4
     });

2. Fill out the form

   1
     await client.windows.fillForm(session.data.id, window.data.windowId, {
   2
       automationId: "auto",
   3
       parameters: {
   4
         customData: `
   5
   Favorite data in all of history: 01/16/1986
   6
   Favorite time of day: 9am
   7
   Favorite aspect of the world: the weather
   8
   Do you like planets: I like inner planets and outer planets
   9
   Choose planets you care about: Mars
   10
   Favorite animal: dog
   11
   Score of earth: 10
   12
   Stars to give earth: 4
   13
   Car: least, animal: moderate, planet: most
   14
   Cars: Honda
   15
         `
   16
       }
   17
     });

3. Observe how the form is filled automatically

How does it work?

The form filling API executes as a 2 step process. First, the API will analyze the page to understand the structure of the form elements. Then, the API will fill the form elements with the provided custom data. The custom data will be mapped to the form elements based on the analysis of the page and the description of the data provided. It’s important that you describe the data in a way that is easy for the AI to understand and map to the form elements.

Experiment with the form filling API

You can experiment with the form filling API in the API Playground.

Form filling is in beta and we’d love to hear your feedback. Reach out to us on Discord if you have any questions or feedback.