post
https://api.ecartapi.com/api/v2/orders/extract
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 column | Mapped field |
|---|---|
Order ID | id, number |
Full Name (or First Name + Last Name) | shippingAddress.firstName |
Street 1 | shippingAddress.address1 |
Street 2 | shippingAddress.address2 |
Ship City | shippingAddress.city |
Ship State | shippingAddress.state |
Ship Zipcode | shippingAddress.postalCode |
Ship Country | shippingAddress.country |
Important notes
emailis extracted from PDF only (formatNAME ([email protected])in the buyer line). CSV exports do not include the buyer email —emailwill benull.lastNameis alwaysnull— Etsy provides a single name field, mapped tofirstName.- Multiple documents can be submitted in a single request. Results are flattened into one
ordersarray in input order. - Maximum request body: 20 MB.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…