api
Changelog
What changed in the API, newest first.
Updated · API v1
Compatibility
Within v1, Adspy adds routes, optional parameters, fields and error codes without notice; clients should ignore what they do not know. Removing or renaming a field, a route or a code, or changing a meaning, comes with a new version and at least 90 days of notice.
1.0.0 (October 2026)
- First version: brands, creatives and their analyses, similar creatives, advertisers, fetches, social accounts and posts, posts run as ads, X-Ray, social reports, Full Analysis, comparisons, collections, exports and usage.
- RFC 9457 problem details, signed cursors, Idempotency-Key on every POST, RateLimit headers.
- OpenAPI 3.1 description at adspy.sh/openapi.json.