Instagram hashtag video/Reels scraper with chosen output fields and date, engagement and literal caption filters. Beta: one hashtag, up to 20 rows; popular-source availability varies. $0.01/start + $0.001/output row. No Instagram login.
JSON array containing exactly one {hashtag, limit}. The per-hashtag output quota is 1–20 and defaults to 20 when omitted; enough qualifying source records are not guaranteed.
Type:object[]
Min. items:1
Max. items:1
Maximum unique beta output rows
maxItems
Optional
Maximum unique qualifying beta output records, from 1 to 20; defaults to 20. A smaller source sample or spending allowance can reduce delivery.
Type:integer
Minimum:1
Maximum:20
Default:20
Metric scope
metricScope
Optional
Source-reported likes/comments may reflect a broader platform scope and are not verified Instagram-only counts. Strict Instagram leaves optional unsupported metrics null and rejects active likes/comments minima or required likes/comments. Plays/shares are unavailable in this product.
Type:string
Default:source_reported
Options:
source_reportedinstagram
Output fields
fields
Optional
Select output fields. Dates, owner and supported source-reported likes/comments are acquired when projected, required or needed by a filter. The existing default fields include dates, likes and comments. Unsupported optional plays/shares and strict-scope metrics remain null. Required fields still apply when omitted from this projection.
Type:string[]
Min. items:1
Default:
[
"id",
"url",
"contentType",
"caption",
"publishedAt",
"likesCount",
"commentsCount",
"playsCount",
"metricScope",
"matchedHashtags",
"selectedForHashtags"
]
Required available fields
requiredFields
Optional
Fields that must be available for a record to qualify, independently of output projection. Dates and owner are supported in both scopes; likes/comments only in source_reported. Required plays/shares or strict Instagram likes/comments fail before acquisition.
Type:string[]
Default:
[
"id",
"url"
]
Published at or after
publishedAfter
Optional
Absolute ISO timestamp with a timezone, inclusive. No relative dates.
Type:string
Published before
publishedBefore
Optional
Absolute ISO timestamp with a timezone, exclusive. Must follow publishedAfter.
Type:string
Minimum likes
minLikes
Optional
Optional source-reported minimum. Explicit zero requires a known value; missing or hidden likes do not pass. Unsupported in strict Instagram scope.
Type:integer
Minimum:0
Maximum:9007199254740991
Minimum comments
minComments
Optional
Optional source-reported minimum. Explicit zero requires a known value; missing comments do not pass. Unsupported in strict Instagram scope.
Type:integer
Minimum:0
Maximum:9007199254740991
Maximum source candidates
candidatesPerHashtag
Optional
Inspect at most this many popular-video candidates for the one hashtag, from 1 to 100. Separate from desired output quantity; candidates need not match all filters or provide every required field.
Type:integer
Minimum:1
Maximum:100
Default:100
Acquisition timeout in seconds
timeoutSecs
Optional
Bounded source acquisition deadline, from 30 to 120 seconds. The parent run must leave at least another 30 seconds for processing and output confirmation.
Type:integer
Minimum:30
Maximum:120
Default:120
Allow partial source acquisition
allowPartial
Optional
Allow valid records from an incomplete source and retain an explicit partial report. Disable to reject incomplete acquisition. A filled output quota does not prove a complete source.
Type:boolean
Default:true
Optional literal caption relevance
relevance
Optional
Literal consecutive caption words, normalized with trim, NFKC and lowercase; punctuation separates words, while diacritics and scripts remain distinct. includeAny and localityAny each require at least one phrase from the caption body after removing hashtags, mentions and URLs; excludeAny rejects matches anywhere in the full caption, including hashtags. Empty arrays impose no extra condition. At most20 unique phrases per array,1–80 characters each; no leading #/@, URLs, domains, paths, control characters or contradictory required/excluded phrases. This checks text evidence only: no language detection, geolocation, semantic or visual-relevance promise. Evidence is report-only; output fields are unchanged.