# Search in meta ads

Endpoint: POST /meta/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", "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.is_active` (integer)
    Enum: 0, 1

  - `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.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-1440x1446.jpg"

  - `data.ads.attachments.subtitle` (string,null)

  - `data.ads.attachments.description` (string,null)

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

  - `data.ads.owner` (object)

  - `data.ads.owner.avatar_url` (string)
    Example: "https://cdn.adflex.io/example-148x148.jpg"

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

  - `data.ads.owner.is_verified` (boolean)

  - `data.ads.locations` (array)

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

  - `data.ads.publisher_platforms` (array)

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