# Search in display ads

Endpoint: POST /display/ads/search
Version: 1.0.0

## Request fields (application/json):

  - `api_key` (string)
    Your API Key token.
    Example: "YOUR_API_KEY_HERE"

  - `last_hit` (integer)
    after first page send the current timestamp in seconds

  - `page` (integer)
    Example: 1

  - `orderby` (string)
    Enum: "updated_at", "oldest", "impressions", "days_active", "domain.traffic"

## Response 200 fields (application/json):

  - `status` (string, required)
    Enum: "ok", "failed"

  - `meta` (object, required)

  - `meta.code` (integer)
    Example: 1000

  - `meta.message` (string,null)

  - `data` (object, required)

  - `data.ads` (array)

  - `data.ads.id` (integer)
    Ad's id
    Example: 1234

  - `data.ads.title` (string)
    Example: "test title"

  - `data.ads.updated_at` (string)
    last updated time
    Example: "2025-04-05T10:33:27.000000Z"

  - `data.ads.active_days` (integer)
    Ad's active days
    Example: 6

  - `data.ads.impressions` (integer)
    number of seens
    Example: 100

  - `data.ads.network` (string)
    Enum: "criteo", "adform", "adition", "google", "webgains", "engageya"

  - `data.ads.attachments` (array)

  - `data.ads.attachments.id` (integer)
    Example: 10

  - `data.ads.attachments.files` (object)

  - `data.ads.attachments.files.type` (string)
    Enum: "image", "video", "clip"

  - `data.ads.owner` (object)

  - `data.ads.owner.domain` (string)
    Domain name
    Example: "google.com"

  - `data.ads.owner.title` (string)
    Domain's sanitized name to show
    Example: "google"

  - `data.ads.owner.icon` (string)
    Domain's icon path
    Example: "https://cdn.adflex.io/example-100x100.png"

  - `data.ads.locations` (array)

  - `data.ads.locations.label` (string)
    Example: "Netherlands"

  - `data.current_page` (integer)
    Current request page
    Example: 1

  - `data.has_next_page` (boolean)
    Defines that next page has ads or not

  - `data.last_hit` (integer)
    after first page send the current timestamp in seconds
    Example: 12321321