# Alura API

> Etsy market research for scripts and AI assistants: other sellers' products and shops, keywords, Alura's sales estimates, and the workspace's saved research. REST at https://api.alura.io/v1 with an API key, and an MCP server at https://mcp.alura.io/mcp.

- OpenAPI 3.1 contract: https://docs.alura.io/openapi.json
- Every page in one file: https://docs.alura.io/llms-full.txt

## Get started

- [Alura API](https://docs.alura.io/index.md): Etsy market research for your scripts and your AI assistant.
- [Quickstart](https://docs.alura.io/quickstart.md): Create an API key and make your first call.
- [Authentication](https://docs.alura.io/authentication.md): API keys for scripts and servers; sign-in connections for AI assistants; and which workspace each one uses.
- [Connect an AI assistant](https://docs.alura.io/connect-ai.md): Add Alura to Claude, Claude Code, ChatGPT or Cursor with its MCP server.

## Concepts

- [API credits](https://docs.alura.io/api-credits.md): Each workspace gets a monthly pool of API credits. Calls that find things cost more than calls about something you named.
- [Lists and paging](https://docs.alura.io/pagination.md): How lists, cursors, totals, fields and expansions work.
- [Freshness and new items](https://docs.alura.io/freshness.md): How old the data is, when Alura refreshes it, and what happens when you ask for something Alura has never seen.
- [Errors](https://docs.alura.io/errors.md): Every error the API returns, what it means and what to do.

## Guides

- [Find products](https://docs.alura.io/guides/find-products.md): Search Etsy products with filters and sorting, page through results, and find products like one you know.
- [Analyze a shop](https://docs.alura.io/guides/analyze-a-shop.md): A shop's sales, best sellers, about section and reviews.
- [Keyword research](https://docs.alura.io/guides/keyword-research.md): Etsy search volume, competition and trend for keywords, what ranks for them, and the keywords behind a product's tags.
- [Bulk lookups](https://docs.alura.io/guides/bulk-lookups.md): Get up to 100 products in one call, and handle the ones Alura doesn't have yet.
- [Look up Etsy links](https://docs.alura.io/guides/look-up-etsy-links.md): Turn an Etsy listing or shop link, or a shop name, into Alura's data.
- [Sales history](https://docs.alura.io/guides/sales-history.md): Estimated sales and revenue for every completed month of a product or shop.
- [Usage and limits](https://docs.alura.io/guides/usage-and-limits.md): Check your API credits, daily ceiling, rate limit and fetch caps, and see where the API credits went.
- [Handling errors](https://docs.alura.io/guides/handling-errors.md): Read problem details, retry what can be retried, and stop on what can't.

## Research features

- [Trending](https://docs.alura.io/features/trending.md): Rising and new products, shops and keywords on Etsy.
- [Saved research](https://docs.alura.io/features/saved-research.md): Folders, lists and saved items: the same saved research as in the Alura app.

## Methodology

- [Methodology](https://docs.alura.io/methodology.md): How Alura estimates the numbers Etsy doesn't publish.
- [Sales estimates](https://docs.alura.io/methodology/sales-estimates.md): How Alura estimates sales and revenue for Etsy products and shops.
- [Sales trend](https://docs.alura.io/methodology/sales-trend.md): How est_trend_3m compares the last three months of estimated sales with the three before.
- [Keyword market](https://docs.alura.io/methodology/keyword-market.md): Why est_avg_monthly_sales on a keyword is null for now.

## Resources

- [Changelog](https://docs.alura.io/changelog.md): What changed in the Alura API and MCP server.
- [Status](https://docs.alura.io/status.md): What works now, what is switched off, and how to report a problem.

## Legal

- [API terms of use](https://docs.alura.io/legal/api-terms.md): The rules for using the Alura API and MCP server: what you may do with the data, what you may not, limits, suspension and security.
- [Privacy policy: API and MCP addendum](https://docs.alura.io/legal/privacy-api.md): What the Alura API, the MCP server and the OAuth service collect, how long we keep it, who receives it, and what goes to your AI client.