Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ensads.tech/llms.txt

Use this file to discover all available pages before exploring further.

A placement identifies where on a page an ad is displayed. ENS Ads uses placement slugs — short string identifiers — to connect campaigns to specific visual locations in your UI. When you fetch campaigns, you tell the API which placement you are filling, and the API returns campaigns that have been targeted to that slot.
The placement parameter is required on every call to GET /api/v1/campaigns/fetch. Requests that omit it will receive a 400 error with the message "placement parameter is required".

​
Available placements

The table below lists every supported placement, its slug (the value you pass in the placement parameter), and where it appears on a page.
SlugNameDescription
header_bannerHeader bannerFull-width banner at top of page
hero_sectionHero section overlayOverlay on main hero/featured section
sidebar_topSidebar — topPremium position in right/left sidebar
sidebar_middleSidebar — middleMid-position in sidebar
sidebar_bottomSidebar — bottomBottom position in sidebar
article_inlineArticle inlineEmbedded within article content
article_topArticle topAbove article headline
article_bottomArticle bottomBelow article content
feed_sponsoredFeed — sponsored postNative ad in content feed
feed_carouselFeed — carouselCarousel/slider in feed
feed_betweenFeed — between postsBetween regular feed items
footer_bannerFooter bannerFull-width banner at page footer
footer_topFooter — top sectionAbove footer content
modal_overlayModal/popupInterstitial modal ad
sticky_bottomSticky bottom barFixed bar at bottom of viewport

​
Using placements in your request

Pass the placement slug as a query parameter when fetching campaigns: 
curl -X GET "https://ads.enslive.live/api/v1/campaigns/fetch?placement=header_banner&location=US&device=desktop" \
  -H "Authorization: Bearer YOUR_API_KEY"
You can fetch campaigns for one placement per request. If your page renders multiple placements, make a separate request for each one.

​
Placement categories at a glance

These placements sit in fixed regions of the overall page layout:
  • header_banner — top of the page, maximum visibility
  • footer_banner — bottom of the page
  • footer_top — directly above the footer block
  • sticky_bottom — fixed to the bottom of the viewport while the user scrolls
  • modal_overlay — appears over page content as an interstitial
These placements are tied to editorial content pages:
  • article_top — above the article headline
  • article_inline — embedded within the article body
  • article_bottom — below the article
Feed placements blend into content streams and listing pages:
  • feed_sponsored — styled as a native sponsored post
  • feed_carousel — a swipeable carousel/slider unit
  • feed_between — inserted between organic feed items
  • hero_section — overlaid on the main hero or featured image of the page; high-impact, often used on homepages or landing pages
Always render the campaign in the placement you requested. Displaying a campaign in a different slot than the one used to fetch it produces inaccurate targeting data and may violate advertiser campaign settings.