API reference · Platforms, status and usage

Takedown feed: ads and advertisers deleted after a takedown or erasure request

GET/v1/erasures

Oldest first and free of charge. Poll it with next_cursor and remove your own copies of what it lists.

Example request

Shell
curl "https://api.adlibapi.com/v1/erasures" \
  -H "X-API-Key: $ADLIB_API_KEY"

Send your key in the X-API-Key header. Try it in the explorer.

Parameters

cursor
string

From next_cursor of the previous page

since
datetime

Only entries from this time on (RFC 3339)

limit
integer

default 100

Response

data.erased_atrequired
datetime
–
data.idrequired
string

Deleted ad or advertiser id, <platform>:<id>

data.kindrequired
string

advertiser = the advertiser and all its ads

One of ad, advertiser

data.media_sha256required
string[]

Files deleted with it; the sha256 values the API showed on their media entries

next_cursorrequired
string

Keep it for the next poll: it also works when this page was the last