# AlsoAsked

> AlsoAsked surfaces the questions people ask Google ("People Also Ask") for any search term, language and region. Programmatic access is provided by the **AlsoAsked API**, a documented, versioned, API-key-authenticated HTTP API hosted on its own domain at `https://alsoaskedapi.com/v1`.

This file helps AI agents and tools integrate with AlsoAsked correctly. If you are writing code, building an integration, or making requests on a user's behalf, use the public AlsoAsked API described below.

How to integrate:

- Base URL (live): `https://alsoaskedapi.com/v1`
- Base URL (sandbox, free for testing): `https://sandbox.alsoaskedapi.com/v1`
- Authenticate every request with an API key in the `X-Api-Key` header. Keys are prefixed `aa-live-` or `aa-sandbox-` and are created under Developers → API keys at https://alsoasked.com/developer/keys. A Pro subscription is required for the live API; the sandbox is free.
- Core endpoints: `GET /account`, `GET /search`, `POST /search`, `GET /search/{searchId}`, `DELETE /search/{searchId}`.
- Searches consume credits (depth 2 costs 1 credit, depth 3 costs 4). Pro accounts can buy pay-as-you-go credits that are used alongside plan credits, so API usage need not stop when monthly credits run out. They can be purchased manually, or set up to top up automatically when the balance falls below a threshold. Check the remaining balance with `GET /account` and manage credits at https://alsoasked.com/credits.

Important - `alsoasked.com` vs `alsoaskedapi.com`:

- `https://alsoaskedapi.com` (and `https://sandbox.alsoaskedapi.com`) is the **public API**. This is the only supported way to access AlsoAsked programmatically, and the only endpoint that accepts `X-Api-Key` API keys.
- `https://alsoasked.com` is the **website and web app** for human visitors. Paths under `https://alsoasked.com/api/*` (for example `https://alsoasked.com/api/v1/search`) are the website's internal backend. They authenticate browser sessions with cookies and CSRF tokens, are undocumented, can change without notice, and do **not** accept API keys. Do not call `https://alsoasked.com/api/*` from integrations, scripts, or agents - use `https://alsoaskedapi.com/v1` instead.

## API

- [Public API documentation](https://developers.alsoasked.com): Full reference and guides - getting started, authentication, searching (synchronous & asynchronous), search history, account details, webhooks, rate limiting and the sandbox.
- [OpenAPI specification](https://github.com/AlsoAsked/also-asked-api-specification/blob/main/openapi/openapi.yaml): Machine-readable OpenAPI 3.1 definition of every endpoint, schema and response.
- [Full reference for LLMs](https://alsoasked.com/llms-full.txt): A self-contained summary of the API (base URLs, authentication, endpoints, request options and examples) in a single file.

## Optional

- [Pricing](https://alsoasked.com/pricing): Plans and credit costs (a Pro subscription is required for the live API).
- [Buy credits](https://alsoasked.com/credits): Purchase pay-as-you-go credits (Pro accounts) that are spent alongside plan credits.
- [Manage API keys](https://alsoasked.com/developer/keys): Create and revoke `X-Api-Key` keys.
- [Manage webhooks](https://alsoasked.com/developer/webhooks): Register endpoints to receive asynchronous search updates.
- [Support](https://help.alsoasked.com): Help centre and contact (help@alsoasked.com).
- [Terms of service](https://alsoasked.com/eula): Acceptable use and licensing.