# Search in x ads

Endpoint: POST /x/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: "popularity", "updated_at", "oldest", "seen_counts", "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.display_url` (string,null)
    Ad's target link
    Example: "google.com"

  - `data.ads.engagements` (object)

  - `data.ads.engagements.reposts` (integer)
    Example: 100

  - `data.ads.engagements.replies` (integer)
    Example: 100

  - `data.ads.engagements.likes` (integer)
    Example: 100

  - `data.ads.duration` (integer,null)
    video duration
    Example: 100

  - `data.ads.seen_counts` (integer)
    number of seen counts
    Example: 100

  - `data.ads.updated_at` (string)
    last updated time
    Example: "2022-06-28T09:07:10.000000Z"

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

  - `data.ads.attachments` (array)

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

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

  - `data.ads.attachments.files.main` (string)
    Example: "https://cdn.adflex.io/example-100x100.png"

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

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

  - `data.ads.owner` (object)

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

  - `data.ads.owner.avatar_url` (string)
    Owner's avatar url
    Example: "https://cdn.adflex.io/example-100x100.png"

  - `data.ads.owner.is_blue_verified` (boolean)
    Owner is verified

  - `data.ads.locations` (array)

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

  - `data.ads.placements` (array)

  - `data.ads.placements.code` (any)
    Placement's code
    Example: 200

  - `data.ads.placements.label` (any)
    Placement's name
    Example: "In Stream"

  - `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