Search Instagram

/api/v1/instagram/search

Search public Instagram users, hashtags, and places by keyword. Returns normalized discovery results, without post content.

Endpoint

  • Path: /api/v1/instagram/search
  • Cost: 1 credit per successful request

Query parameters

NameRequiredDescriptionExample
queryYesThe keyword or phrase to search for.social listening
rawNoInclude the unchanged provider response in the raw field. Defaults to false.true
curl --get 'https://api.sociallisteningapi.com/api/v1/instagram/search' \
  --data-urlencode 'query=social listening' \
  --data-urlencode 'raw=true' \
  --header 'x-api-key: YOUR_API_KEY'

GET request using cURL.

Responses

{
  "success": true,
  "platform": "instagram",
  "endpoint": "/api/v1/instagram/search",
  "data": {
    "items": [
      {
        "id": "25025320",
        "platform": "instagram",
        "type": "user",
        "name": "Instagram",
        "username": "instagram",
        "url": "https://www.instagram.com/instagram/",
        "image_url": "https://example.com/instagram.jpg",
        "verified": true,
        "count": null,
        "ext": {
          "position": 0
        }
      }
    ]
  },
  "pagination": {
    "next_cursor": null,
    "has_more": false,
    "page_size": 1
  },
  "raw": {
    "success": true,
    "credits_remaining": 99,
    "credits_charged": 1,
    "data": {
      "query": "instagram",
      "users": [],
      "hashtags": [],
      "places": [],
      "keywords": [],
      "rank_token": "example-rank-token"
    }
  },
  "request_id": "req_example123",
  "credits_used": 1,
  "credits_remaining": 99
}

Request completed successfully.