api
Instagram is not available in the API
Instagram accounts and posts stay out of the API. Meta ads, including those on Instagram placements, stay in.
Updated · API v1
Why
Adspy reads Instagram accounts and posts through Meta's platform, whose terms do not allow passing that data on to another service. The API is built for server-to-server reuse, so it leaves Instagram out. Instagram stays available in Adspy's MCP server, inside your assistant.
What the API does
- A request that names Instagram (platform=instagram, an Instagram account or post id, an Instagram profile link, an export of Instagram data) answers 422 instagram_not_in_api.
- Mixed results leave Instagram out: brand social platforms, accounts, posts, posts run as ads, reports, comparisons and exports.
- A number computed over every platform, Instagram included, is withheld (null) rather than shown with Instagram inside it; the answer then carries instagram_excluded: true.
- Social exports name tiktok or youtube. The brand social report export is not offered.
- Meta ads are unaffected: ads Meta shows on Instagram placements are ads, and stay in every creative route.
HTTP/1.1 422 Unprocessable Content
Content-Type: application/problem+json
X-Request-Id: 3f5b9c2e-8d41-4a7e-9b0c-6e2d1f4a8c37
{
"type": "https://www.adspy.sh/docs/api/errors/instagram-not-in-api",
"title": "Instagram is not available in the API",
"status": 422,
"detail": "Instagram data is not available in the Adspy API. Use tiktok or youtube.",
"code": "instagram_not_in_api",
"request_id": "3f5b9c2e-8d41-4a7e-9b0c-6e2d1f4a8c37",
"instance": "/api/v1/social/posts"
}