Just One API
Just One API provides unified access to public social media, creator, entertainment, and ecommerce data across hundreds of metered endpoints.
Verdict
Common use cases
- Compare wholesale prices across 1688 and AliExpress
- Track Amazon best sellers in target categories
- Validate product ideas with marketplace search data
- Pull competitor SKU details for pricing analysis
- Research supplier catalogs during sourcing sprints
Integration
- Vendor
- Just One API
- Category
- other
- Auth
- API_KEY
- Tools
- 50
- Composio slug
just_one_api
Tools
- 1688 Product Details
Retrieves the public product detail for a 1688 wholesale listing by item ID. Use it to review a known offer during product sourcing or catalog research.
- 1688 Product Search
Searches 1688 wholesale product listings by keyword. Use it to discover candidate products or suppliers during sourcing and market research.
- AliExpress Product Details
Retrieves an AliExpress product by item ID with optional currency, region, and locale controls. Use it to inspect a known listing for catalog review, product comparison, or downstream commerce analysis.
- AliExpress Product Search
Searches AliExpress products with optional query, page, sort, category, brand, location, attribute, price, locale, region, and currency controls. Use it for product discovery, catalog research, and marketplace assortment analysis.
- Amazon Best Sellers
Retrieves paginated Amazon Best Sellers for a category path in a selected country marketplace. Use it to study category leaders, discover popular products, or compare bestseller pages across marketplaces.
- Amazon Product Details
Retrieves details for an Amazon product identified by ASIN in a selected country marketplace. Use it to look up a known listing for catalog review, product comparison, or downstream commerce analysis.
- Amazon Products By Category
Retrieves paginated Amazon products for a numeric category node in a selected country marketplace, with configurable result sorting. Use it to browse a category, compare assortments, or collect category-specific product candidates.
- Amazon Product Search
Searches Amazon marketplace products by keyword or ASIN with country, sort, condition, Prime-only, deals, and page controls. Use it to discover products for catalog research, price comparison, or competitive assortment analysis.
- Amazon Product Top Reviews
Retrieves the top reviews for an Amazon product identified by ASIN in a selected country marketplace. Use it to review prominent customer feedback for product research, sentiment analysis, or quality assessment.
- Beike Community List [Deprecated]
Deprecated provider operation retained by explicit owner request. Retrieves Beike residential communities for a city with optional condition filters and offset pagination. Use it to browse housing communities in a selected city.
- Beike Resale Housing Details [Deprecated]
Deprecated provider operation retained by explicit owner request. Retrieves a Beike resale-housing listing by city ID and house code. Use it to inspect a known second-hand property listing in a specific city.
- Beike Resale Housing List [Deprecated]
Deprecated provider operation retained by explicit owner request. Retrieves Beike resale-housing listings for a city with optional condition filters and offset pagination. Use it to browse second-hand properties in a selected market.
- Bilibili Share Link Resolution
Resolve a supported Bilibili short share link that targets a video and return its public redirect URL. Use it to expand video links before subsequent Bilibili content lookup or processing.
- Bilibili User Profile
Retrieves a Bilibili user profile identified by UID. Use it to look up a known account for creator research, profile review, or subsequent retrieval of that user's videos.
- Bilibili User Published Videos
Retrieves videos published by a Bilibili user identified by UID, with an optional continuation parameter from a prior response. Use it to browse a creator's uploads or continue through their video list.
- Bilibili User Relation Stats
Retrieves relation statistics for a Bilibili user identified by WMID. Use it to compare audience relationships across creator accounts or track relation-count changes for a known user.
- Bilibili Video Captions
Retrieves caption data for a Bilibili video segment identified by BVID, AID, and CID. Use it to obtain subtitles for transcript extraction, accessibility review, or language-focused content analysis.
- Bilibili Video Comments
Retrieves comments for a Bilibili video identified by AID, with optional cursor pagination. Use it to review audience discussion, continue through comment pages, or support comment moderation and analysis.
- Bilibili Video Danmaku
Retrieves one page of danmaku comments for a Bilibili video segment identified by AID and CID. Use it to review time-synchronized audience reactions or page through danmaku for a known video.
- Bilibili Video Details
Retrieves details for a Bilibili video identified by its BVID. Use it to look up a known video for content review, cataloging, or subsequent engagement analysis.
- Bilibili Video Search
Searches Bilibili videos by keyword with page-based pagination and sorting by general ranking, play count, publish time, danmaku count, or favorites. Use it to support content discovery, topic research, or ranking-focused searches.
- Dewu (Poizon) Product Search [Deprecated]
Deprecated provider operation retained by explicit owner request. Searches Dewu (Poizon) products by keyword with page-based pagination. Use it to discover marketplace products matching a title or product term.
- Douban Movie Comments
Retrieves paginated Douban short comments for a movie or TV subject, ordered by time or newest rating. Use it to review concise audience feedback for a known subject.
- Douban Movie Movie Reviews
Retrieves paginated Douban long-form reviews for a movie or TV subject, ordered by time or popularity. Use it to browse in-depth audience reviews for a known subject.
- Douban Movie Recent Hot Movie
Retrieves a paginated list of movies currently featured in Douban's recent-hot collection. Use it to discover popular movie titles and continue through result pages.
- Douban Movie Recent Hot Tv
Retrieves a paginated list of TV titles currently featured in Douban's recent-hot collection. Use it to discover popular series and continue through result pages.
- Douban Movie Review Details
Retrieves a single Douban long-form review by its review ID. Use it to inspect a known review after discovering it in a subject's review list.
- Douban Movie Subject Details
Retrieves the public detail page data for a Douban movie or TV subject by subject ID. Use it to inspect a known title before requesting its reviews or comments.
- Douyin Creator Marketplace (Xingtu) Audience Distribution
Returns Douyin Creator Marketplace (Xingtu) audience-distribution data for a creator, content channel, and selected relationship stage. Use it to assess audience fit for campaign targeting.
- Douyin Creator Marketplace (Xingtu) Audience Touchpoint Distribution
Returns Douyin Creator Marketplace (Xingtu) audience-touchpoint distribution data for a specified creator and content channel. Use it to compare audience-contact patterns during campaign research.
- Douyin Creator Marketplace (Xingtu) Comment Keyword Analysis
Returns Douyin Creator Marketplace (Xingtu) comment keyword analysis for a specified creator. Use it to identify recurring audience discussion themes during creator research.
- Douyin Creator Marketplace (Xingtu) Content Keyword Analysis
Returns Douyin Creator Marketplace (Xingtu) content keyword analysis for a specified creator. Use it to identify recurring content themes during creator positioning research.
- Douyin Creator Marketplace (Xingtu) Conversion Analysis
Returns Douyin Creator Marketplace (Xingtu) conversion analysis for a creator, content channel, and 30- or 90-day period. Use it to compare creator conversion performance during commerce campaign planning.
- Douyin Creator Marketplace (Xingtu) Creator Commerce Spread Info
Returns Douyin Creator Marketplace (Xingtu) commerce spread information for a specified creator. Use it to compare creators during commerce campaign planning.
- Douyin E-commerce Item Comments
Retrieves paginated customer comments for a Douyin E-commerce product by item ID. Use it to review product feedback for a known marketplace item.
- Douyin E-commerce Item Details
Retrieves Douyin E-commerce product details, including sales data, by item ID. Use it to inspect a known marketplace item for catalog or product research.
- Douyin E-commerce Product Search
Searches Douyin E-commerce products by keyword with page and search-ID pagination. Use it to discover marketplace products and continue a multi-page search.
- Douyin E-commerce Product SKU Info (V1)
Retrieves SKU information for a Douyin E-commerce product by item ID. Use it to inspect the purchasable variations of a known product during catalog review. Accepts item_id.
- Douyin E-commerce Shop Product List
Retrieves a paginated product list for a Douyin E-commerce shop by shop ID. Use it to browse a known seller's marketplace catalog page by page.
- Douyin (TikTok China) Comment Replies
Retrieves replies to a top-level Douyin (TikTok China) video comment with page-based pagination. Use it to inspect threaded discussions and review feedback under a known comment.
- Douyin (TikTok China) Hot Search
Searches Douyin (TikTok China) content with optional keyword, category, video-type, ranking, pagination, engagement, and creator-follower filters. Use it to support trend discovery and campaign research.
- Douyin (TikTok China) Image Post Search
Searches Douyin (TikTok China) image posts by keyword with search-session pagination. Omit searchId for the first page, then use the search ID from the previous response to continue. Use it for visual-content discovery and topic research.
- Douyin (TikTok China) Share Link Resolution
Resolve a supported Douyin (TikTok China) short share link that targets a video and return its public redirect URL. Use it to expand video links before subsequent Douyin content lookup or processing.
- Douyin (TikTok China) User Profile
Retrieves a Douyin (TikTok China) user profile by secUid. Use it to review a known creator or account before monitoring related content or conducting account research.
- Douyin (TikTok China) User Published Videos (V1)
Retrieves a Douyin user's published videos with cursor pagination and newest or most-popular sorting. This is the provider-recommended version. Accepts sec_uid, max_cursor, sort_type.
- Douyin (TikTok China) User Search
Searches Douyin (TikTok China) users by keyword with page-based pagination and optional account-type filtering. Use it to discover creators, brands, or verified accounts for research.
- Douyin (TikTok China) Video Comments
Retrieves top-level comments for a Douyin (TikTok China) video by aweme ID with page-based pagination. Use it to review audience feedback or analyze discussion around a known video.
- Douyin (TikTok China) Video Details
Retrieves details for a Douyin (TikTok China) video by video ID. Use it to look up a known video before content review, archiving, or related analysis.
- Douyin (TikTok China) Video Search
Searches Douyin (TikTok China) videos by keyword with sort, publish-time, duration, and page filters; later pages require the previous search ID. Use it to support content discovery and trend research.
- Social Media Cross-Platform Search
Searches cached recent content across news, Weibo, WeChat, Zhihu, Douyin, Xiaohongshu, Bilibili, and Kuaishou with source and time filters. Use it for broad topic monitoring; uncommon-keyword results may be incomplete.
Setup
Setup guide
- 11. Open your Switchy workspace and navigate to Settings > Integrations > Model Context Protocol. 2. Click 'Add MCP Server' and select 'Just One API' from the directory. 3. Visit the Just One API dashboard, sign in or create an account, and generate a new API key under Account > API Keys. 4. Paste the key into Switchy's configuration modal and click 'Connect'. 5. Switchy will validate the key and confirm which marketplaces your plan supports. 6. Create or open a Project, type '@Just One API search Amazon for wireless earbuds under $50', and send the message. 7. The MCP will return a structured list of matching products with prices, ratings, and ASINs. 8. To retrieve full details for a specific listing, follow up with '@Just One API get Amazon product details for ASIN B08XYZ1234'.
What teammates see: by default, memories from Just One API are scoped to the Project (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Projects have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
Find Trending Kitchen Products
@Just One API retrieve the top 20 Amazon best sellers in the Kitchen & Dining category for the US marketplace
Compare Wholesale Suppliers
@Just One API search 1688 for 'silicone phone case' and show the top 10 results with supplier details and pricing
Audit Competitor Pricing
@Just One API get Amazon product details for ASIN B09XYZ5678 in the US marketplace including price history if available
Scout AliExpress Alternatives
@Just One API search AliExpress for 'bluetooth speaker' with a max price of $30 and minimum 4-star rating, sorted by orders
Browse Category Assortments
@Just One API retrieve products from Amazon category node 123456 in the UK marketplace, sorted by newest arrivals
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@justonapi search Amazon for 'wireless headphones under $50' in the US marketplace and show me the top 5 results with prices and ratings
Found 5 wireless headphone listings under $50 on Amazon US. The top result is the Anker Soundcore Q20 at $39.99 (4.5★, 47,203 reviews), followed by JBL Tune 510BT at $29.95 (4.4★, 18,567 reviews), and Skullcandy Dime 2 at $24.99 (4.3★, 9,841 reviews). Two additional models from TOZO and Sony round out the list, all priced between $25–$48. Each entry includes ASIN, current price, Prime eligibility, and review count. This snapshot reflects live marketplace data as of the query timestamp.
This example demonstrates the MCP's product-search capability across a major marketplace. Requires a valid API key with search quota. Results reflect real-time inventory and pricing, which can shift hourly. Use this for competitive research or catalog discovery, not for transactional decisions without a second verification step.
@justonapi pull the full product details for ASIN B08C4KWM9T on Amazon UK, including description, images, specifications, and current seller info
Retrieved details for ASIN B08C4KWM9T (Amazon UK). Product: Echo Dot (4th Gen) Smart Speaker with Alexa, Charcoal. Current price: £34.99, Prime-eligible. Description highlights voice control, music streaming, and smart-home integration. Package includes 5 product images (front, side, in-use shots) and a spec table covering dimensions (100mm diameter), connectivity (Wi-Fi 802.11a/b/g/n/ac), and power (15W adapter). Seller: Amazon EU S.à.r.l. This is an illustrative summary; actual API response includes additional fields like category breadcrumbs, variant ASINs, and review statistics.
Showcases the detail-fetch tool for a known ASIN. Useful when you already have a product identifier and need full metadata for catalog enrichment or comparison. Requires country-specific marketplace selection (UK, US, DE, etc.). Note that pricing and availability are point-in-time snapshots; always verify before making purchasing or inventory decisions.
@justonapi compare the top 3 best-sellers in the 'Laptop Computers' category on Amazon US and summarize key specs, price ranges, and review sentiment for each
The top 3 Amazon US best-sellers in Laptop Computers are: (1) Apple MacBook Air M2 at $1,049 (4.7★, 12,400 reviews) — praised for battery life and display, occasional complaints about port selection; (2) HP 15.6" Laptop at $479 (4.3★, 8,200 reviews) — budget favorite, mixed feedback on build quality; (3) Lenovo IdeaPad 3 at $399 (4.2★, 5,600 reviews) — entry-level workhorse, reviews cite value but note slower performance under load. Price range spans $399–$1,049. This synthesis pairs the Best Sellers API call with AI-driven sentiment extraction from review counts and ratings.
Combines the Best Sellers retrieval tool with AI reasoning to deliver a comparative summary. Demonstrates how the MCP can feed structured e-commerce data into a higher-level analysis workflow. Be aware that best-seller rankings update frequently, and review sentiment is inferred from aggregate scores, not full text scraping. Ideal for market research or category trend analysis.
Use-case deep-dives
When Just One API replaces three vendor tabs for product sourcing
A two-person e-commerce team sources products from 1688, AliExpress, and Amazon each week to refresh their Shopify catalog. Instead of juggling three browser tabs and copy-pasting ASINs into spreadsheets, they pipe all three marketplaces through a single Switchy thread. One prompt—'find wireless earbuds under $15 on 1688 and AliExpress, then check if the top result is already sold on Amazon'—runs searches across all three platforms and returns structured comparisons in seconds. The API key setup takes five minutes. This MCP wins when your sourcing workflow spans multiple Chinese and Western marketplaces and you need to cross-reference listings faster than manual tab-switching allows. If you only source from one marketplace, the native site is still faster.
How a solo founder tracks competitor catalogs without a VA
A bootstrapped SaaS founder sells print-on-demand home goods and needs to monitor how competitors price similar items on Amazon each month. She used to pay a virtual assistant $200/month to manually compile pricing sheets. Now she schedules a monthly Switchy prompt that pulls Amazon Best Sellers for her three target categories, fetches product details for the top twenty ASINs in each, and exports a CSV with title, price, rating, and review count. The entire run takes under two minutes and costs pennies in API calls. Just One API makes sense here because Amazon's own API requires a selling account and complex approval; this MCP needs only an API key. If you're tracking more than 500 products daily, budget for higher API costs or consider a dedicated scraping service.
When 50 tools beat a consultant for international market scans
A four-person product team at a consumer electronics brand is evaluating whether to launch a new Bluetooth speaker in Germany and Japan. They need to understand local bestseller trends, pricing bands, and competitive density on Amazon.de and Amazon.co.jp without hiring a market research firm. In one Switchy session, they run parallel Best Sellers queries for the audio category in both countries, pull product details for the top fifty in each, and compare average prices, review volumes, and feature keywords. The 50-tool breadth of Just One API means they can also cross-check AliExpress to see if cheaper alternatives are flooding those markets. This approach works when you need a fast, directional read on two to four markets. For a full go-to-market plan with demand forecasting, you still need a consultant—but this MCP gets you 80% of the landscape view in an afternoon.
Frequently asked
What does the Just One API MCP do in Switchy?
It gives your team read access to product data from Amazon, AliExpress, 1688, and other e-commerce platforms through a single connection. You can search listings, pull product details by ID, check best-seller ranks, and browse categories without juggling separate vendor APIs. Useful for sourcing, competitive research, and catalog work.
Do I need an API key from Just One API to use this MCP?
Yes. You'll need to sign up at Just One API, generate an API key from your account dashboard, and paste it into Switchy when you connect the MCP. The key authenticates every request your team makes, so keep it in a secure workspace and rotate it if anyone leaves.
Can this MCP place orders or update product listings?
No. All 50 tools are read-only—search, retrieve details, list best sellers, browse categories. If you need to create listings, manage inventory, or process orders, you'll have to use each platform's seller dashboard or a dedicated order-management API. This MCP is for research and data collection only.
How is this different from scraping e-commerce sites directly?
Just One API normalizes data across platforms and handles rate limits, so you get structured JSON instead of raw HTML. You also stay compliant with each marketplace's terms of service. Scraping is brittle, often violates ToS, and breaks when a site redesigns. This MCP is slower to update but far more reliable.
Who on the team should connect this MCP?
Whoever owns product research or competitive intelligence. They'll need the Just One API key and should understand which marketplaces and categories matter to your business. Once connected, any Switchy member can run searches and pull product data without needing their own API account.