# Bing Search



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Search Bing via API and retrieve structured search results with pagination.

**Credit cost:** 1 credit per request

<APIPage document={"/repo/apps/docs/specs/openapi.json"} operations={[{"path":"/v1/bing/search","method":"post"}]} />


# Brave Search



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Search Brave Search via API and retrieve structured organic results with pagination.

**Credit cost:** 1 credit per request

<APIPage document={"/repo/apps/docs/specs/openapi.json"} operations={[{"path":"/v1/brave/search","method":"post"}]} />


# Credits



Each API call consumes credits from your account balance. The table below lists every endpoint and its cost.

<Callout type="info">
  You are only charged for successful requests (status code `200`). Failed requests do not consume credits.
</Callout>

| Endpoint                                                  | Method | Path                             | Credits |
| --------------------------------------------------------- | ------ | -------------------------------- | ------- |
| [Bing Search](/bing-search)                               | `POST` | `/v1/bing/search`                | 1       |
| [Brave Search](/brave-search)                             | `POST` | `/v1/brave/search`               | 1       |
| [Google Countries](/finder-google-countries)              | `GET`  | `/v1/finder/google-countries`    | —       |
| [Google Images](/google-images)                           | `POST` | `/v1/google/images`              | 1       |
| [Google Jobs](/google-jobs)                               | `POST` | `/v1/google/jobs`                | 1       |
| [Google Languages](/finder-google-languages)              | `GET`  | `/v1/finder/google-languages`    | —       |
| [Google Locations](/finder-google-locations)              | `GET`  | `/v1/finder/google-locations`    | —       |
| [Google Maps](/google-maps)                               | `POST` | `/v1/google/maps`                | 1       |
| [Google News](/google-news)                               | `POST` | `/v1/google/news`                | 1       |
| [Google Search](/google-search)                           | `POST` | `/v1/google/search`              | 1       |
| [Google Search Autocomplete](/google-search-autocomplete) | `POST` | `/v1/google/search/autocomplete` | 1       |
| [Google Search Light](/google-search-light)               | `POST` | `/v1/google/search/light`        | 1       |
| [Google Videos](/google-videos)                           | `POST` | `/v1/google/videos`              | 1       |
| [Usage](/usage)                                           | `GET`  | `/usage`                         | —       |


# Google Countries



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Search Google countries and retrieve country codes (free Finder endpoint).

<APIPage document={"/repo/apps/docs/specs/openapi.json"} operations={[{"path":"/v1/finder/google-countries","method":"get"}]} />


# Google Languages



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Search Google languages and retrieve language codes (free Finder endpoint).

<APIPage document={"/repo/apps/docs/specs/openapi.json"} operations={[{"path":"/v1/finder/google-languages","method":"get"}]} />


# Google Locations



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Find supported Google locations and retrieve location IDs and country codes (free endpoint).

<APIPage document={"/repo/apps/docs/specs/openapi.json"} operations={[{"path":"/v1/finder/google-locations","method":"get"}]} />


# Google Images



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Search Google Images via API and retrieve image results (URLs, titles, sources, dimensions).

**Credit cost:** 1 credit per request

<APIPage document={"/repo/apps/docs/specs/openapi.json"} operations={[{"path":"/v1/google/images","method":"post"}]} />


# Google Jobs



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Scrape Google Jobs results via API and retrieve structured SERP data with pagination.

**Credit cost:** 1 credit per request

<APIPage document={"/repo/apps/docs/specs/openapi.json"} operations={[{"path":"/v1/google/jobs","method":"post"}]} />


# Google Maps



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Search Google Maps via API and retrieve structured place results (address, website, phone).

**Status:** Experimental

**Credit cost:** 1 credit per request

<APIPage document={"/repo/apps/docs/specs/openapi.json"} operations={[{"path":"/v1/google/maps","method":"post"}]} />


# Google News



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Search Google News via API and retrieve structured news results with pagination.

**Credit cost:** 1 credit per request

<APIPage document={"/repo/apps/docs/specs/openapi.json"} operations={[{"path":"/v1/google/news","method":"post"}]} />


# Google Search Autocomplete



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Get Google Search autocomplete suggestions via API for a given query.

**Credit cost:** 1 credit per request

<APIPage document={"/repo/apps/docs/specs/openapi.json"} operations={[{"path":"/v1/google/search/autocomplete","method":"post"}]} />


# Google Search Light



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Ultra-fast Google Search organic results API with lightweight structured SERP data.

**Status:** Experimental

**Credit cost:** 1 credit per request

