Web fetching

When a URL is pasted in the admin panel, Hopla extracts its title, image and, for products, its price. These three endpoints expose the same extraction, to fill a block from a script or an agent.

Each endpoint expects an https:// URL in url. The page is fetched from Hopla servers, without cookies, and only public addresses are allowed (SSRF protection). Rate limit: 30 requests per account per 10 minutes; above that, 429 rate_limited.

URL metadataCopy Anchor Link

curl -X POST https://app.hopla.page/api/v2/fetch/preview \
  -H "Authorization: Bearer $HOPLA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://boutique.example.com/programme", "image": "shareButton"}'

{
  "preview": {
    "title": "Programme 8 semaines",
    "description": "Un plan simple pour reprendre le sport.",
    "price": "49 €",
    "image": "data:image/webp;base64,…"
  }
}

The image is returned as a data URL: to use it in a block, send it as is to POST /media. An unreachable site, or one that does not return HTML, returns 422 fetch_failed.

RSS feeds and YouTube channelsCopy Anchor Link

curl -X POST https://app.hopla.page/api/v2/fetch/feed \
  -H "Authorization: Bearer $HOPLA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/blog"}'

Returns the three latest posts, newest first: title, url, date, image, and video for an episode. The URL can be the feed itself (RSS, Atom) or a page that declares it. With {"video": true} and a YouTube channel URL, returns the latest long-form video. Without a usable feed: {"articles": []}.

Review ratingCopy Anchor Link

curl -X POST https://app.hopla.page/api/v2/fetch/rating \
  -H "Authorization: Bearer $HOPLA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://fr.trustpilot.com/review/example.com"}'

{ "rating": { "rating": 4.6, "count": 1820, "source": "Trustpilot" } }

The rating (rating) is normalized to 5, with the review count (count). It comes from Trustpilot, or from any page that declares it in its structured data (aggregateRating). Without a declared rating, or if the page blocks bots, the response is {"rating": null}. Google Business Profile pages are not supported: enter the rating manually in the proof block.