# Get your Etsy Stats and Etsy Ads results through an API

> Read Visits, Orders, Revenue and traffic sources from Stats, per-listing Etsy Ads results and open Help requests from Shop Manager with one API call each. A workflow can email you the week's Stats every Monday and flag new Help requests each morning.

Page: https://fous.com/automate/etsy-shop-manager
Updated: 2026-11-12

Works with your own Etsy Shop Manager account. Fous is an independent product.

## What you can build on Etsy

### Get shop Stats

Reads the metrics overview and How shoppers found you on the Stats page in Shop Manager for the time period you choose.

- Takes: Time period
- Returns: Visits, orders, revenue, average order value, conversion rate, visits per traffic source

### Get Etsy Ads results per listing

Reads Manage Advertised Listings on the Etsy Ads page: the stats next to each advertised listing for the time period you choose.

- Takes: Time period
- Returns: Listing, ad views, ad clicks, click rate, orders from ads, revenue from ads, budget spent, ROAS

### List open Help requests and Cases

Reads the messages labeled Help requests in Messages and the open cases on the Cases page in Shop Manager.

- Takes: Nothing
- Returns: Type, buyer, order number, received date, case reason, latest message

### Set the Etsy Ads daily budget

Changes the daily budget on the Etsy Ads page in Shop Manager and returns the budget and the maximum daily budget shown there.

- Takes: Daily budget
- Returns: Daily budget, maximum daily budget, currency

## Automate Etsy with a workflow

A [workflow](/product/workflows) runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

### Weekly shop Stats and Etsy Ads report

Starts: Every Monday at 8:00 UTC

1. Get shop Stats for the last 7 days, with visits per traffic source.
2. Get Etsy Ads results per listing for the same 7 days.
3. An AI step summarizes the week's Visits, Orders and Revenue and names the listings that spent budget without orders from ads.
4. Email you the summary with both tables.

### New Help requests and Cases, every morning

Starts: Every day at 7:00

1. List open Help requests and Cases in Shop Manager.
2. Keep the ones that were not there on the last run.
3. Post each one, with buyer, order number and case reason, to your support team's webhook.

### Advertised listings spending without orders

Starts: Every weekday at 9:00

1. Get Etsy Ads results per listing for the last 30 days.
2. Keep the listings with budget spent and no orders from ads, and stop when there are none.
3. Email you the list with ad views, ad clicks and budget spent.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

## Once built, one call from your code

Once you have built a [method](/product/methods), it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get shop Stats” would look like.

Example request:

```
curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "etsy.com/get_shop_stats",
    "input": {
      "time_period": "Last 7 days"
    }
  }'
```

Example response:

```
{
  "status": "completed",
  "data": {
    "time_period": "Last 7 days",
    "currency": "USD",
    "visits": 1842,
    "orders": 37,
    "revenue": 1296.5,
    "average_order_value": 35.04,
    "conversion_rate": 2,
    "traffic_sources": [
      {
        "source": "Etsy search",
        "visits": 921
      }
    ],
    "last_refreshed": "2026-11-12T06:40:00Z"
  }
}
```

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

## Etsy’s own options

Etsy's Open API v3 covers listings, receipts (orders), shipping, payments and the payment ledger, reviews and shop policies. It has no sections for Stats, Etsy Ads, Messages or Cases. A Seller App key for your own shop is approved within minutes for eligible sellers; Personal Apps get a deeper review and Commercial Access a manual one. Shop Manager also exports orders and listings as CSV.

| Option | What it covers | What it takes |
| --- | --- | --- |
| Open API v3 | Listings and inventory, receipts and their transactions, shipping profiles, payments, ledger entries, reviews and shop policies. | An app key from Your Apps. A Seller App is for your own shop only; a Personal App gets a deeper review, Commercial Access a manual one. |
| Download Data (CSV) | Order items, orders, Etsy Payments sales and deposits by month or year, and currently for sale listings. | Shop Manager, Settings, Options, Download Data tab. One CSV type and period at a time. |
| Shop Manager by hand | Stats with traffic sources, the Etsy Ads page, Messages with Help requests, and Cases. | Your Etsy account, with 2 factor authentication required for new shops. |

