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
| Name | Required | Description | Example |
|---|---|---|---|
query | Yes | The keyword or phrase to search for. | social listening |
raw | No | Include 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'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
}