Nexscope
Start free

Etsy Product Detail API

REST API and MCP service documentation generated from server-side API definitions. Responses shown here are the direct payload returned by each API execution.

API selector
Etsy Marketplace

API overview

Retrieve public Etsy listing details from a validated marketplace URL for product, pricing, shop, and competitive research workflows.

Try this API
Endpoint
https://api.nexscope.ai/api/skill-api/v1/skills/etsy-product-detail/run
MCP method
nexscope_etsy_product_detail

Authentication

All run endpoints require a user API key. Send it as a bearer token in the Authorization header.

Authorization: Bearer nk_xxxxxxxxxxxxxxxxx
Missing or invalid API keys return an authentication error. Manage keys from .
POSThttps://api.nexscope.ai/api/skill-api/v1/skills/etsy-product-detail/run

Run an API

Send a JSON request body using the parameters described below.

Slugetsy-product-detail
HeadersAuthorization: Bearer nk_...
Content-Type: application/json
Request bodyAPI-specific JSON object.
Response bodyDirect API response payload. No data/result wrapper is added.

Status codes

CodeDescription
200API executed successfully. Body is the direct response payload.
400Request JSON or required API parameters are invalid.
401API key is missing, invalid, or cannot be matched to a user.
5xxAPI execution or upstream service failed.

Example request

curl -X POST https://api.nexscope.ai/api/skill-api/v1/skills/etsy-product-detail/run \
  -H "Authorization: Bearer nk_xxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{   "productUrl": "https://www.etsy.com/listing/1710567856/its-okay-to-make-some-mistakes-shirt" }'
All categories/ Etsy Marketplace
POSThttps://api.nexscope.ai/api/skill-api/v1/skills/etsy-product-detail/run

Run this API

Send a JSON request to execute this API and receive the direct response payload.

Open tester

Endpoint

MethodPOST
Pathhttps://api.nexscope.ai/api/skill-api/v1/skills/etsy-product-detail/run
AuthBearer API key
Content-Typeapplication/json

Request body

NameTypeRequiredDescription
productUrlstringrequired
HTTPS Etsy listing URL containing a numeric listing ID
Example: https://www.etsy.com/listing/1710567856/its-okay-to-make-some-mistakes-shirt

Request example

{
  "productUrl": "https://www.etsy.com/listing/1710567856/its-okay-to-make-some-mistakes-shirt"
}

Response body

No required request fields are defined for this API.

Response example

Direct response payload. No extra wrapper is added.

{
  "product": {
    "title": "Example Etsy product",
    "price": 1,
    "productId": "1710567856",
    "currency": "EUR",
    "images": []
  }
}

Responses

CodeDescription
200API executed successfully. Body is the direct response payload.
400Request JSON or required API parameters are invalid.
401API key is missing, invalid, or cannot be matched to a user.
5xxAPI execution or upstream service failed.

Data source, freshness, and limitations

Source, freshness, coverage, rate limits, and estimation notes are not specified in this API definition unless they appear in the request or response field documentation above. Do not assume official marketplace data or real-time freshness when it is not explicitly documented.

Related APIs

Etsy Category Search API

Find Etsy category IDs by category name, ID, or parent ID for product and store filtering. Review request and response fields.

Etsy Product Query API

Filter Etsy products by keyword, URL, price, sales, favorites, reviews, listing date, category, product type, and marketplace badges.

Etsy Store Query API

Search Etsy stores by keyword, category, country, status, ratings, sales, favorites, reviews, and opening date with pagination and sorting.

MCP

Use the MCP endpoint when an agent needs to discover and call API tools with JSON-RPC.

GET /api/skill-api/v1/mcp
POST /api/skill-api/v1/mcp
Authorization: Bearer nk_xxxxxxxxxxxxxxxxx
Content-Type: application/json

Call a tool

{
  "jsonrpc": "2.0",
  "id": "tool-call-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_etsy_product_detail",
    "arguments": {
      "productUrl": "https://www.etsy.com/listing/1710567856/its-okay-to-make-some-mistakes-shirt"
    }
  }
}

Online test

Execute the current API with your API key and JSON payload.

Try it

Send a real request with the same contract shown in the reference.

Endpoint
https://api.nexscope.ai/api/skill-api/v1/skills/etsy-product-detail/run
MCP method
nexscope_etsy_product_detail
cURL
curl -X POST \
  https://api.nexscope.ai/api/skill-api/v1/skills/etsy-product-detail/run \
  -H "Authorization: Bearer nk-..." \
  -H "Content-Type: application/json" \
  -d '{ "productUrl": "https://www.etsy.com/listing/1710567856/its-okay-to-make-some-mistakes-shirt" }'
Response
No response yet. Run the request to see the response here.