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.