List Instagram media

GET

api

accounts

{accountId}

media

List Instagram media

curl --request GET \
  --url https://levios.app/api/v1/accounts/{accountId}/media \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://levios.app/api/v1/accounts/{accountId}/media', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "error": {
    "code": "api_invalid_content_length",
    "message": "Invalid Content-Length.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_unauthorized",
    "message": "Authentication required.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_account_not_granted",
    "message": "This credential is not authorized for the request.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_automation_media_not_found",
    "message": "The referenced Instagram media was not found.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_body_too_large",
    "message": "The JSON request body exceeds 1 MiB.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_unsupported_media_type",
    "message": "Content-Type must be application/json.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_automation_invalid_configuration",
    "message": "Configuration fields do not match the public automation contract.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_internal_error",
    "message": "The request could not be completed.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_account_resolution_unavailable",
    "message": "The reachable account set could not be read.",
    "correlation_id": "<string>"
  }
}

Use this endpoint to discover the posts or stories of one Instagram account. Pass the account UUID in the path and surface in the query string. Your API key needs the automations:read scope and access to that account. surface is required and accepts posts or stories. Each item carries id, surface, media_type, caption, thumbnail_url, instagram_url, published_at, like_count, and comments_count. Every field except id and surface can be null when Instagram does not return a value for it.

Reference a publication in a trigger

A comment trigger can bind to one post. Use a returned id as the reference value:

{
  "publication": {
    "mode": "specific",
    "reference": {
      "type": "id",
      "value": "<INSTAGRAM_MEDIA_ID>"
    }
  }
}

A comment trigger also accepts a public post address. Send url as the reference type and the address as value. A story reply or story reaction trigger accepts only the id reference type, so this endpoint is the way to bind one. Read Update an automation for the complete trigger shape.

Paginate the results

Set limit to an integer from 1 through 50. When next_cursor is a string, pass it back unchanged as cursor to request the next page. A null next_cursor means you reached the end of the list. This read does not change any automation, so it is safe to retry. When Instagram cannot be reached, the API returns 503 with api_instagram_media_unavailable. That response is temporary and does not mean the account is unreachable.

Example request

curl --get \
  --url "https://levios.app/api/v1/accounts/${LEVIOS_ACCOUNT_ID}/media" \
  --header "Authorization: Bearer ${LEVIOS_API_KEY}" \
  --data-urlencode 'surface=posts' \
  --data-urlencode 'limit=25'

Authorizations

Authorization

string

header

required

Levios API key sent as a Bearer token.

Path Parameters

accountId

string<uuid>

required

Query Parameters

cursor

string

limit

string

surface

enum<string>

required

Available options:

posts,

stories

Response

Successful response.

List Instagram media

curl --request GET \
  --url https://levios.app/api/v1/accounts/{accountId}/media \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://levios.app/api/v1/accounts/{accountId}/media', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "error": {
    "code": "api_invalid_content_length",
    "message": "Invalid Content-Length.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_unauthorized",
    "message": "Authentication required.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_account_not_granted",
    "message": "This credential is not authorized for the request.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_automation_media_not_found",
    "message": "The referenced Instagram media was not found.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_body_too_large",
    "message": "The JSON request body exceeds 1 MiB.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_unsupported_media_type",
    "message": "Content-Type must be application/json.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_automation_invalid_configuration",
    "message": "Configuration fields do not match the public automation contract.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "rate_limited",
    "message": "Rate limit exceeded.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_internal_error",
    "message": "The request could not be completed.",
    "correlation_id": "<string>"
  }
}

{
  "error": {
    "code": "api_account_resolution_unavailable",
    "message": "The reachable account set could not be read.",
    "correlation_id": "<string>"
  }
}

Reference

Automations

Accounts

Contacts

Contact tags

Metrics

List Instagram media

Reference a publication in a trigger

Paginate the results

Example request

Authorizations

Path Parameters

Query Parameters

Response

​Reference a publication in a trigger

​Paginate the results

​Example request

Authorizations

Path Parameters

Query Parameters

Response

Reference a publication in a trigger

Paginate the results

Example request