Etsy Product Research

Etsy Category Search

Find Etsy category IDs by category name, ID, or parent ID for product and store filtering. Call via REST API or MCP from 10 credits per call.

MCP tool name

nexscope_etsy_category_search

MCP endpoint

https://api.nexscope.ai/mcp

JSON-RPC method

tools/call

Authentication

Use OAuth 2.1 Authorization Code with PKCE and the mcp:tools scope. API keys remain supported as a compatibility option.

Authorization: Bearer nk-xxxxxxxxxxxxxxxxx

If authentication fails, ask the user to open API Access and copy a valid key.

Call this MCP tool

Initialize an MCP 2025-11-25 Streamable HTTP session at https://api.nexscope.ai/mcp, then use tools/call.

{
  "jsonrpc": "2.0",
  "id": "etsy-category-search-1",
  "method": "tools/call",
  "params": {
    "name": "nexscope_etsy_category_search",
    "arguments": {
      "keyword": "phone case",
      "page": 1,
      "pageSize": 1
    }
  }
}

MCP 2025-11-25 · Streamable HTTP

Progress is delivered on the original POST SSE response. GET SSE carries notifications; reconnecting must query existing asynchronous work rather than submit again.

Arguments

Name	Type	Required	Description
`keyword`	`string`	required	Keyword, at most 200 characters; matches category name, category ID, or parentIds by substring Example: phone case
`page`	`integer`	optional	Page number, starting from 1; defaults to 1 Example: 1
`pageSize`	`integer`	optional	Items per page, from 1 to 200; defaults to 50 Example: 50

Response fields

Treat structuredContent as the programmatic API response payload.

Name	Type	Required	Description
`total`	`integer`	optional	Number of items returned on this page Example: {}
`costToken`	`integer`	optional	Consume tokens (local retrieval is not billed) Example: {}
`categories`	`array`	optional	Matching category list Example: {}
`title`	`string`	optional	Title Example: {}
`categoryLevel`	`integer`	optional	Category level Example: {}
`id`	`string`	optional	category id Example: {}
`name`	`string`	optional	Category name Example: {}
`parentId`	`string`	optional	Canonical main parent category id Example: {}
`parentIds`	`string`	optional	All non-empty parent category ids (comma separated) Example: {}

Examples

Example arguments

{
  "keyword": "phone case",
  "page": 1,
  "pageSize": 1
}

Example structuredContent

{}