Calling GET /api/v1/serve
A single GET request returns a matched native ad in under 50ms.
The Request
Send a GET request to /api/v1/serve with your API key and basic context about the placement — at minimum, your site or app identifier and the visitor's country if known. The Eye matches an eligible campaign based on this context.
What You Get Back
A JSON response containing the matched ad's creative (headline, body, image URL), a click-tracking URL, and metadata you can use for rendering. If no campaign matches, the response indicates no fill so you can show fallback content.
Response Time
Matching and fraud pre-checks happen server-side and typically return in under 50ms, so the call can sit inline in your page or app render path without a noticeable delay.
Handling Clicks
- Always use the click-tracking URL returned in the response — don't link directly to the advertiser's destination
- The Eye screens the click for fraud when the tracking URL is hit, before billing the advertiser and crediting you
- Fraud-flagged clicks are excluded from your earnings automatically
Rate Limits and Caching
Don't cache responses across different visitors — each call is matched to that specific request's context. Check your dashboard for current rate limits.