<APIPage document={"/repo/apps/docs/specs/openapi.json"} operations={[{"path":"/v1/google/search/light","method":"post"}]} />


# Google Search



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Scrape Google Search results via API and retrieve structured SERP data with pagination.

**Credit cost:** 1 credit per request

<APIPage document={"/repo/apps/docs/specs/openapi.json"} operations={[{"path":"/v1/google/search","method":"post"}]} />


# Google Videos



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Search Google Videos via API and retrieve structured video results with metadata.

**Credit cost:** 1 credit per request

<APIPage document={"/repo/apps/docs/specs/openapi.json"} operations={[{"path":"/v1/google/videos","method":"post"}]} />


# Introduction



Get started with the Autom API in minutes. Make HTTP requests to our endpoints and receive structured JSON responses.

Quick Start [#quick-start]

<Steps>
  <Step>
    Get your API key [#get-your-api-key]

    Sign up on your [dashboard](https://app.autom.dev) and copy your API key from the **Settings** page.
  </Step>

  <Step>
    Make your first request [#make-your-first-request]

    Include your key in the `x-api-key` header and call any endpoint:

    ```bash
    curl "https://api.autom.dev/usage" \
      -H "x-api-key: YOUR_API_KEY"
    ```
  </Step>

  <Step>
    Handle the response [#handle-the-response]

    Every successful request returns a JSON object with structured data. See individual endpoint pages for response schemas and examples.
  </Step>
</Steps>

Authentication [#authentication]

All API requests must include an `x-api-key` header. You can find your key in your [dashboard settings](https://app.autom.dev/settings).

```bash
curl -H "x-api-key: xxxx" https://api.autom.dev/v1/usage
```

<Callout type="warn">
  Keep your API key secret. Do not expose it in client-side code or public repositories.
</Callout>

Status Codes [#status-codes]

Billing applies to successful requests: `200` for synchronous calls, `201` for asynchronous jobs, and `404` when the resource is not found (unless specified otherwise in the API documentation).

| Code  | Billed | Status              | Action                                                                                |
| ----- | ------ | ------------------- | ------------------------------------------------------------------------------------- |
| `200` | Yes    | Successful API Call | No action required.                                                                   |
| `201` | Yes    | Job Created         | No action required.                                                                   |
| `202` | No     | Accepted (Async)    | The request was accepted and is being processed. Use the job ID to check the status.  |
| `400` | No     | Bad Request         | Verify your parameters and their types. Check the documentation for more information. |
| `401` | No     | Invalid API Key     | Check your API key (`x-api-key` header or `x_api_key` query string).                  |
| `401` | No     | Inactive API Key    | Activate your API key in the API Keys section of your account settings.               |
| `401` | No     | Expired API Key     | Update your API key or generate a new one.                                            |
| `401` | No     | Rate Limit Exceeded | Consider upgrading your current plan or contact our sales team.                       |
| `402` | No     | Payment Required    | Settle any outstanding invoices to continue using the API.                            |
| `403` | No     | Forbidden           | Verify your permissions. Contact us if you believe this is a mistake.                 |
| `404` | Yes    | Not Found           | Result not found for this request. Some APIs do not bill 404.                         |
| `500` | No     | Internal Error      | Retry the action or contact our support team.                                         |

See the [Credits](/credits) page for a full breakdown of credit costs per endpoint.

Endpoints [#endpoints]

Browse all available endpoints in the sidebar, or jump directly:

<Cards>
  <Card title="Bing Search" href="/bing-search" />

  <Card title="Brave Search" href="/brave-search" />

  <Card title="Google Countries" href="/finder-google-countries" />

  <Card title="Google Images" href="/google-images" />

  <Card title="Google Jobs" href="/google-jobs" />

  <Card title="Google Languages" href="/finder-google-languages" />

  <Card title="Google Locations" href="/finder-google-locations" />

  <Card title="Google Maps" href="/google-maps" />

  <Card title="Google News" href="/google-news" />

  <Card title="Google Search" href="/google-search" />

  <Card title="Google Search Autocomplete" href="/google-search-autocomplete" />

  <Card title="Google Search Light" href="/google-search-light" />

  <Card title="Google Videos" href="/google-videos" />

  <Card title="Usage" href="/usage" />
</Cards>


# Usage



{/* This file was generated by Fumadocs. Do not edit this file directly. Any changes should be made by running the generation command again. */}

Get account usage via API (plan and remaining requests).

<APIPage document={"/repo/apps/docs/specs/openapi.json"} operations={[{"path":"/usage","method":"get"}]} />