Skip to main content
GET
Search Instagram posts (live)

Authorizations

Authorization
string
header
required

XPOZ API access key, created from the dashboard or POST /api/tokens. Send as Authorization: Bearer <access key>.

Query Parameters

q
string
required

Search query (Lucene-style keyword syntax). Must not be blank.

fields
enum<string>[]

Instagram post fields to return. Comma-separated. Allowed values: id, postType, userId, username, fullName, caption, mediaType, codeUrl, imageUrl, videoUrl, audioOnlyUrl, profilePicUrl, videoSubtitlesUri, subtitles, likeCount, commentCount, reshareCount, mediaRepostCount, saveCount, videoPlayCount, videoDuration, createdAt, createdAtTimestamp, createdAtDate, location, genAiChatWithAiCtaInfo, hasHighRiskGenAiInformTreatment.

Available options:
id,
postType,
userId,
username,
fullName,
caption,
mediaType,
codeUrl,
imageUrl,
videoUrl,
audioOnlyUrl,
profilePicUrl,
videoSubtitlesUri,
subtitles,
likeCount,
commentCount,
reshareCount,
mediaRepostCount,
saveCount,
videoPlayCount,
videoDuration,
createdAt,
createdAtTimestamp,
createdAtDate,
location,
genAiChatWithAiCtaInfo,
hasHighRiskGenAiInformTreatment
cursor
string

Opaque cursor from next_page_cursor of the previous page.

Response

One page of results.

Envelope for on-demand /live endpoints: one provider page plus a cursor.

results
object[]
required
count
integer
required
dataSource
enum<string>
required

Where the results came from.

Available options:
database,
api,
hybrid
has_more
boolean
required
next_page_cursor
string | null
required