Why SignalCart?  ·  8 Use Cases  ·  Quick Start  ·  Trend Velocity Engine  ·  28 APIs  ·  AI Agents  ·  Build vs. Buy

---

Why SignalCart.io?

• Four Platforms, One Unified Schema: Query Amazon, TikTok Shop US, Instagram, and YouTube using identical field conventions, pagination cursors, and error semantics.
• Pre-Computed Velocity Trends on Every Record: Every product, SKU, seller, shop, creator, post, Reel, Short, and audio track includes a trend block (growth_pct, velocity, acceleration, score, and stage: emerging, rising, peaking, declining) computed from 90 days of hourly and daily snapshots at $0 extra cost.
• Zero Scraper or Proxy Maintenance: We handle residential proxy rotation, anti-bot unblocking, DOM layout shifts, and automatic retries.
• Pay Strictly for Delivered Records: Failed requests and test calls are never billed. Start with 1,000 free records every month (no credit card required).
• 100% Public Data Compliance: Only publicly visible product, storefront, and social content is collected — never login-walled private accounts or buyer PII.

Important

Authentication Required (https://app.signalcart.io/login) Live API queries, full JSON datasets, and interactive Playground requests require an active SignalCart.io account.

• Existing Users: Log in to SignalCart Console (app.signalcart.io/login) to copy your SIGNALCART_KEY or test endpoints in the Playground.
• New Users: Create a Free Account (app.signalcart.io/signup) — includes 1,000 free records/month with no credit card required.

---

1. Explore the 8 E-Commerce & Social Data Use Cases

Each cookbook directory under use-cases/ contains a technical SEO guide, truncated schema preview, and runnable Python (.py) and Node.js (.mjs) scripts. Running any script or inspecting full live payloads requires logging in at https://app.signalcart.io/login.

#	Use Case	Target Platforms	Primary Endpoints Used	Guide & Starter Code	Live Playground (Login Required)
01	Price Monitoring & Buy Box Tracking	Amazon, TikTok Shop	/v1/amazon/product-lookup, /v1/tiktok-shop/product-skus, /v1/tiktok-shop/product-detail	View Guide & Code	Log In to Run Live
02	Product Research & Winning Products	TikTok Shop, Amazon, Instagram, YouTube	/v1/tiktok-shop/top-products, /v1/tiktok-shop/products-search, /v1/amazon/products-search	View Guide & Code	Log In to Run Live
03	Competitor Storefront & Catalog Tracking	Amazon, TikTok Shop, Instagram, YouTube	/v1/amazon/seller-profile, /v1/tiktok-shop/shop-profile, /v1/tiktok-shop/shop-products	View Guide & Code	Log In to Run Live
04	Customer Review & Sentiment Analysis	YouTube, Amazon, TikTok Shop	/v1/youtube/video-comments, /v1/youtube/video-detail	View Guide & Code	Log In to Run Live
05	Influencer & Affiliate Creator Marketing	TikTok Shop, Instagram, YouTube	/v1/tiktok-shop/top-creators, /v1/tiktok-shop/creator-profile, /v1/tiktok-shop/creator-videos	View Guide & Code	Log In to Run Live
06	Early Trend Discovery (Emerging Radar)	TikTok Shop, Instagram, YouTube	/v1/tiktok-shop/top-products, /v1/instagram/reels, /v1/youtube/shorts-audio, /v1/youtube/trending	View Guide & Code	Log In to Run Live
07	Shoppable Video & Ad Intelligence	TikTok Shop, Instagram	/v1/tiktok-shop/product-videos, /v1/instagram/brand-collabs	View Guide & Code	Log In to Run Live
08	Multi-Marketplace Catalog Enrichment	Amazon, TikTok Shop	/v1/amazon/product-detail, /v1/amazon/product-lookup, /v1/tiktok-shop/product-detail	View Guide & Code	Log In to Run Live

---

2. Quick Start in 60 Seconds

Log in at app.signalcart.io/login (or sign up free) to obtain your SIGNALCART_KEY, then query any of the 28 endpoints:

import os, requests

res = requests.get(
    "https://api.signalcart.io/v1/tiktok-shop/top-products",
    headers={"Authorization": f"Bearer {os.environ['SIGNALCART_KEY']}"},
    params={"category": "mens-tops", "window": "7d", "stage": "emerging,rising", "min_score": 80},
)
for product in res.json()["data"]["results"]:
    print(product["title"], product["trend"]["stage"], product["trend"]["growth_pct"])

Node.js / TypeScript / cURL / Go / CLI Cookbook Runner

Node.js / TypeScript (ESM)

const params = new URLSearchParams({
  category: 'mens-tops',
  window: '7d',
  stage: 'emerging,rising',
  min_score: '80',
});

const res = await fetch(`https://api.signalcart.io/v1/tiktok-shop/top-products?${params}`, {
  headers: { Authorization: `Bearer ${process.env.SIGNALCART_KEY}` },
});
const { data } = await res.json();
console.log(data.results);

cURL

curl -G https://api.signalcart.io/v1/tiktok-shop/top-products \
  -H "Authorization: Bearer $SIGNALCART_KEY" \
  -d category=mens-tops \
  -d window=7d \
  -d stage=emerging,rising \
  -d min_score=80

Go

req, _ := http.NewRequest("GET", "https://api.signalcart.io/v1/amazon/product-lookup?domain=amazon.com&asins=B08N5WRWNW", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("SIGNALCART_KEY"))
resp, err := http.DefaultClient.Do(req)

Clone & Run the Local Cookbook

git clone https://github.com/deviationlab/signalcart.git && cd signalcart
npm run login                              # Opens https://app.signalcart.io/login in your browser
export SIGNALCART_KEY="sc_live_..."        # Paste your key from the SignalCart Dashboard
npm run usecase:02                         # Run Use Case 02 (Winning Product Research)

---

3. Unified Trend Velocity Engine

Every record returned by SignalCart includes a pre-computed trend block comparing the active window (24h, 7d, 30d, or 90d) against the preceding window:

Stage	Velocity Profile	Strategic Action
emerging	Small base, high acceleration (> 1.5x)	Earliest signal. Source inventory, sign affiliate creators, or adopt rising audio before competitors notice.
rising	Sustained growth above category median	Scale phase. Proven buyer conversion with room to capture category rank.
peaking	High volume, flattening acceleration (< 1.0x)	Mature phase. High visibility but intense competition; late for new entrants.
declining	Negative growth vs. previous window	Exit phase. Rotate ad spend and catalog focus toward emerging and rising items.

Read the full mathematical specification in docs/trend-block-specification.md.

---

4. Complete 28-Endpoint API Catalog

One SIGNALCART_KEY authenticates across all 28 endpoints. Filter any ranking/search API with stage=emerging,rising, min_score=80, or sort=trend_score.

Amazon Marketplace APIs (4 Endpoints)

Endpoint	Method & Path	Billing Unit	Primary Use Cases	Interactive Console
Amazon Product Search	GET /v1/amazon/products-search	1 record / result	Product research, Competitor tracking	Try in Playground
Amazon Product Lookup (Bulk 40 ASINs)	GET /v1/amazon/product-lookup	1 record / result	Price monitoring, Catalog enrichment	Try in Playground
Amazon Product Detail	GET /v1/amazon/product-detail	1 record / call	Catalog enrichment, Product research	Try in Playground
Amazon Seller Profile	GET /v1/amazon/seller-profile	1 record / call	Competitor tracking	Try in Playground

TikTok Shop US APIs (11 Endpoints)

Endpoint	Method & Path	Billing Unit	Primary Use Cases	Interactive Console
TikTok Shop Product Search	GET /v1/tiktok-shop/products-search	1 record / result	Product research, Trend discovery	Try in Playground
TikTok Shop Product Detail	GET /v1/tiktok-shop/product-detail	1 record / call	Catalog enrichment, Price monitoring	Try in Playground
TikTok Shop Product SKUs	GET /v1/tiktok-shop/product-skus	1 record / result	Price monitoring, Competitor tracking	Try in Playground
TikTok Shop Top Products	GET /v1/tiktok-shop/top-products	1 record / result	Trend discovery, Product research	Try in Playground
TikTok Shop Profile	GET /v1/tiktok-shop/shop-profile	1 record / call	Competitor tracking	Try in Playground
TikTok Shop Products (Full Catalog)	GET /v1/tiktok-shop/shop-products	1 record / result	Competitor tracking, Catalog enrichment	Try in Playground
TikTok Shop Top Shops	GET /v1/tiktok-shop/top-shops	1 record / result	Competitor tracking, Product research	Try in Playground
TikTok Shop Creator Profile	GET /v1/tiktok-shop/creator-profile	1 record / call	Influencer marketing	Try in Playground
TikTok Shop Creator Videos	GET /v1/tiktok-shop/creator-videos	1 record / result	Influencer marketing	Try in Playground
TikTok Shop Product Videos	GET /v1/tiktok-shop/product-videos	1 record / result	Influencer marketing, Ad intelligence	Try in Playground
TikTok Shop Top Creators	GET /v1/tiktok-shop/top-creators	1 record / result	Influencer marketing, Trend discovery	Try in Playground

Instagram Public Data APIs (6 Endpoints)

Endpoint	Method & Path	Billing Unit	Primary Use Cases	Interactive Console
Instagram Profile	GET /v1/instagram/profile	1 record / call	Influencer marketing, Competitor tracking	Try in Playground
Instagram Profile Posts	GET /v1/instagram/profile-posts	1 record / result	Influencer marketing, Competitor tracking	Try in Playground
Instagram Reels	GET /v1/instagram/reels	1 record / result	Influencer marketing, Trend discovery	Try in Playground
Instagram Post Detail	GET /v1/instagram/post-detail	1 record / call	Influencer marketing, Product research	Try in Playground
Instagram Audio	GET /v1/instagram/audio	1 record / call	Trend discovery, Influencer marketing	Try in Playground
Instagram Brand Collabs	GET /v1/instagram/brand-collabs	1 record / result	Influencer marketing, Ad intelligence	Try in Playground

YouTube & YouTube Shorts APIs (7 Endpoints)

Endpoint	Method & Path	Billing Unit	Primary Use Cases	Interactive Console
YouTube Video Search	GET /v1/youtube/video-search	1 record / result	Product research, Influencer marketing	Try in Playground
YouTube Trending Videos	GET /v1/youtube/trending	1 record / result	Trend discovery	Try in Playground
YouTube Video Detail	GET /v1/youtube/video-detail	1 record / call	Product research, Review & sentiment	Try in Playground
YouTube Channel Profile	GET /v1/youtube/channel-profile	1 record / call	Influencer marketing	Try in Playground
YouTube Channel Videos	GET /v1/youtube/channel-videos	1 record / result	Influencer marketing, Competitor tracking	Try in Playground
YouTube Video Comments	GET /v1/youtube/video-comments	1 record / result	Review & sentiment	Try in Playground
YouTube Shorts Audio	GET /v1/youtube/shorts-audio	1 record / result	Trend discovery, Influencer marketing	Try in Playground

---

5. AI Agents & LLM Tool Calling

SignalCart's deterministic JSON schema and pre-computed trend block make it ideal as a real-time tool for OpenAI Function Calling, Claude Tool Use, LangChain, n8n, and Zapier workflows.

• Machine-Readable LLM Index: See llms.txt for full endpoint definitions formatted for AI coding assistants (Cursor, Windsurf, Claude Code).
• Authenticate Your Agent: Generate an API key at https://app.signalcart.io/login and pass Authorization: Bearer $SIGNALCART_KEY in your agent's HTTP tool configuration.

---

6. Build Scrapers In-House vs. Call SignalCart.io

Dimension	Build Scrapers In-House	SignalCart.io Unified API
Time to First Data	Weeks per marketplace / social source	Minutes (one API key for all 4 platforms)
Site Changes & Anti-Bot Blocks	Your engineering team debugs CAPTCHAs & DOM changes	Managed by SignalCart with automatic retries
Schema Across Platforms	Custom parser per site	One unified schema with consistent field names & pagination
Spotting Rising Trends	Store daily snapshots in a data warehouse for months	Pre-computed trend block (growth_pct, velocity, stage) on every record from day one
Failed Requests	You pay for proxy bandwidth and compute regardless	Never billed — you only pay for successfully delivered records
Compliance	Reviewed per source by your team	Publicly visible data only — no buyer PII, no login-walled scraping

---

7. Documentation & Resources

• Complete 28-Endpoint Reference (docs/api-catalog.md)
• Trend Block & Velocity Scoring Specification (docs/trend-block-specification.md)
• Build vs. Buy TCO Comparison (docs/build-vs-buy-comparison.md)
• Contributing Guide (CONTRIBUTING.md) & Security Policy (SECURITY.md)