# ENS Ads

## Docs

- [GET /api/v1/campaigns/fetch — Retrieve Ad Campaigns](https://docs.ensads.tech/api/fetch-campaigns.md): Retrieve targeted ad campaigns by placement, location, and device. Returns an array of campaign objects with id, title, destinationUrl, and status fields.
- [ENS Ads Rate Limits: Handle 429 & Stay Within Limits](https://docs.ensads.tech/api/rate-limits.md): The ENS Ads API enforces rate limits. Learn how to handle 429 responses with exponential backoff and reduce API calls by caching fetched campaign data.
- [ENS Ads API HTTP Response Codes & Error JSON Formats](https://docs.ensads.tech/api/response-codes.md): ENS Ads responses use a JSON envelope with a status field. Reference codes 200, 400, 401, 404, 429, and 500 with success and error payload examples.
- [POST /api/v1/campaigns/click — Track User Clicks](https://docs.ensads.tech/api/track-click.md): Record a user click on a campaign ad. Send campaignId, placement, location, and device in the request body. Only fire for genuine user-initiated interactions.
- [Track Impressions: POST /api/v1/campaigns/impression](https://docs.ensads.tech/api/track-impression.md): Record a campaign impression each time an ad is displayed to a user. Send campaignId, placement, location, and device in the JSON request body.
- [ENS Ads API Authentication: API Keys & Bearer Tokens](https://docs.ensads.tech/authentication.md): Every ENS Ads API request requires a Bearer token in the Authorization header. Learn how to pass your API key securely in cURL, JavaScript, and Python.
- [ENS Ads Campaign Objects: Fields, Statuses & Matching](https://docs.ensads.tech/concepts/campaigns.md): Campaigns are the core ad unit in ENS Ads. Learn each field an object contains and how placement and targeting parameters control which campaigns are returned.
- [ENS Ads Placement Slugs: All 15 Ad Positions Listed](https://docs.ensads.tech/concepts/placements.md): ENS Ads placement slugs identify where ads appear on your page. Browse all 15 supported placements — header banners, sidebars, feeds, modals, and more.
- [ENS Ads Campaign Targeting: Location, Device & Category](https://docs.ensads.tech/concepts/targeting.md): Pass location (ISO country code) and device type when fetching campaigns to improve ad match quality and campaign relevance for your users.
- [ENS Ads Integration Code: JavaScript & Python Examples](https://docs.ensads.tech/guides/code-examples.md): Ready-to-use JavaScript and Python code for all three ENS Ads operations: fetching campaigns, recording impressions, and recording clicks from your server.
- [ENS Ads API Error Handling: Status Codes 400, 401, 429](https://docs.ensads.tech/guides/error-handling.md): Every ENS Ads error includes a status code and message field. Learn what each error means and see JavaScript and Python patterns for handling them gracefully.
- [How to Integrate ENS Ads into Your Platform (5 Steps)](https://docs.ensads.tech/guides/integration.md): Step-by-step guide to integrating ENS Ads: fetch campaigns, validate targeting, render in the correct placement, and report impressions and clicks to the API.
- [ENS Ads Developer Documentation](https://docs.ensads.tech/introduction.md): ENS Ads API allows partner platforms to retrieve approved campaigns, display them in supported placements, and report impressions and clicks in real time.
- [ENS Ads Quick Start: Your First Ad API Integration](https://docs.ensads.tech/quickstart.md): Go from zero to a working ad integration in minutes. Fetch a live campaign, display it in a placement, and record your first impression and click events.