# Get ad's details

Endpoint: GET /ads/reddit/{ad}
Version: 2.0.0

## Query parameters:

  - `api_key` (string, required)
    Your API Key token.

## Path parameters:

  - `ad` (integer, required)
    Ad id

## 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.id` (integer)
    Example: 100

  - `data.post_url` (string)
    Ad's url in reddit
    Example: "https://reddit.com/10000"

  - `data.card` (object)

  - `data.card.title` (string)
    Example: "Test Title"

  - `data.card.subtitle` (string)
    Example: "Test subtitle"

  - `data.card.description` (string)
    Example: "Test description"

  - `data.card.cta` (string)
    cta name
    Example: "send message"

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

  - `data.card.owner` (object)

  - `data.card.owner.id` (integer)
    Example: 100000

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

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

  - `data.card.attachments` (array)

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

  - `data.card.attachments.url` (string)
    Example: "https://cdn.adflex.io/example-1440x1446.jpg"

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

  - `data.impression` (object)

  - `data.impression.total` (integer)
    number of seens
    Example: 100

  - `data.impression.days_running` (integer)
    Ad's active days
    Example: 100

  - `data.impression.devices` (object)

  - `data.impression.devices.value_type` (string)
    Example: "percentage"

  - `data.impression.devices.datasets` (array)

  - `data.impression.devices.datasets.label` (string)
    Example: "Desktop"

  - `data.impression.devices.datasets.value` (number)
    Example: 100

  - `data.impression.devices.datasets.key` (string)
    Example: "Desktop"

  - `data.impression.publish_at` (string)
    Example: "2022-06-28T09:07:10.000000Z"

  - `data.impression.first_seen_at` (string)
    Example: "2022-06-28T09:07:10.000000Z"

  - `data.impression.last_seen_at` (string)
    Example: "2022-06-28T09:07:10.000000Z"

  - `data.targeting_detail` (object)

  - `data.targeting_detail.cards` (array)
    Example: [{"label":"Gender","value":"Any","key":"gender","icon":"gender"},{"label":"Tracker","value":"N/A","key":"tracker","icon":"magnifier-zoom-in"},{"label":"Affiliate Network","value":"Test","key":"affiliate_network","icon":"network"}]

  - `data.targeting_detail.cards.label` (string)

  - `data.targeting_detail.cards.value` (string)

  - `data.targeting_detail.cards.key` (string)

  - `data.targeting_detail.cards.icon` (string)

  - `data.targeting_detail.tabs` (array)
    Example: [{"key":"region","label":"Region","breakdown":{"value_type":"percentage","datasets":[{"label":"France","value":80,"icon":"flag-fr"},{"label":"Germany","value":20,"icon":"flag-de"}]}},{"key":"placement","label":"Placement","breakdown":{"value_type":"percentage","datasets":[{"label":"Test","value":100}]}},{"key":"interest","label":"Interest","breakdown":{"value_type":"percentage","datasets":[{"label":"Test","value":100}]}},{"key":"language","label":"Language","breakdown":{"value_type":"percentage","datasets":[{"label":"French","value":100}]}},{"key":"os","label":"OS","breakdown":{"value_type":"percentage","datasets":[{"label":"Windows","value":100}]}}]

  - `data.targeting_detail.tabs.key` (string)

  - `data.targeting_detail.tabs.label` (string)

  - `data.targeting_detail.tabs.breakdown` (object)

  - `data.targeting_detail.tabs.breakdown.value_type` (string)

  - `data.targeting_detail.tabs.breakdown.datasets` (array)

  - `data.targeting_detail.tabs.breakdown.datasets.label` (string)

  - `data.targeting_detail.tabs.breakdown.datasets.value` (number)

  - `data.targeting_detail.tabs.breakdown.datasets.icon` (string)

  - `data.engagement_data` (object)
    Example: {"score":2000,"growth_last_month":"100%","lifetime":{"growth":{"value":"100%","timeline":{"value_type":"percentage","datasets":[{"key":"2026-05-01","label":"May 2026","value":0},{"key":"2026-06-01","label":"Jun 2026","value":100}]}},"timeline":{"value_type":"numeric","metrics":[{"key":"upvotes","label":"Upvote"},{"key":"comments","label":"Comment"}],"datasets":[{"key":"2026-05-01","label":"May 2026","values":{"upvotes":0,"comments":0}},{"key":"2026-06-01","label":"Jun 2026","values":{"upvotes":1195,"comments":2}}]},"breakdown":{"value_type":"numeric","datasets":[{"key":"upvotes","label":"Upvote","value":1195},{"key":"comments","label":"Comment","value":2}]}},"last_month":{"growth":{"value":"100%","timeline":{"value_type":"percentage","datasets":[{"key":"2026-05-22","label":"May 22, 2026","value":0},{"key":"2026-06-05","label":"Jun 05, 2026","value":100}]}},"timeline":{"value_type":"numeric","metrics":[{"key":"upvotes","label":"Upvote"},{"key":"comments","label":"Comment"}],"datasets":[{"key":"2026-05-22","label":"May 22, 2026","values":{"upvotes":0,"comments":0}},{"key":"2026-06-05","label":"Jun 05, 2026","values":{"upvotes":1195,"comments":2}}]},"breakdown":{"value_type":"numeric","datasets":[{"key":"upvotes","label":"Upvote","value":1195},{"key":"comments","label":"Comment","value":2}]}}}

  - `data.engagement_data.score` (integer)
    Example: 2000

  - `data.engagement_data.growth_last_month` (number)
    Example: "100%"

  - `data.engagement_data.lifetime` (object)
    Example: {"growth":{"value":"100%","timeline":{"value_type":"percentage","datasets":[{"key":"2026-05-01","label":"May 2026","value":0},{"key":"2026-06-01","label":"Jun 2026","value":100}]}},"timeline":{"value_type":"numeric","metrics":[{"key":"upvotes","label":"Upvote"},{"key":"comments","label":"Comment"}],"datasets":[{"key":"2026-05-01","label":"May 2026","values":{"upvotes":0,"comments":0}},{"key":"2026-06-01","label":"Jun 2026","values":{"upvotes":1195,"comments":2}}]},"breakdown":{"value_type":"numeric","datasets":[{"key":"upvotes","label":"Upvote","value":1195},{"key":"comments","label":"Comment","value":2}]}}

  - `data.engagement_data.lifetime.growth` (object)
    Example: {"value":"100%","timeline":{"value_type":"percentage","datasets":[{"key":"2026-05-01","label":"May 2026","value":0},{"key":"2026-06-01","label":"Jun 2026","value":100}]}}

  - `data.engagement_data.lifetime.growth.value` (number)
    Example: "100%"

  - `data.engagement_data.lifetime.growth.timeline` (object)
    Example: {"value_type":"percentage","datasets":[{"key":"2026-05-01","label":"May 2026","value":0},{"key":"2026-06-01","label":"Jun 2026","value":100}]}

  - `data.engagement_data.lifetime.growth.timeline.value_type` (string)
    Example: "percentage"

  - `data.engagement_data.lifetime.growth.timeline.datasets` (array)
    Example: [{"key":"2026-05-01","label":"May 2026","value":0},{"key":"2026-06-01","label":"Jun 2026","value":100}]

  - `data.engagement_data.lifetime.growth.timeline.datasets.key` (string)

  - `data.engagement_data.lifetime.growth.timeline.datasets.label` (string)

  - `data.engagement_data.lifetime.growth.timeline.datasets.value` (integer)

  - `data.engagement_data.lifetime.timeline` (object)
    Example: {"value_type":"numeric","metrics":[{"key":"upvotes","label":"Upvote"},{"key":"comments","label":"Comment"}],"datasets":[{"key":"2026-05-01","label":"May 2026","values":{"upvotes":0,"comments":0}},{"key":"2026-06-01","label":"Jun 2026","values":{"upvotes":1195,"comments":2}}]}

  - `data.engagement_data.lifetime.timeline.value_type` (string)
    Example: "numeric"

  - `data.engagement_data.lifetime.timeline.metrics` (array)
    Example: [{"key":"upvotes","label":"Upvote"},{"key":"comments","label":"Comment"}]

  - `data.engagement_data.lifetime.timeline.metrics.key` (string)

  - `data.engagement_data.lifetime.timeline.metrics.label` (string)

  - `data.engagement_data.lifetime.timeline.datasets` (array)
    Example: [{"key":"2026-05-01","label":"May 2026","values":{"upvotes":0,"comments":0}},{"key":"2026-06-01","label":"Jun 2026","values":{"upvotes":1195,"comments":2}}]

  - `data.engagement_data.lifetime.timeline.datasets.key` (string)

  - `data.engagement_data.lifetime.timeline.datasets.label` (string)

  - `data.engagement_data.lifetime.timeline.datasets.values` (object)

  - `data.engagement_data.lifetime.timeline.datasets.values.upvotes` (integer)

  - `data.engagement_data.lifetime.timeline.datasets.values.comments` (integer)

  - `data.engagement_data.lifetime.breakdown` (object)
    Example: {"value_type":"numeric","datasets":[{"key":"upvotes","label":"Upvote","value":1195},{"key":"comments","label":"Comment","value":2}]}

  - `data.engagement_data.lifetime.breakdown.value_type` (string)
    Example: "numeric"

  - `data.engagement_data.lifetime.breakdown.datasets` (array)
    Example: [{"key":"upvotes","label":"Upvote","value":1195},{"key":"comments","label":"Comment","value":2}]

  - `data.engagement_data.lifetime.breakdown.datasets.key` (string)

  - `data.engagement_data.lifetime.breakdown.datasets.label` (string)

  - `data.engagement_data.lifetime.breakdown.datasets.value` (integer)

  - `data.engagement_data.last_month` (object)
    Example: {"growth":{"value":"100%","timeline":{"value_type":"percentage","datasets":[{"key":"2026-05-22","label":"May 22, 2026","value":0},{"key":"2026-06-05","label":"Jun 05, 2026","value":100}]}},"timeline":{"value_type":"numeric","metrics":[{"key":"upvotes","label":"Upvote"},{"key":"comments","label":"Comment"}],"datasets":[{"key":"2026-05-22","label":"May 22, 2026","values":{"upvotes":0,"comments":0}},{"key":"2026-06-05","label":"Jun 05, 2026","values":{"upvotes":1195,"comments":2}}]},"breakdown":{"value_type":"numeric","datasets":[{"key":"upvotes","label":"Upvote","value":1195},{"key":"comments","label":"Comment","value":2}]}}

  - `data.engagement_data.last_month.growth` (object)
    Example: {"value":"100%","timeline":{"value_type":"percentage","datasets":[{"key":"2026-05-22","label":"May 22, 2026","value":0},{"key":"2026-06-05","label":"Jun 05, 2026","value":100}]}}

  - `data.engagement_data.last_month.growth.value` (number)
    Example: "100%"

  - `data.engagement_data.last_month.growth.timeline` (object)
    Example: {"value_type":"percentage","datasets":[{"key":"2026-05-22","label":"May 22, 2026","value":0},{"key":"2026-06-05","label":"Jun 05, 2026","value":100}]}

  - `data.engagement_data.last_month.growth.timeline.value_type` (string)
    Example: "percentage"

  - `data.engagement_data.last_month.growth.timeline.datasets` (array)
    Example: [{"key":"2026-05-22","label":"May 22, 2026","value":0},{"key":"2026-06-05","label":"Jun 05, 2026","value":100}]

  - `data.engagement_data.last_month.growth.timeline.datasets.key` (string)

  - `data.engagement_data.last_month.growth.timeline.datasets.label` (string)

  - `data.engagement_data.last_month.growth.timeline.datasets.value` (integer)

  - `data.engagement_data.last_month.timeline` (object)
    Example: {"value_type":"numeric","metrics":[{"key":"upvotes","label":"Upvote"},{"key":"comments","label":"Comment"}],"datasets":[{"key":"2026-05-22","label":"May 22, 2026","values":{"upvotes":0,"comments":0}},{"key":"2026-06-05","label":"Jun 05, 2026","values":{"upvotes":1195,"comments":2}}]}

  - `data.engagement_data.last_month.timeline.value_type` (string)
    Example: "numeric"

  - `data.engagement_data.last_month.timeline.metrics` (array)
    Example: [{"key":"upvotes","label":"Upvote"},{"key":"comments","label":"Comment"}]

  - `data.engagement_data.last_month.timeline.metrics.key` (string)

  - `data.engagement_data.last_month.timeline.metrics.label` (string)

  - `data.engagement_data.last_month.timeline.datasets` (array)
    Example: [{"key":"2026-05-22","label":"May 22, 2026","values":{"upvotes":0,"comments":0}},{"key":"2026-06-05","label":"Jun 05, 2026","values":{"upvotes":1195,"comments":2}}]

  - `data.engagement_data.last_month.timeline.datasets.key` (string)

  - `data.engagement_data.last_month.timeline.datasets.label` (string)

  - `data.engagement_data.last_month.timeline.datasets.values` (object)

  - `data.engagement_data.last_month.timeline.datasets.values.upvotes` (integer)

  - `data.engagement_data.last_month.timeline.datasets.values.comments` (integer)

  - `data.engagement_data.last_month.breakdown` (object)
    Example: {"value_type":"numeric","datasets":[{"key":"upvotes","label":"Upvote","value":1195},{"key":"comments","label":"Comment","value":2}]}

  - `data.engagement_data.last_month.breakdown.value_type` (string)
    Example: "numeric"

  - `data.engagement_data.last_month.breakdown.datasets` (array)
    Example: [{"key":"upvotes","label":"Upvote","value":1195},{"key":"comments","label":"Comment","value":2}]

  - `data.engagement_data.last_month.breakdown.datasets.key` (string)

  - `data.engagement_data.last_month.breakdown.datasets.label` (string)

  - `data.engagement_data.last_month.breakdown.datasets.value` (integer)

  - `data.url_chain` (array)

  - `data.url_chain.id` (integer)
    Url chain's id
    Example: 100

  - `data.url_chain.url` (string)
    first valid url
    Example: "https://www.adobe.com/marketing/experience-manager.html"

  - `data.url_chain.count` (integer)
    number of seen counts
    Example: 100

  - `data.domain` (object)

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

  - `data.domain.monthly_visit` (integer)
    Example: 1000

  - `data.domain.age` (string)
    Example: "7 years"

  - `data.domain.timeline` (object)

  - `data.domain.timeline.value_type` (string)
    Example: "percentage"

  - `data.domain.timeline.datasets` (array)

  - `data.domain.timeline.datasets.label` (string)
    Example: "Mar 2026"

  - `data.domain.timeline.datasets.value` (number)
    Example: 95.2

  - `data.domain.timeline.datasets.key` (string)
    Example: "2026-01-01"