REST API · Beta

Plug2Data API reference

Search 14M+ e-commerce stores programmatically and feed the results into your CRM, data warehouse or sequencer. Free fields are available to any key; carriers and tech stack require an active plan.

Authentication

Create a key in your API keys page, then send it as a Bearer token. Base URL https://plug2data.com/api/v1.

curl https://plug2data.com/api/v1/me \
  -H "Authorization: Bearer p2d_live_xxxxxxxx"

The API is client-only — every request needs a valid key (no anonymous access) — and is rate-limited per account (higher limits on paid plans). Exceeding the limit returns 429.

Search stores

GET /api/v1/stores/search

curl "https://plug2data.com/api/v1/stores/search?platforms=Shopify&country=US&turnoverMin=1000000&shipApp=aftership&pageSize=50" \
  -H "Authorization: Bearer p2d_live_xxxxxxxx"

{
  "data": [
    {
      "domain": "example.com",
      "name": "Example Store",
      "country": "US",
      "turnover": 4200000,
      "monthly_visits": 180000,
      "trustpilot_rating": 4.6,
      "category_group": "Apparel",
      "ships_to": ["United States", "Canada"],
      "carriers": ["UPS", "USPS"],        // entitled accounts only
      "apps_text": "klaviyo aftership …"  // entitled accounts only
    }
  ],
  "page": 0, "pageSize": 50, "total": 1234, "entitled": true
}

Query parameters

platforms	Comma-separated, e.g. Shopify,WooCommerce
country	Country code of presence, e.g. US
category	Category group, e.g. Apparel
turnoverMin / turnoverMax	Estimated yearly revenue band (USD)
visitsMin / visitsMax	Estimated monthly traffic band
shipsTo	Ships-to country, e.g. Germany
shipApp	Shipping/fulfillment app, e.g. aftership, loop returns
app	Any installed app / tech, e.g. klaviyo
ratingMin	Minimum Trustpilot rating
plusOnly	1 = Shopify Plus only
page / pageSize	Pagination (pageSize ≤ 100)

MCP endpoint (for AI agents)

Plug2Data is callable by AI agents (Claude, ChatGPT, etc.) via the Model Context Protocol at https://plug2data.com/api/mcp. Tools: search_stores and get_account. Same key + rate limits as the REST API.

curl https://plug2data.com/api/mcp \
  -H "Authorization: Bearer p2d_live_xxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"search_stores",
                 "arguments":{"platforms":"Shopify","country":"US","turnoverMin":1000000,"pageSize":25}}}'

Roadmap

Bulk enrichment via API (decision-maker contacts), webhooks, and native Salesforce / HubSpot connectors are on the way. Need one now? Create an account and ask via Help.

Get your API key →