--- name: api.agentwonderland.com description: api.agentwonderland.com exposes five distinct skills spanning proprietary data retrieval, keyword management, ad copy generation, product listing creation, and static HTML publishing. Several skills operate asynchronously and require polling a returned URL to collect final results. The host serves agents that need to produce or distribute marketing content and retrieve structured endpoint data. host: api.agentwonderland.com --- # api.agentwonderland.com AgentWonderland is a multi-purpose API host serving agents that need to generate marketplace and advertising content, manage keyword associations, retrieve Europe proprietary endpoint data, and publish static HTML pages publicly. It is not a single-domain service; its skills span data retrieval, content generation, and lightweight publishing. The async pattern (job submission + poll_url) is common across several skills, so agents must be capable of multi-step polling flows to use this host effectively. ## When to use this host Use this host when an agent needs to generate Amazon product listings, produce short-form ad copy for platforms like LinkedIn, pin keywords to AgentWonderland endpoints, retrieve Europe proprietary data asynchronously, or publish static HTML to a shareable URL. Agents must support async polling flows for fetch-europe-prop-data and pin-keywords, as those skills do not return inline results. Do not use this host for long-form content (blog posts, press releases, email newsletters), dynamic web application hosting, bulk catalog generation without per-item inputs, synchronous keyword resolution, or permanent static hosting — published pages expire. For general-purpose copywriting beyond ad copy and Amazon listings, a dedicated copywriting API would be more appropriate. ## Capabilities ### Async Data Retrieval Submits jobs to AgentWonderland-backed endpoints and returns handles for polling final results. Both skills follow the same async job-submission pattern requiring a follow-up poll step. - **`fetch-europe-prop-data`** — Submits a search query to the EuropeProp agent and returns a job ID, status, and poll URL for retrieving Europe proprietary endpoint data. - **`pin-keywords`** — Submits a keyword pinning job for an AgentWonderland endpoint and returns an async job handle with a poll URL for result retrieval. ### Marketing Content Generation Produces structured short-form and marketplace-ready copy from product inputs, covering platform-specific ad variants and full Amazon product listings. - **`generate-ad-copy`** — Generates platform-specific ad copy variants with headlines, primary text, CTAs, hooks, and angles given a product URL, context, audience, and platform. - **`write-product-listing`** — Generates a marketplace-ready product listing (title, bullet points, description, and backend keywords) from product specs and keywords, optimized for Amazon SEO. ### Static Content Publishing Publishes a rendered HTML document to a stable public URL on shippage.ai, with optional password protection and custom slug, enabling agents to deliver formatted outputs to end users. - **`publish-html-to-public-url`** — Publishes a static HTML page to a public URL on shippage.ai, returning the live share link, slug, expiry, and optional password protection. ## Workflows ### Generate and Publish Amazon Product Listing *Use when an agent needs to convert raw product specs into a structured Amazon listing and then deliver that listing as a publicly accessible HTML page to a stakeholder.* 1. **`write-product-listing`** — Generate a structured Amazon listing (title, bullet points, description, backend keywords) from product specs and keywords. 2. **`publish-html-to-public-url`** — Render the listing output as HTML and publish it to a public URL so it can be shared with a client or reviewer. ### Generate and Publish Ad Copy *Use when an agent needs to produce platform-specific ad copy variants and share them with a stakeholder via a stable public link.* 1. **`generate-ad-copy`** — Generate multiple ad copy variants (headlines, CTAs, hooks) for a given product, audience, and platform. 2. **`publish-html-to-public-url`** — Format the ad variants as HTML and publish them to a public URL for review or delivery. ## Skill reference ### `fetch-europe-prop-data` **Europe Prop API** — Submits a search query to the EuropeProp agent and returns a job ID, status, and poll URL for retrieving Europe proprietary endpoint data. *Use when:* Use when an agent needs to retrieve Europe proprietary data (e.g. asset allocation signals) via a search URL and can follow up with a polling step to collect the final result. *Not for:* Do not use if you need synchronous inline results; the response is async and requires polling the returned poll_url to get final data. **Inputs:** - `searchUrl` (string, required) — Full URL encoding the region, product, query, and source parameters for the Europe proprietary data search. **Returns:** Returns a job_id, status of 'processing', agent_id, agent_name, a poll_url for retrieving the final result, latency metrics, cost, and a feedback_token. **Example:** `{"searchUrl": "https://agentwonderland.com/search?region=europe&product=proprietary-endpoint&query=asset%20allocation%20signals&source=partner_portal"}` --- ### `generate-ad-copy` **AdCopy Forge** — Generates platform-specific ad copy variants with headlines, primary text, CTAs, hooks, and angles given a product URL, context, audience, and platform. *Use when:* Use when an agent needs to produce multiple ad copy variants for a specific platform (e.g. LinkedIn) given a product description, target audience, and campaign context. *Not for:* Do not use for long-form content such as blog posts, press releases, or email newsletters; this endpoint is scoped to short-form ad copy variants only. **Inputs:** - `url` (string, required) — URL of the product or landing page the ad copy should reference. - `context` (string, required) — Free-text description of the campaign scenario, constraints, tone, and any specific messaging requirements. - `product` (string, required) — Name and short description of the product being advertised. - `audience` (string, required) — Description of the target audience for the ad copy. - `platform` (string, required) — Advertising platform the copy is intended for (e.g. linkedin, facebook, twitter). - `variants` (integer, required) — Number of ad copy variants to generate. **Returns:** Returns a job_id, status, agent metadata, latency_ms, and an output.ads.variants array where each variant contains a headline, primaryText, cta, hook, and angle for the requested platform. **Example:** `{"url":"https://example.com/product","context":"Company: AgentWonderland. Product: API for generating ad copy. Value proposition: high-converting ad copy in minutes, API-first workflow. Constraints: professional tone, under 200 words.","product":"AdCopy Forge — generates concise, professional ad/campaign messaging.","audience":"Paying B2B API subscribers who manage production workloads.","platform":"linkedin","variants":5}` --- ### `pin-keywords` **Keyword Pinning API** — Submits a keyword pinning job for an AgentWonderland endpoint and returns an async job handle with a poll URL for result retrieval. *Use when:* Use when an agent needs to pin one or more keywords to an AgentWonderland endpoint and must track the async job to completion via polling. *Not for:* Do not use for real-time keyword lookups or synchronous keyword resolution; this is an async job submission that requires polling the returned poll_url for final results. **Inputs:** - `keyword` (string, required) — The keyword or phrase to pin to the endpoint. - `maxKeywords` (integer) — Maximum number of keywords to pin in this job. **Returns:** Returns a job_id, status of 'processing', agent metadata, a poll_url for async result retrieval, latency metrics, cost, and a feedback token. **Example:** `{"keyword": "electric vehicle charging", "maxKeywords": 100}` --- ### `publish-html-to-public-url` **Publish HTML Publicly** — Publishes a static HTML page to a public URL on shippage.ai, returning the live share link, slug, expiry, and optional password protection. *Use when:* Use when an agent needs to share a rendered HTML document publicly via a stable URL, optionally with a password and custom slug, such as delivering a report, analysis, or formatted output to an end user. *Not for:* Do not use for hosting dynamic web applications or server-side logic; this publishes static HTML only. Not suitable for long-term permanent hosting — pages expire as indicated by expires_at. **Inputs:** - `html` (string, required) — Full HTML content to publish as a static page. May include inline CSS and script tags. - `slug` (string) — URL slug for the published page. Determines the path component of the public URL (e.g. my-report becomes https://shippage.ai/p/my-report). - `title` (string) — Human-readable title for the published page. - `password` (string) — Optional password to protect the published page. If provided, visitors must enter this password to view the content. **Returns:** Returns a job_id, status='success', and an output object containing the live public URL on shippage.ai, the slug, an expiry timestamp, and password protection status. **Example:** `{"html": "My Report

