buyer-intelligence

Search 500,000+ verified importers and distributors by product category and target country. Returns company profiles + a `coverage` object. When in-database coverage is thin (empty/partial), the response includes an `acquisition` task (task_id) — a background crawl is started automatically (free). Poll it with check_discovery_task until status=completed to get freshly gathered buyers. Contact details are not included — use enrich_buyer_contact to get them.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "Product category (e.g. 'flour', 'stainless steel tableware', 'LED lighting')"
    },
    "country_iso": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code (e.g. MY, ID, KE, AE, GB)"
    },
    "quality_grade": {
      "type": "string",
      "enum": [
        "premium",
        "qualified"
      ],
      "description": "Filter by data quality. 'premium' = verified contact + multi-source evidence."
    },
    "limit": {
      "type": "number",
      "description": "Max results to return (default 20, max 100)"
    }
  },
  "required": [
    "category"
  ]
}

Run 6-layer contact enrichment for a buyer: direct website scraping → proxy retry → BFS contact pages → LLM text extraction → vision screenshot → Serper fallback. Returns email, phone, WhatsApp, decision-maker names. Costs Zhimao Points.

{
  "type": "object",
  "properties": {
    "target_domain": {
      "type": "string",
      "description": "Buyer's website domain (e.g. 'example-importer.com')"
    },
    "target_company_name": {
      "type": "string",
      "description": "Buyer's company name"
    }
  },
  "required": [
    "target_domain"
  ]
}

Deep company intelligence for a buyer: corporate registry verification, customs import records, supply chain mapping, decision-maker profiling, risk flags. Returns 0-100 score with evidence chain.

{
  "type": "object",
  "properties": {
    "target_domain": {
      "type": "string",
      "description": "Buyer's website domain"
    },
    "target_company_name": {
      "type": "string",
      "description": "Buyer's company name"
    },
    "country_iso": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2 country code"
    }
  },
  "required": [
    "target_domain"
  ]
}

Explicitly submit an async batch buyer discovery job for a category + country. Returns a job_id; poll it with check_discovery_task until status=completed. Note: find_buyers already auto-starts a background crawl when coverage is thin, so usually you only need this for a forced/fresh deep crawl.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "Product category to discover buyers for"
    },
    "country_iso": {
      "type": "string",
      "description": "Target country ISO code"
    },
    "keywords": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Additional keywords to refine the search"
    }
  },
  "required": [
    "category",
    "country_iso"
  ]
}

Poll a background buyer-discovery task created by find_buyers (acquisition.task_id) or submit_discovery_job. Returns status (working | completed | failed); when completed, includes the freshly gathered buyers. Use exponential backoff (start ~20s) and stop polling once status is completed or failed. Free.

{
  "type": "object",
  "properties": {
    "task_id": {
      "type": "string",
      "description": "The task_id returned in find_buyers' acquisition field, or a discovery job_id"
    },
    "limit": {
      "type": "number",
      "description": "Max buyers to return when completed (default 50, max 100)"
    }
  },
  "required": [
    "task_id"
  ]
}

List open collective sourcing projects (联拼宝 / Lianpinbao). Multiple suppliers co-sell into shared buyer pools, reducing per-supplier MOQ. Find pools where you can join to access existing buyer demand.

{
  "type": "object",
  "properties": {
    "category": {
      "type": "string",
      "description": "Filter by product category keyword (optional)"
    },
    "status": {
      "type": "string",
      "enum": [
        "open",
        "filling"
      ],
      "description": "Pool status (default: open)"
    }
  }
}

Search live products listed by ProcureRadar suppliers by keyword, destination country, supplier country, or category. Returns product_id values needed to request a quote. Free & anonymous (IP rate-limited). This is the first step of the buyer-side transaction loop: search_products → request_quote → list_quotes → place_order.

{
  "type": "object",
  "properties": {
    "q": {
      "type": "string",
      "description": "Keyword (product title / SKU / supplier name)"
    },
    "country_iso": {
      "type": "string",
      "description": "Destination country ISO2 (filters by deliverable SKUs)"
    },
    "supplier_country": {
      "type": "string",
      "description": "Supplier origin country ISO2"
    },
    "category": {
      "type": "string",
      "description": "Category code (mall_category_code), optional"
    },
    "limit": {
      "type": "number",
      "description": "Max results (default 20, max 50)"
    }
  }
}

