"# Saymon RU Data API\n\n> Russian-language data APIs for AI agents. Pay per request in USDC via x402 (HTTP 402 Payment Required). No API keys, no accounts, no subscriptions.\n\nBase URL: https://payforapi.com\nPayment: x402 exact scheme, USDC on Base mainnet (eip155:8453)\nFacilitator: https://x402.primer.systems\nMCP endpoint: https://payforapi.com/mcp (streamable-http)\n\n## Endpoints\n\n### POST /v1/inn-lookup — $0.01 USDC\nПроверка российского юрлица по ИНН (ЕГРЮЛ/ФНС). Returns: ИНН, ОГРН, КПП, наименование, руководитель, дата регистрации, регион.\nRequest: {\"inn\": \"7707083893\"}\n\n### POST /v1/ru-search — $0.02 USDC\nКириллический веб-поиск для агентов. Returns: URL-результаты.\nRequest: {\"query\": \"ООО Рога и Копыта\", \"limit\": 5}\n\n### POST /v1/ru-page — $0.01 USDC\nRU-страница → LLM-ready Markdown.\nRequest: {\"url\": \"https://ria.ru/\"}\n\n### POST /v1/research — $0.02 USDC\nResearch-пакет: кириллический поиск + top-страницы, собранные в один ответ (Markdown).\nОдин платёж вместо цепочки ru-search + ru-page.\nRequest: {\"query\": \"новости нефтегазового рынка\", \"limit\": 5, \"max_pages\": 3}\n\n### POST /v1/research/deep — $0.05 USDC\nResearch-пакет deep: 3 поиска (вариации запроса) + до 10 страниц в один ответ (Markdown).\nДля полной проверки контрагента / глубокого анализа.\nRequest: {\"query\": \"ООО Реальная энергия\", \"limit\": 8, \"max_pages\": 8}\n\n### POST /v1/pochta-tariff — $0.01 USDC\nПочта России: стоимость и сроки доставки между индексами (официальный API, договор Почты России).\nRequest: {\"from_index\": \"101000\", \"to_index\": \"190000\", \"weight\": 1000, \"mail_type\": \"POSTAL_PARCEL\", \"mail_category\": \"ORDINARY\", \"declared_value\": 500000}\n\n### POST /v1/pochta-track — $0.01 USDC\nПочта России: отслеживание отправления по трек-номеру (SOAP tracking.russianpost.ru).\nRequest: {\"barcode\": \"ED109243163RU\"}\n\n### POST /v1/pochta-delivery-time — $0.01 USDC\nПочта России: сроки доставки между индексами (в днях).\nRequest: {\"from_index\": \"101000\", \"to_index\": \"190000\", \"mail_type\": \"POSTAL_PARCEL\", \"mail_category\": \"ORDINARY\"}\n\n### POST /v1/pochta-offices — $0.01 USDC\nПочта России: отделения по индексу (postal_code) или ближайшие по координатам (latitude+longitude).\nRequest: {\"postal_code\": \"101000\"} или {\"latitude\": 55.7558, \"longitude\": 37.6173, \"top\": 10}\n\n### POST /v1/pochta-zip — $0.01 USDC\nПочта России: адрес отделения и населённый пункт по почтовому индексу.\nRequest: {\"postal_code\": \"101000\"}\n\n### POST /v1/pochta-address — $0.01 USDC\nПочта России: нормализация российского адреса (индекс, регион, улица, дом).\nRequest: {\"address\": \"Москва, ул Тверская, д 1\"}\n\n## 中文 (Chinese)\n\n面向AI代理的俄罗斯数据API。按次付费（x402 / HTTP 402），Base链USDC结算。无需注册、无需API密钥、无订阅。\n\n| 端点 | 价格 | 说明 |\n|---|---|---|\n| POST /v1/inn-lookup | $0.01 | 通过ИНН查询俄罗斯企业信息（ЕГРЮЛ/ФНС官方数据）：ОГРН、КПП、负责人、注册日期、地区 |\n| POST /v1/ru-search | $0.02 | 西里尔文（俄语）网页搜索，返回URL、标题、摘要 |\n| POST /v1/ru-page | $0.01 | 俄语网页转LLM友好Markdown |\n| POST /v1/research | $0.02 | 研究包：搜索+精选页面汇总为一份Markdown |\n| POST /v1/research/deep | $0.05 | 深度研究：3次搜索+最多10个页面（全面供应商/客户尽调） |\n| POST /v1/pochta-track | $0.01 | 俄罗斯邮政包裹跟踪（按单号） |\n| POST /v1/pochta-tariff | $0.01 | 俄罗斯邮政：邮编间运费和时效 |\n| POST /v1/pochta-delivery-time | $0.01 | 邮编间配送时效（天） |\n| POST /v1/pochta-offices | $0.01 | 按邮编或坐标查询邮局 |\n| POST /v1/pochta-zip | $0.01 | 邮编查邮局地址 |\n| POST /v1/pochta-address | $0.01 | 俄罗斯地址标准化 |\n\n用法：先请求（无支付）→ 服务端返回 HTTP 402 + payment-required → 签名EIP-3009 USDC转账（Base）→ 带 PAYMENT-SIGNATURE 重发 → 200 + 数据。\n\n## 日本語 (Japanese)\n\nAIエージェント向けロシア語データAPI。x402（HTTP 402）従量課金、BaseチェーンUSDC。APIキー・アカウント・サブスクリプション不要。\n\n| エンドポイント | 価格 | 説明 |\n|---|---|---|\n| POST /v1/inn-lookup | $0.01 | ИННによるロシア法人照会（ЕГРЮЛ/ФНС公式データ）：ОГРН、КПП、代表者、登録日、地域 |\n| POST /v1/ru-search | $0.02 | キリル文字ウェブ検索（URL・タイトル・スニペット） |\n| POST /v1/ru-page | $0.01 | ロシア語ページをLLM対応Markdownに変換 |\n| POST /v1/research | $0.02 | リサーチパック：検索+上位ページをMarkdownに集約 |\n| POST /v1/research/deep | $0.05 | ディープリサーチ：3回検索+最大10ページ（取引先調査・深掘り分析） |\n| POST /v1/pochta-track | $0.01 | ロシア郵便追跡（追跡番号） |\n| POST /v1/pochta-tariff | $0.01 | ロシア郵便：郵便番号間の配送料金と日数 |\n| POST /v1/pochta-delivery-time | $0.01 | 郵便番号間の配達日数 |\n| POST /v1/pochta-offices | $0.01 | 郵便番号・座標で郵便局検索 |\n| POST /v1/pochta-zip | $0.01 | 郵便番号で郵便局住所 |\n| POST /v1/pochta-address | $0.01 | ロシア住所の正規化 |\n\n利用手順：未払いリクエスト→HTTP 402+payment-required→EIP-3009署名（Base USDC）→PAYMENT-SIGNATURE付きで再送→200+データ。\n\n## 한국어 (Korean)\n\nAI 에이전트를 위한 러시아어 데이터 API. x402(HTTP 402) 종량제, Base 체인 USDC 결제. API 키·계정·구독 불필요.\n\n| 엔드포인트 | 가격 | 설명 |\n|---|---|---|\n| POST /v1/inn-lookup | $0.01 | ИНН으로 러시아 법인 조회(ЕГРЮЛ/ФНС 공식 데이터): ОГРН, КПП, 대표자, 등록일, 지역 |\n| POST /v1/ru-search | $0.02 | 키릴 문자(러시아어) 웹 검색 (URL·제목·요약) |\n| POST /v1/ru-page | $0.01 | 러시아어 페이지를 LLM용 Markdown으로 변환 |\n| POST /v1/research | $0.02 | 리서치 패키지: 검색+상위 페이지를 Markdown으로 집약 |\n| POST /v1/research/deep | $0.05 | 딥 리서치: 검색 3회+최대 10페이지 (거래처 조사·심층 분석) |\n| POST /v1/pochta-track | $0.01 | 러시아 우체국 배송 추적(운송장 번호) |\n| POST /v1/pochta-tariff | $0.01 | 러시아 우체국: 우편번호 간 배송 요금 및 기간 |\n| POST /v1/pochta-delivery-time | $0.01 | 우편번호 간 배송 기간(일) |\n| POST /v1/pochta-offices | $0.01 | 우편번호·좌표로 우체국 조회 |\n| POST /v1/pochta-zip | $0.01 | 우편번호로 우체국 주소 조회 |\n| POST /v1/pochta-address | $0.01 | 러시아 주소 정규화 |\n\n사용법: 미결제 요청 → HTTP 402+payment-required → EIP-3009 서명(Base USDC) → PAYMENT-SIGNATURE 헤더로 재전송 → 200+데이터.\n\n## How to pay (x402)\n1. Request without payment → HTTP 402 + payment-required header (base64 PaymentRequired v2).\n2. Sign EIP-3009 transferWithAuthorization for USDC (Base) to accepts[].payTo.\n3. Resend with PAYMENT-SIGNATURE header → 200 OK + payment-response.\n"