Read on November 12, 2026: [Etsy Open API v3 documentation](https://developers.etsy.com/documentation/), [Etsy Open API v3 reference](https://developers.etsy.com/documentation/reference/), [How to Download a Spreadsheet of Your Sold Transactions](https://help.etsy.com/hc/en-us/articles/360000343328-How-to-Download-a-Spreadsheet-of-Your-Sold-Transactions).

## Signing in to Etsy

Shop Manager signs you in to your Etsy account with a password. 2 factor authentication is required for new shops and optional for existing sellers, with a code from an authenticator app or by call or text, asked on a new browser or device and every 30 days. With Fous you sign in once through Etsy's own sign-in with your own account, and the login is sealed with AES-256.

## Worth knowing

- **Visits settle after the day ends**: Visits refresh a few times a day, and bot traffic is filtered again at the end of the day, which can lower the count. Hourly stats for today, yesterday and the past two days use your time zone; longer periods use UTC.
- **48 hours to resolve a Help request**: A buyer must message you before opening a case. Help requests are labeled in Messages, and you have 48 hours to resolve one before the buyer can open a case.
- **The daily budget has a ceiling Etsy sets**: Every seller starts with a maximum daily budget of $25, recalculated weekly from the last 7 days of ad spend. A new shop waits 15 days before it can start Etsy Ads.
- **Ads clicks and Stats visits differ**: Two ad clicks within 30 minutes count as one visit in Stats, and Etsy Ads visits in Stats leave out the Etsy app. Budget spent appears on your Payment account the following day.

## More in E-commerce: marketplaces and app stores

- [千牛卖家中心](https://fous.com/automate/qianniu-seller-center.md)
- [Meesho Supplier Panel](https://fous.com/automate/meesho-supplier-panel.md)
- [Shopee Seller Centre](https://fous.com/automate/shopee-seller-centre.md)
- [Walmart Seller Center](https://fous.com/automate/walmart-seller-center.md)
- [楽天市場 RMS](https://fous.com/automate/rakuten-rms.md)
- [PayPal Business](https://fous.com/automate/paypal-business.md)
- [TikTok Shop Seller Center](https://fous.com/automate/tiktok-shop-seller-center.md)

Other industries: [Naviance](/automate/naviance), [Ameren online account](/automate/ameren-online-account), [Provi](/automate/provi), [Q2 business online banking](/automate/q2-business-online-banking), [CareCredit Provider Center](/automate/carecredit-provider-center), [Cổng thông tin hóa đơn điện tử](/automate/hoadondientu).

## Frequently asked questions

### Does Etsy Shop Manager have an API?

Partly. Etsy's Open API v3 covers listings, receipts, shipping, payments, the ledger, reviews and shop policies, with a Seller App key for your own shop. It has no sections for Stats, Etsy Ads, Messages or Cases, which stay in Shop Manager. Orders and listings also export as CSV from the Download Data tab.

### Can I get my Etsy traffic sources by API?

Not from the Open API, whose reference has no Stats section. Traffic sources are under How shoppers found you on the Stats page in Shop Manager. With Fous you can build a method that reads them for a time period and returns JSON.

### How far back do Etsy shop Stats go?

To November 2017. You choose the time period at the top of the Stats page, and with a shop open for more than a year you can compare with the previous period. Hourly stats for the last two days use your time zone, everything else UTC.

### What do the Etsy Ads stats include?

Ad views, ad clicks, click rate, orders from ads, revenue from ads, budget spent, ROAS and search terms, shown next to each listing in Manage Advertised Listings. Orders count as from ads when the buyer bought within 30 days of interacting with an ad.

### Is Fous affiliated with Etsy?

No. Fous is an independent product. You use it with your own Etsy account, and a method reads and does only what that account can.

Fous is an independent product: it is not affiliated with, endorsed by or sponsored by the operator of Etsy Shop Manager (Etsy). The name is used only to say which system this page is about. Something here wrong or out of date? Write to legal@fous.com.