Skip to content
/
Search in display ads

Adflex API Documentation (1.0.0)

Learn how to use the Adflex API to access millions of ads data from top platforms, with guides, filters, endpoints, and integration examples for developers.

Languages
Servers
Server
https://api.adflex.io/api/{version}/

Facebook

Operations

Meta

Operations

Native

Operations

Display

Operations

Get search filters

Request

Query
api_keystringrequired

Your API Key token.

Default "YOUR_API_KEY_HERE"
curl -i -X GET \
  'https://api.adflex.io/api/v1/filters/display/search?api_key=YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json
statusstringrequired
Enum"ok""failed"
metaobjectrequired
meta.​codeinteger
Example: 1000
meta.​messagestring or null
Example: null
dataobject(FilterGroup)required
Example: {"key":null,"label":"Targeting","icon":"target","collapse":false,"description":null,"mode":"advanced","filters":[],"relations":[["countries","exact_country"]]}
data.​filtersArray of objects
Example: []
data.​relationsArray of strings
Example: [["countries","exact_country"]]
Response
application/json
{
  "status": "ok",
  "meta": {
    "code": 1000,
    "message": null
  },
  "data": {
    "filters": [ … ],
    "relations": [ … ]
  }
}

Get publishers items

Request

Query
api_keystringrequired

Your API Key token.

Default "YOUR_API_KEY_HERE"
searchstringrequired

The text to be searched

Example: search=a
idsArray of integers

The ids separated by comma

Example: ids=49,114
curl -i -X GET \
  'https://api.adflex.io/api/v1/display/filter/publishers/items?api_key=YOUR_API_KEY_HERE&search=a&ids=49%2C114'

Responses

OK

Bodyapplication/json
statusstringrequired
Enum"ok""failed"
metaobjectrequired
meta.​codeinteger
Example: 1000
meta.​messagestring or null
Example: null
dataArray of objectsrequired
data[].​keyinteger or string

Item key

One of:

Item key

integer
data[].​labelstring or null

Item value

data[].​iconstring or null

Item icon if available

Response
application/json
{
  "status": "ok",
  "meta": {
    "code": 1000,
    "message": null
  },
  "data": [
    { … },
    { … },
    { … },
    { … }
  ]
}

Search in display ads

Request

Bodyapplication/jsonrequired
api_keystring

Your API Key token.

Example: "YOUR_API_KEY_HERE"
last_hitinteger

after first page send the current timestamp in seconds

pageinteger
Default 1
Example: 1
orderbystring
Default "updated_at"
Enum"updated_at""oldest""impressions""days_active""domain.traffic"
Example: "updated_at"
curl -i -X POST \
  https://api.adflex.io/api/v1/display/ads/search \
  -H 'Content-Type: application/json' \
  -d '{
    "api_key": "YOUR_API_KEY_HERE",
    "page": 1,
    "orderby": "updated_at",
    "networks": [
      19481,
      19484
    ],
    "publishers": [
      49,
      31
    ],
    "search_field": [
      {
        "type": "text",
        "text": "skills"
      },
      {
        "type": "without_owner_name",
        "text": "codefinity.com"
      }
    ]
  }'

Responses

OK

Bodyapplication/json
statusstringrequired
Enum"ok""failed"
metaobjectrequired
meta.​codeinteger
Example: 1000
meta.​messagestring or null
Example: null
dataobjectrequired
data.​adsArray of objects
data.​current_pageinteger

Current request page

Example: 1
data.​has_next_pageboolean

Defines that next page has ads or not

data.​last_hitinteger

after first page send the current timestamp in seconds

Example: 12321321
Response
application/json
{
  "status": "ok",
  "meta": {
    "code": 1000,
    "message": null
  },
  "data": {
    "ads": [ … ],
    "current_page": 1,
    "has_next_page": true,
    "last_hit": 12321321
  }
}

Get ad's details

Request

Path
adintegerrequired

Ad id

Query
api_keystringrequired

Your API Key token.

Default "YOUR_API_KEY_HERE"
curl -i -X GET \
  'https://api.adflex.io/api/v1/display/ads/{ad}?api_key=YOUR_API_KEY_HERE'

Responses

OK

Bodyapplication/json
statusstringrequired
Enum"ok""failed"
metaobjectrequired
meta.​codeinteger
Example: 1000
meta.​messagestring or null
Example: null
dataobjectrequired
data.​dataobject
Response
application/json
{
  "status": "ok",
  "meta": {
    "code": 1000,
    "message": null
  },
  "data": {
    "data": { … }
  }
}

Pinterest

Operations

Reddit

Operations

Tiktok

Operations

X

Operations

Youtube

Operations