Discover verified supplier storefronts (supply nodes) on ProcureRadar by target-market country and industry. Each store groups multiple products from one verified supplier and returns sample_product_ids you can quote on. Use this to find a supplier store first, then search_products / request_quote. Free & anonymous (IP rate-limited). Organizing principle: country × industry matrix.

{
  "type": "object",
  "properties": {
    "country": {
      "type": "string",
      "description": "Target-market country ISO2 the store operates/sells into (e.g. MY, VN, JP)"
    },
    "industry": {
      "type": "string",
      "description": "Industry key (85-industry taxonomy, aligns with product category codes, e.g. 'beauty_personal_care')"
    },
    "q": {
      "type": "string",
      "description": "Store name keyword (optional)"
    },
    "limit": {
      "type": "number",
      "description": "Max results (default 20, max 50)"
    }
  }
}

Start a transaction by sending a quote request (inquiry) to a supplier for a specific product_id (get one from search_products). Returns an inquiry_id. Requires authentication — the inquiry is owned by the authenticated buyer. The supplier then submits a quote; poll it with list_quotes.

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "description": "Product id to request a quote for (from search_products)"
    },
    "quantity": {
      "type": "number",
      "description": "Desired quantity (optional)"
    },
    "quantity_unit": {
      "type": "string",
      "description": "Unit for the quantity, e.g. 'pcs', 'kg' (optional)"
    },
    "buyer_note": {
      "type": "string",
      "description": "Free-text note to the supplier (optional)"
    },
    "destination_country": {
      "type": "string",
      "description": "Destination country ISO2 (optional)"
    },
    "destination_city": {
      "type": "string",
      "description": "Destination city (optional)"
    }
  },
  "required": [
    "product_id"
  ]
}

List the supplier quotes submitted for one of your inquiries (from request_quote). Returns each quote's id, unit price, total, MOQ, lead time and validity, plus acceptable_quote_ids you can pass to place_order. Requires authentication; only the inquiry's buyer (or the product's supplier) may read it.

{
  "type": "object",
  "properties": {
    "inquiry_id": {
      "type": "string",
      "description": "The inquiry_id returned by request_quote"
    }
  },
  "required": [
    "inquiry_id"
  ]
}

Accept a supplier quote and create an order (status pending_payment) for one of your inquiries. Pass the inquiry_id and the chosen quote_id (from list_quotes' acceptable_quote_ids). Optionally pass a mandate_id (from create_payment_mandate) to auto-authorize the order against an AP2 payment mandate within its limits — the response then includes mandate_authorization (authorized/declined + reason). Returns the order id, order_no and a payment next_step. Idempotent per inquiry: re-calling returns the existing order. Requires authentication.

{
  "type": "object",
  "properties": {
    "inquiry_id": {
      "type": "string",
      "description": "The inquiry_id (from request_quote / list_quotes)"
    },
    "quote_id": {
      "type": "string",
      "description": "The quote_id to accept (from list_quotes' acceptable_quote_ids)"
    },
    "mandate_id": {
      "type": "string",
      "description": "Optional AP2 payment mandate id (from create_payment_mandate) to auto-authorize this order within pre-approved limits."
    }
  },
  "required": [
    "inquiry_id",
    "quote_id"
  ]
}

Create an AP2 payment mandate: a pre-authorization that lets your agent place orders autonomously (human-not-present) within strict limits — total budget, optional per-order cap, currency, optional seller/category scope, and expiry. Returns a mandate_id to pass to place_order. Each order authorized against it is recorded as a verifiable intent and decrements the budget. Requires authentication.

{
  "type": "object",
  "properties": {
    "max_total_amount": {
      "type": "number",
      "description": "Total spend budget for this mandate (required, > 0)"
    },
    "currency": {
      "type": "string",
      "description": "Currency, e.g. USD (default USD). Must match the order currency to authorize."
    },
    "max_per_order_amount": {
      "type": "number",
      "description": "Optional per-order cap"
    },
    "category_scope": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional list of allowed category codes (mall_category_code). Omit = any category."
    },
    "seller_scope": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Optional list of allowed seller_user_id UUIDs. Omit = any seller."
    },
    "expires_at": {
      "type": "string",
      "description": "Optional ISO timestamp after which the mandate is no longer valid."
    }
  },
  "required": [
    "max_total_amount"
  ]
}

List your AP2 payment mandates with status, currency, total/per-order limits, consumed and remaining budget, scope and expiry. Requires authentication.

{
  "type": "object",
  "properties": {}
}