Skip to content

Onboarding Agent

Automatically extracts a merchant's product catalog from their store URL or CSV upload, matches products against the Reach Dog data graph, and generates a personalized market-position profile with gap, pricing, demand, and campaign starter questions.

Endpoint: POST /a2a/catalog-onboard-sync

How It Works

  1. Extract -- Submit a store URL, a base64-encoded CSV, or a text description of your catalog
  2. Match -- Products are matched against the Reach Dog product cluster graph
  3. Profile -- A catalog profile is generated with top categories, market gaps, and starter questions for each agent

Request Format

This endpoint uses plain JSON (not JSON-RPC). Provide one of:

{"url": "https://mystore.com"}
{"csv_base64": "<base64-encoded CSV with title, price, category columns>"}
{"description": "I sell premium kitchen knives and cutting boards"}

Response

Returns a catalog profile with:

  • product_count -- Number of products extracted
  • extraction_method -- How products were extracted (url_scrape, csv_parse, or description)
  • profile -- Market position analysis including top categories, top gaps, and starter questions
  • latency_seconds -- Processing time

Input/Output

  • Input modes: application/json
  • Output modes: application/json