Analysis

", "slug": "my-report-2026", "title": "My Report", "password": "secret123"}` --- ### `write-product-listing` **Product Listing Writer** — Generates a marketplace-ready product listing (title, bullet points, description, and backend keywords) from product specs and keywords, optimized for Amazon SEO. *Use when:* Use when an agent needs to convert raw product specifications and a product summary into a structured Amazon listing with a title, benefit-led bullet points, a full description, and backend search keywords. *Not for:* Do not use for generating ad copy, social media posts, or non-marketplace content; use a general copywriting API instead. Not suitable for bulk catalog generation without per-item spec inputs. **Inputs:** - `product` (string, required) — Short product summary or marketing blurb describing the item, its key features, and positioning. - `specs` (string, required) — Full technical specifications for the product as a free-text string. - `keywords` (array, required) — List of target search keywords to integrate into the listing for SEO. **Returns:** Returns a job_id, status, and a listing object containing an SEO-optimized title, five benefit-led bullet points, a full product description, backend keywords, and an SEO score string. **Example:** `{"product": "AuroraSound Wireless Bluetooth Headphones (Over-Ear, 60H Battery, Active Noise Cancelling)", "specs": "Bluetooth 5.3, multipoint support, 60H battery (ANC on), USB-C charging, 40mm drivers, dual beamforming mics, hybrid ANC, foldable, 248g", "keywords": ["wireless bluetooth headphones", "active noise cancelling", "multipoint bluetooth", "low latency headphones"]}` ---