Skip to content
Endless Documentation

Instagram search

POST
/social/instagram_search

Search Instagram REELS by keyword — what people, not just the official account, are posting about an event, brand, person or topic. Results are ranked by relevance, not date, and match captions and hashtags: a reel whose caption never names the term won't appear. For social listening, run a few queries (the event name, the official @account, the featured people together with the event) and read the official account's own feed with instagram_user_reels. Reels only — photos and carousels come from instagram_hashtag_posts.

Authorization

bearerAuth
AuthorizationBearer <token>

JWT token from authentication

In: header

Header Parameters

Endless-Api-Version?string

Pin the caller to an API major (1). Omit to accept the current version. A major this deployment cannot serve is refused with 400 unsupported_api_version.

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://example.com/social/instagram_search" \  -H "Content-Type: application/json" \  -d '{    "organization_id": "string",    "input": {      "query": "string"    }  }'
{  "operation": "instagram_profile",  "result": {    "summary": "string",    "query": "string",    "count": -9007199254740991,    "truncated": true,    "items": [      {        "pk": "string",        "id": "string",        "code": "string",        "media_type": 0,        "product_type": "string",        "taken_at": 0,        "like_count": 0,        "comment_count": 0,        "play_count": 0,        "view_count": 0,        "permalink": "string",        "caption_text": "string",        "image_url": "string",        "carousel_image_urls": [          "string"        ],        "author": "string"      }    ]  },  "requests": 0,  "credits_charged": 0}