Extract Orders (Etsy)

Extracts the shipping address (shippingAddress) from Etsy order documents uploaded as base64-encoded content. No request is made to the Etsy API — the address is parsed entirely from the document you provide.

This is the recommended solution when Etsy restricts third-party shipping access to buyer addresses, as the address is still present in the downloadable PDF receipts and CSV order exports.

Supported formats

  • pdf — An Etsy order receipt or label. The parser looks for the "Ship to" block in English first, then falls back to "Enviar a" in Spanish. Each PDF produces 1 order.
  • csv — The official Etsy "Orders" export (EtsySoldOrders.csv). Column headers are matched case-insensitively. Each row produces 1 order.

CSV column mapping

CSV columnMapped field
Order IDid, number
Full Name (or First Name + Last Name)shippingAddress.firstName
Street 1shippingAddress.address1
Street 2shippingAddress.address2
Ship CityshippingAddress.city
Ship StateshippingAddress.state
Ship ZipcodeshippingAddress.postalCode
Ship CountryshippingAddress.country

Important notes

  • email is extracted from PDF only (format NAME ([email protected]) in the buyer line). CSV exports do not include the buyer email — email will be null.
  • lastName is always null — Etsy provides a single name field, mapped to firstName.
  • Multiple documents can be submitted in a single request. Results are flattened into one orders array in input order.
  • Maximum request body: 20 MB.
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
orders
array of objects
required
length ≥ 1

Array of documents to extract. Minimum 1 item.

orders*
string
required

Full document encoded in base64.

string
enum
required

Document format. Use pdf for Etsy receipts/labels, csv for the EtsySoldOrders.csv export.

Allowed:
Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json