{
  "read": {
    "all_brands": "GET ?list=all&limit=100&offset=0 (free: names, categories, scores and which tools exist)",
    "missing_data": "GET ?list=needs-data&kind=any|contacts|policies (trusted crawl keys only)",
    "one_brand": "GET ?domain=walmart.com with x-api-key (full record; free key at https://robauto.ai/developers, 100/day free then paid)"
  },
  "endpoint": "https://robauto.ai/api/brand-submit",
  "method": "POST",
  "body": {
    "domain": "example.com",
    "name": "Example Inc",
    "category": "retail",
    "client_key": "your-agent-id",
    "fields": {
      "support_email": {
        "value": "support@example.com",
        "source_url": "https://example.com/contact"
      },
      "returns_policy_url": {
        "value": "https://example.com/returns",
        "source_url": "https://example.com/returns"
      }
    }
  },
  "batch": "Send { brands: [ ...up to 20 of the object above ] } to add many in one call.",
  "field_keys": {
    "support": [
      "support_email",
      "support_phone",
      "support_url",
      "support_hours",
      "support_chat_url"
    ],
    "dispute": [
      "dispute_email",
      "dispute_url",
      "chargeback_url",
      "dispute_phone",
      "card_descriptor"
    ],
    "legal": [
      "legal_email",
      "legal_notice_address",
      "legal_url",
      "agent_for_service_url"
    ],
    "escalation": [
      "escalation_email",
      "escalation_url",
      "executive_office_url"
    ],
    "unsubscribe": [
      "unsubscribe_url",
      "email_preferences_url",
      "opt_out_method",
      "do_not_sell_url",
      "data_deletion_url"
    ],
    "policy": [
      "returns_policy_url",
      "refund_window_days",
      "warranty_url",
      "shipping_policy_url",
      "cancellation_policy_url",
      "privacy_policy_url",
      "terms_url",
      "ai_agent_policy_url"
    ],
    "agent": [
      "mcp_server_url",
      "mcp_manifest_url",
      "agent_card_url",
      "openai_apps_url",
      "agent_api_docs_url",
      "agent_auth_url",
      "agent_payments_url",
      "robots_txt_url",
      "llms_txt_url",
      "agents_md_url",
      "featured_offer",
      "featured_offer_2",
      "featured_offer_3",
      "featured_content",
      "featured_content_2"
    ]
  },
  "rules": [
    "Every field needs a source_url on the brand's own domain.",
    "Only role mailboxes are stored — never a named individual.",
    "Submitted values never overwrite a human-verified value.",
    "Leave a field out rather than guessing it."
  ]
}