Nexscope MCP server

Nexscope Ecommerce API

Connect ecommerce workflows to marketplace data, product research, and AI image and video creation through Nexscope APIs.

225 APIs · 172 Data APIs · 53 Creative APIs · 20 categories

Get an API key · Official API docs · Complete catalog · Integration guide

This repository includes documentation for every API in the official directory, request/response definitions, editable request samples, and cURL, JavaScript, and Python clients. Use it to connect marketplace research, sourcing, keyword analysis, product imagery, and video creation to your application.

Quick start

1. Get and configure your API key

Open API Access, sign in, and create or copy your user API key. Send it in the Authorization header as a bearer token.

Creative API access requires an active subscription. Trial credits do not enable Creative API key access. Review your account access and current plans before submitting generation requests.

Keep the key on your server. Do not commit it or expose it in a browser application. In Bash or Zsh, enter it without displaying it or putting its value into shell history:

printf 'Nexscope API key: '
read -r -s NEXSCOPE_API_KEY
printf '\n'
export NEXSCOPE_API_KEY

All run requests use:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

2. Make your first Data API request

This example calls Amazon Search API for phone case results. It sends a real API request when you execute it with your key.

curl --silent --show-error --fail-with-body --max-time 120 \
  -X POST 'https://api.nexscope.ai/api/skill-api/v1/skills/amazon-search/run' \
  -H "Authorization: Bearer $NEXSCOPE_API_KEY" \
  -H 'Content-Type: application/json' \
  -d '{"keyword":"phone case","page":1}'

Response shapes vary by API; follow its current official reference. For Amazon Product Detail, check code === 0 and read business fields from data (for example, data.products and data.total); data may be null. The Amazon Search fixture below retains the original snapshot shape and should be verified against its current reference before integration. Documented response fixture.

3. Use JavaScript, Python, or reusable cURL commands

Clone this repository and run commands from its root. The examples require Node.js 22+, Python 3.10+, or cURL 7.76+; the cURL helper also uses Python 3.10+ to look up and check the request. JavaScript and Python use only standard libraries.

git clone https://github.com/nexscope-ai/nexscope-ecommerce-api.git
cd nexscope-ecommerce-api

# Choose ONE client to submit a request:
node examples/javascript/run.mjs amazon-search payloads/amazon-search.json
# Alternatively:
python3 examples/python/run.py amazon-search payloads/amazon-search.json
# Alternatively:
bash examples/curl/run.sh amazon-search payloads/amazon-search.json

Each command above independently submits a request. To inspect the method, endpoint, and JSON without sending or using credits:

python3 examples/python/run.py amazon-search payloads/amazon-search.json --dry-run
node examples/javascript/run.mjs amazon-search payloads/amazon-search.json --dry-run

JavaScript source · Python source · cURL source

4. Call a Creative API and retrieve its result

All 53 Creative APIs in this snapshot use asynchronous tasks. This example uses Background Remover API.

Shortened. The full README is on GitHub.