{"name":"nanoSEO Agent API","schema_version":"1.2","description":"Create and track a paid nanoSEO audit from an AI agent or automated workflow. Orders use NanSwap Pay for payment confirmation.","documentation_url":"https://nano-seo.com/agents","openapi_url":"https://nano-seo.com/api/v1/agent/openapi","authentication":"None. Payment is required before the audit starts.","content_type":"application/json","endpoints":{"manifest":{"method":"GET","url":"https://nano-seo.com/api/v1/agent"},"plans":{"method":"GET","url":"https://nano-seo.com/api/v1/agent/plans"},"openapi":{"method":"GET","url":"https://nano-seo.com/api/v1/agent/openapi"},"create_order":{"method":"POST","url":"https://nano-seo.com/api/v1/agent/orders"},"order_status":{"method":"GET","url":"https://nano-seo.com/api/v1/agent/orders/{order_id}"},"report":{"method":"GET","url":"https://nano-seo.com/api/v1/audits/{order_id}"},"report_exports":{"method":"GET","url":"https://nano-seo.com/api/v1/audits/{order_id}/export?format=csv|json"}},"required_order_fields":["package_id","target_url","terms_accepted"],"optional_order_fields":["category_id","scan_mode","selected_urls","discount_code","payin_currency","idempotency_key"],"defaults":{"category_id":"general","scan_mode":"auto","payin_currency":"XNO","selected_urls":[]},"flow":["Fetch available plans and categories from GET /api/v1/agent/plans.","POST /api/v1/agent/orders with terms_accepted set to true and a stable Idempotency-Key header.","If next_action.action is pay, fetch the status URL immediately before sending. Send amount_to_send_exact (or amount_to_send without rounding) in currency_to_send. Never treat price_amount or amount as the crypto amount.","Poll GET /api/v1/agent/orders/{order_id} until status is complete or failed, or next_action is contact_support. For contact_support, stop paying and open next_action.contact_url with the order ID.","Fetch the completed report from GET /api/v1/audits/{order_id}, or use its export endpoints."],"payment":{"provider":"NanSwap Pay","mode":"server_api","note":"Agent orders use NanSwap's server API and return a payment URL, invoice ID, and exact pay-in amount. The browser widget is not used.","amount_rule":"Use amount_to_send_exact with currency_to_send. Do not round or convert it. price_amount is the fiat invoice price, not the crypto amount.","network_fees":"Paid by the customer outside nanoSEO","confirmation":"The audit starts only after NanSwap reports a qualifying payment.","demo_mode_available":false},"idempotency":{"header":"Idempotency-Key","optional_body_field":"idempotency_key","precedence":"The Idempotency-Key header takes precedence over the body idempotency_key field.","key_format":"8-128 printable ASCII characters with no spaces.","note":"Use one unique key per intended order and reuse it for every retry. Identical agent requests without a key are deduplicated within the same 10-minute window."},"limits":{"selected_pages_maximum":25,"order_status_poll_seconds":3,"automatic_order_dedupe_seconds":600,"report_retention_days":14},"report":{"retention_days":14,"expired_status":410,"export_formats":["csv","json"]},"errors":{"format":"JSON object with an error string: { \"error\": \"message\" }.","cors":true},"ordering_note":"Save the order_id and status URL. Retry with the same Idempotency-Key; never create a second order while an earlier payment is still open. Reports and their detailed page data are deleted 14 days after completion; export anything you need to keep."}