# Search Display ads

Endpoint: POST /v2/ads/display/search
Version: 2.0.0
Security: ApiKeyAuth

## Request fields (application/json):

  - `last_hit` (integer)
    Snapshot timestamp returned in data.last_hit by the page 1 response. Omit this field for page 1. For page 2 and later, resend the original value unchanged while using the same filters and sorting. This value does not expire.

  - `page` (integer)
    Requested page number. Each page returns up to 18 ads. The page size is fixed and cannot be changed.

  - `advanced_order` (object)

  - `advanced_order.orderby` (string)

  - `advanced_order.order` (string)

  - `placements` (array)

  - `networks` (array)

  - `publishers` (array)

  - `search_field` (array)

  - `search_field.type` (string)

  - `search_field.text` (string)

## Response 200 fields (application/json):

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

  - `meta` (object, required)

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

  - `meta.message` (string)
    Example: null

  - `data` (object, required)

  - `data.ads` (array)

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

  - `data.ads.is_bookmarked` (boolean)
    Example: true

  - `data.ads.platform` (string)
    Example: display

  - `data.ads.display_url` (string)
    Ad's target domain
    Example: google.com

  - `data.ads.similarweb` (integer)
    Estimated monthly domain visits
    Example: 1500

  - `data.ads.last_seen` (string)
    last updated time
    Example: 10 minutes ago

  - `data.ads.owner` (object)

  - `data.ads.owner.id` (integer)
    Example: 100

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

  - `data.ads.owner.avatar_url` (string)
    Example: https://cdn.adflex.io/example-100x100.png

  - `data.ads.attachments` (array)

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

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

  - `data.ads.attachments.url` (string)
    For video attachments, the video URL; for image attachments, the image URL
    Example: https://cdn.adflex.io/example-1440x1446.jpg

  - `data.ads.attachments.thumbnail` (string)
    Thumbnail URL for video attachments
    Example: https://cdn.adflex.io/example-100x100.png

  - `data.ads.metadata` (array)
    Example: [{"tooltip":"Region","value":["flag-ar","flag-de","flag-fr"]},{"tooltip":"Platform","value":"Google"},{"tooltip":"Days Running","value":"15 Days"}]

  - `data.ads.metadata.tooltip` (string)

  - `data.ads.metadata.value` (any)

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

  - `data.has_next_page` (boolean)
    Indicates whether more results are available

  - `data.last_hit` (integer)
    The timestamp in seconds used for snapshot pagination
    Example: 12321321