# Get Started

Welcome to the Gaffa documentation site! You'll find everything you need here to get started using the API, including [interactive API definitions](/docs/api-reference/api-authentication.md), [a comprehensive list of actions](/docs/features/browser-requests/actions.md) you can use to interact with our cloud browsers, and [breakdowns of our example requests](/docs/features/browser-requests/api-playground-examples.md) you can run right away in our API Playground.

{% hint style="info" %}
Gaffa is currently in its very early stages, so we'd love to hear how we can improve our docs and API to make life easier for our users. If you have any questions or comments, please [email us](emailto:support@gaffa.dev) or use [the support tool on our site](https://go.crisp.chat/chat/embed/?website_id=87a5807c-14f5-4ed3-9fbe-3d161610357b).\
\
To stay up to date with the latest developments, features, and news on the mission to support the development of revolutionary AI Agents, sign up for sporadic [newsletter](https://gaffa.dev/#newsletter) updates.
{% endhint %}

{% stepper %}
{% step %}

## Create an account

You can sign up to create a Gaffa account [here](https://accounts.gaffa.dev/sign-up?redirect_url=https%3A%2F%2Fgaffa.dev%2F%2Fauth%2Fsign-in). After signing up, you can use the API to access our [API Playground](https://gaffa.dev/dashboard/playground), which includes several prebuilt automations for [our demo site](https://demo.gaffa.dev/) that simulate a range of scenarios. 

#### Accessing the open web

When you're ready to use Gaffa on the open web, you'll need to choose a plan that suits your needs and pay for it. After that, the full internet will be available for you to automate.

{% hint style="warning" %}
To avoid scaling issues for our existing customers, we are currently using a queuing system for new accounts. Simply join the queue when prompted on your [account dashboard](https://gaffa.dev/dashboard), and we'll let you know when you have access.\
\
If you want to jump the queue, you can fill out a short survey to help us better understand our users, and we'll approve your account sooner!
{% endhint %}

{% endstep %}

{% step %}

## Making your first browser request

The easiest way to make your first Gaffa [browser request](/docs/features/browser-requests.md) is to use our [API Playground](https://gaffa.dev/dashboard/playground), where you can see several pre-made interactive browser request examples of automations we've built against our test site, which simulates some common scraping and web automation scenarios. You can run these examples without a paid account and edit them easily to experiment. Once you have a paid account, you can also use the playground to build your automations for other sites.

### Gaffa API Playground examples

Here are all the sample requests we've created for use in the API Playground.

<table data-view="cards"><thead><tr><th></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Print to PDF</strong></td><td>Export a web page to PDF and wait for elements to load with the Gaffa API.</td><td><a href="/pages/4EWaTYxnDzf6yEiWI6Nl">/pages/4EWaTYxnDzf6yEiWI6Nl</a></td></tr><tr><td><strong>Convert to Markdown</strong></td><td>Export a web page to markdown format - useful feeding into LLM apps.</td><td><a href="/pages/o8MCLugRiEWB2YhQ2kdJ">/pages/o8MCLugRiEWB2YhQ2kdJ</a></td></tr><tr><td><strong>Infinitely Scroll</strong></td><td>Scroll the bottom of a page that infinitely loads items and record the interaction.</td><td><a href="/pages/56gDIjx6cVSJcra6JXCq">/pages/56gDIjx6cVSJcra6JXCq</a></td></tr><tr><td><strong>Capture Screenshot</strong></td><td>Interact with a page and capture the a screenshot of the whole page.</td><td><a href="/pages/9kjK4DKXNkyUfUmKzFdO">/pages/9kjK4DKXNkyUfUmKzFdO</a></td></tr><tr><td><strong>Form Completion</strong></td><td>Fill out a form in a human-like way and record the interaction</td><td><a href="/pages/29tKwniN6de4eoyj7gQO">/pages/29tKwniN6de4eoyj7gQO</a></td></tr></tbody></table>

{% endstep %}

{% step %}

## Building your own browser requests

Once you have a paid account and are ready to start building your own browser requests, you'll want to read about all the other [actions ](/docs/features/browser-requests/actions.md)you can use for your solution, as well as how you can easily use [proxy servers](/docs/features/browser-requests.md#proxy-servers), [our cache](/docs/features/browser-requests.md#caching), and the [other endpoints that are part of the API](/docs/api-reference/api-authentication.md)
{% endstep %}
{% endstepper %}

## <sup>**Want to build faster with AI assistance?**</sup>

You can use Gaffa's [`llms.txt`](https://gaffa.dev/docs/llms-full.txt) file to give AI assistants like ChatGPT or Claude instant, accurate context about the Gaffa API, so they can generate working code for you straight away, without you having to explain the API yourself. [Learn how to use the Gaffa LLMs.txt file →](broken://pages/TM6N5OaBEOPp2EA1LBbI)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://gaffa.dev/docs/get-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.