{"openapi":"3.1.0","info":{"title":"PulseAPI — B2B Web, AEO, Print & Gemini Intelligence Suite","description":"High-speed developer APIs & Web Studio for Clean URL-to-Markdown extraction, 2026 AEO (AI Search Visibility) & Technical SEO auditing, 300-DPI Print/Seamless Tile inspection, and Gemini 3.8 Flash Multimodal Structured Extraction.","version":"1.0.0"},"servers":[{"url":"https://pulseapi.srv1751825.hstgr.cloud","description":"Production HTTPS Gateway"}],"paths":{"/health":{"get":{"tags":["System"],"summary":"Health Check","operationId":"health_check_health_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/v1/extract/markdown":{"post":{"tags":["1. Web-to-LLM Markdown API"],"summary":"Convert any URL into clean, token-optimized Markdown + Brand Metadata","operationId":"api_extract_markdown_v1_extract_markdown_post","parameters":[{"name":"require_ai_budget","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Require Ai Budget"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"X-RapidAPI-Proxy-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"X-RapidAPI-User","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}},{"name":"X-Gemini-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Gemini-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/MarkdownExtractRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/audit/aeo-seo":{"post":{"tags":["2. AEO & Technical SEO Audit API"],"summary":"Score any website (0-100) for AI Answer Engine Citability (llms.txt, GPTBot, Schema) & SEO","operationId":"api_audit_aeo_seo_v1_audit_aeo_seo_post","parameters":[{"name":"require_ai_budget","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Require Ai Budget"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"X-RapidAPI-Proxy-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"X-RapidAPI-User","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}},{"name":"X-Gemini-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Gemini-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AuditRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/media/print-inspect":{"post":{"tags":["3. Print 300-DPI & Seamless Tile API"],"summary":"Inspect image resolution at 300 DPI, seamless tile continuity %, and dominant hex palette","operationId":"api_print_inspect_v1_media_print_inspect_post","parameters":[{"name":"require_ai_budget","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Require Ai Budget"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"X-RapidAPI-Proxy-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"X-RapidAPI-User","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}},{"name":"X-Gemini-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Gemini-Api-Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PrintInspectRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/media/print-inspect-upload":{"post":{"tags":["3. Print 300-DPI & Seamless Tile API"],"summary":"Upload an image file directly for 300-DPI print & seamless tile analysis","operationId":"api_print_inspect_upload_v1_media_print_inspect_upload_post","parameters":[{"name":"require_ai_budget","in":"query","required":false,"schema":{"type":"boolean","default":false,"title":"Require Ai Budget"}},{"name":"X-API-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Api-Key"}},{"name":"X-RapidAPI-Proxy-Secret","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-Proxy-Secret"}},{"name":"X-RapidAPI-User","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Rapidapi-User"}},{"name":"X-Gemini-Api-Key","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Gemini-Api-Key"}}],"requestBody":{"required":true,"content":{"multipart/form-data":{"schema":{"$ref":"#/components/schemas/Body_api_print_inspect_upload_v1_media_print_inspect_upload_post"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ai/listing-studio":{"post":{"tags":["4. Gemini 3.8 Multimodal AI APIs"],"summary":"Generate SEO titles, 13 buyer tags, descriptions & FAQ JSON-LD from product brief + optional image","operationId":"api_ai_listing_studio_v1_ai_listing_studio_post","parameters":[{"name":"x_api_key","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X Api Key"}},{"name":"x_rapidapi_proxy_secret","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X Rapidapi Proxy Secret"}},{"name":"x_rapidapi_user","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X Rapidapi User"}},{"name":"x_gemini_api_key","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X Gemini Api Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ListingStudioRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/v1/ai/extract-json":{"post":{"tags":["4. Gemini 3.8 Multimodal AI APIs"],"summary":"Extract strict validated JSON fields from messy invoices, receipts, emails, or text","operationId":"api_ai_extract_json_v1_ai_extract_json_post","parameters":[{"name":"x_api_key","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X Api Key"}},{"name":"x_rapidapi_proxy_secret","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X Rapidapi Proxy Secret"}},{"name":"x_rapidapi_user","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X Rapidapi User"}},{"name":"x_gemini_api_key","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X Gemini Api Key"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExtractJsonRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"AuditRequest":{"properties":{"url":{"type":"string","title":"Url","description":"Public website URL to audit for AEO & SEO.","examples":["https://stripe.com"]}},"type":"object","required":["url"],"title":"AuditRequest"},"Body_api_print_inspect_upload_v1_media_print_inspect_upload_post":{"properties":{"file":{"type":"string","contentMediaType":"application/octet-stream","title":"File"},"export_300dpi_base64":{"type":"boolean","title":"Export 300Dpi Base64","default":false}},"type":"object","required":["file"],"title":"Body_api_print_inspect_upload_v1_media_print_inspect_upload_post"},"ExtractJsonRequest":{"properties":{"raw_text":{"type":"string","maxLength":30000,"minLength":5,"title":"Raw Text","description":"Unstructured invoice, receipt, email, or business text.","examples":["Invoice #INV-9042 from Acme Cloud LLC dated 2026-10-28. Subtotal $420.00, Tax $33.60, Total Due $453.60 by Nov 15, 2026."]},"fields_to_extract":{"items":{"type":"string"},"type":"array","title":"Fields To Extract","description":"Field names to extract into strict JSON.","default":["invoice_number","vendor_name","invoice_date","total_amount","currency","due_date"]},"document_type":{"type":"string","title":"Document Type","description":"Document context hint.","default":"invoice_or_receipt"},"image_base64":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Base64","description":"Optional base64 document/receipt image."},"image_mime_type":{"type":"string","title":"Image Mime Type","default":"image/jpeg"}},"type":"object","required":["raw_text"],"title":"ExtractJsonRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"ListingStudioRequest":{"properties":{"product_brief":{"type":"string","maxLength":5000,"minLength":8,"title":"Product Brief","description":"Product details, materials, style, and target buyer notes.","examples":["Minimalist sage green botanical seamless pattern swatch for nursery wallpaper and fabric"]},"marketplace":{"type":"string","title":"Marketplace","description":"Target platform.","default":"shopify","examples":["shopify","amazon","etsy"]},"image_base64":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Base64","description":"Optional base64 product image for multimodal vision analysis."},"image_mime_type":{"type":"string","title":"Image Mime Type","description":"MIME type of optional image (image/jpeg, image/png, image/webp).","default":"image/jpeg"}},"type":"object","required":["product_brief"],"title":"ListingStudioRequest"},"MarkdownExtractRequest":{"properties":{"url":{"type":"string","title":"Url","description":"Public HTTP/HTTPS URL to extract.","examples":["https://example.com"]},"include_links":{"type":"boolean","title":"Include Links","description":"Preserve inline Markdown hyperlinks.","default":true}},"type":"object","required":["url"],"title":"MarkdownExtractRequest"},"PrintInspectRequest":{"properties":{"image_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Url","description":"Public image URL to inspect."},"image_base64":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Image Base64","description":"Base64-encoded PNG/JPG/WebP image."},"export_300dpi_base64":{"type":"boolean","title":"Export 300Dpi Base64","description":"Return a 300-DPI metadata-stamped PNG data URI.","default":false}},"type":"object","title":"PrintInspectRequest"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}