Sign inConnect your AI
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.
Answer
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"
}