API

The API for Etsy sellers

Research any shop, product or keyword on Etsy, then edit, optimize and publish your own listings. One key, plain JSON, on every plan.

Get API key View docs

GETapi.alura.io1 credit

/v1/research/shops/10204022?expand=top_products

Authorization: Bearer alura_sk_••••••••3f9a

CaitlynMinimalist

Etsy

Custom Jewelry & More, Crafted with Love

Sales: 3.9M
Rating: 4.82
Favorites: 540K

2,541 listingsOn Etsy since 2014

200 OKresearch.shop

Quickstart

Your first call in a minute

One base URL and one header. Look up a competitor, then improve one of your own listings, with the same key.

1
Create a key
In Alura, open Settings, then API, and create a key. Workspace owners and admins can make one. It's shown once, so keep it somewhere safe.
2
Make a request
Send the key as a bearer token from your script, sheet or server. Every response is JSON and says how many credits it used.
3
Change a listing
Ask for an optimized title and tags, save the ones you like with PATCH, then publish them to Etsy.

curl -G https://api.alura.io/v1/research/shops/10204022 \
  -H "Authorization: Bearer $ALURA_API_KEY" \
  --data-urlencode "fields=name,country,catalog,reviews,sales"

Response200 OK1 API credit

{
  "object": "research.shop",
  "id": "10204022",
  "name": "CaitlynMinimalist",
  "country": "US",
  "catalog": { "active_listings": 2541, "avg_price_usd": 37.89 },
  "reviews": { "count": 751761, "average": 4.82 },
  "sales": {
    "lifetime": 3853076,
    "est_lifetime_revenue_usd": 145685529,
    "est_monthly_avg": 26539,
    "est_monthly_avg_revenue_usd": 1003462,
    "est_last_month": 14484,
    "est_last_month_revenue_usd": 548815
  },
  "as_of": "2026-10-05T10:48:57Z"
}

What you can build

Your shop, on autopilot

Sellers use the API for the jobs they'd otherwise do by hand every week. Run them from a script, a Google Sheet, n8n, Make or Zapier.

Competitor tracker

Pull your top competitors' monthly sales into Google Sheets every Monday and see who's growing.

GET/research/shops/{id}/history

Keyword report

Check search volume and competition for your 100 most important keywords in one call.

GET/research/keywords?q=…

Product idea feed

Get rising listings in your category sent to Slack, so you spot a trend before it peaks.

GET/research/products/trending

Listing fixer

Find your lowest-scoring listings, let the AI rewrite them, and publish the ones you approve.

GET/workspace/listings
POST/workspace/listings/{id}/optimize

Seasonal updates

Swap in holiday tags and prices across a whole section, then switch them back in January.

PATCH/workspace/listings/{id}
POST/workspace/listings/{id}/publish

Your own dashboard

Put your shop's revenue, orders and views next to your other numbers in Notion or Looker Studio.

GET/workspace/shops/{id}/stats

Endpoints

Research Etsy. Run your shop.

Read-only research on any shop, product or keyword, plus full control of your own listings. Every path starts with /v1.

Research

Your shop

Account

Shops

Find the shops in your niche and see how they sell: lifetime sales, estimated revenue, best sellers and reviews.

EndpointAPI credits

GET/research/shopsSearch shops by niche, sales, rating or country.10 / page
GET/research/shops/{id}A shop's profile and sales, with its top products.1
GET/research/shops/{id}/productsEvery listing in the shop, by sales, price or newest.1 / 25 rows
GET/research/shops/{id}/reviewsReviews, filtered by rating, text, photos or date.1 / 25 rows
GET/research/shops/{id}/historyEstimated sales and revenue, month by month. Growth and up.1
GET/research/lookupPaste an Etsy shop or listing link, get the record.1

Parameters, filters and full responses are in the API reference.

Limits

API credits on every plan

Free included. API credits reset on the 1st of each month and are separate from the AI credits you use in Alura. Optimizing a listing uses AI credits, the same as in the app.

Plan	API credits / mo	Per minRequests / min	AI credits / mo
Free$0 a month	100	30	1,000
Basic$11.99 a month	2,000	60	2,000
Growth$29.99 a month	20,000	120	4,000
Professional$69.99 a month	100,000	300	8,000

What a call costs

10A page of search or trending results
1One shop, product, keyword or history
0Saving, editing, publishing, usage, errors and empty results

Paid plans can spend up to 25% of the month in one day. Every response carries an Alura-Credits-Remaining header.

Compare plans

Also available as MCP

Rather ask than code?

The Alura MCP server runs on this API. Add one URL to Claude, ChatGPT or Cursor, sign in, and ask about Etsy in plain words. It uses the same credits.

https://mcp.alura.io/mcp

Works with