Contract
input_schema.json
{
"type": "object",
"required": [
"section_id"
],
"properties": {
"count": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1,
"description": "Count per page"
},
"max_id": {
"type": "string",
"description": "Pagination cursor for next page"
},
"section_id": {
"type": "string",
"examples": [
"10156104410190727"
],
"description": "Section ID (from fetch_explore_sections)"
}
},
"additionalProperties": false
}output_schema.json
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Composite media id (mediaId_userId)."
},
"code": {
"type": "string",
"description": "The post's shortcode, as used in its URL."
},
"user": {
"type": "object",
"properties": {
"pk": {
"type": [
"number",
"string"
]
},
"username": {
"type": "string"
},
"full_name": {
"type": "string"
},
"is_private": {
"type": "boolean"
},
"is_verified": {
"type": "boolean"
},
"profile_pic_url": {
"type": [
"string",
"null"
],
"description": "Withheld (stripped to `null`) -- only whether the field is populated is observable."
}
},
"description": "The post's own publishing account.",
"additionalProperties": true
},
"caption": {
"type": [
"object",
"null"
],
"properties": {
"text": {
"type": "string"
},
"user": {
"type": "object",
"properties": {
"pk": {
"type": [
"number",
"string"
]
},
"username": {
"type": "string"
},
"full_name": {
"type": "string"
},
"is_private": {
"type": "boolean"
},
"is_verified": {
"type": "boolean"
},
"profile_pic_url": {
"type": [
"string",
"null"
],
"description": "Withheld (stripped to `null`) -- only whether the field is populated is observable."
}
},
"description": "The caption author -- the post's own publisher.",
"additionalProperties": true
},
"created_at": {
"type": "number",
"description": "Unix seconds."
}
},
"description": "The post's own caption. `null` observed when a post has no caption.",
"additionalProperties": true
},
"location": {
"type": "object",
"properties": {
"pk": {
"type": "number"
},
"lat": {
"type": "number"
},
"lng": {
"type": "number"
},
"city": {
"type": "string"
},
"name": {
"type": "string"
},
"address": {
"type": "string"
},
"short_name": {
"type": "string"
},
"facebook_places_id": {
"type": "number"
}
},
"description": "The place the post was tagged at, when any -- a business/venue location, not a personal address. The key itself is absent (not present) on posts with no location tag.",
"additionalProperties": true
},
"taken_at": {
"type": "number",
"description": "Unix seconds."
},
"usertags": {
"type": "object",
"properties": {
"in": {
"type": "array",
"items": {
"type": "object",
"properties": {
"user": {
"type": "object",
"properties": {
"pk": {
"type": [
"number",
"string"
]
},
"username": {
"type": "string"
},
"full_name": {
"type": "string"
},
"is_private": {
"type": "boolean"
},
"is_verified": {
"type": "boolean"
},
"profile_pic_url": {
"type": [
"string",
"null"
],
"description": "Withheld (stripped to `null`)."
}
},
"additionalProperties": true
}
},
"additionalProperties": true
}
}
},
"description": "Accounts tagged in the post's own top-level image.",
"additionalProperties": true
},
"like_count": {
"type": [
"number",
"null"
]
},
"media_type": {
"type": "number",
"description": "1=photo, 8=carousel/album observed at this top level on both fixtures; 2=video is the vendor's documented enum value but was only observed nested under `carousel_media[].media_type` (a video slide inside a carousel), never on a top-level item directly in either fixture."
},
"comment_count": {
"type": [
"number",
"null"
]
},
"carousel_media": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"caption": {
"type": [
"object",
"null"
],
"properties": {
"text": {
"type": "string"
},
"user": {
"type": "object",
"properties": {
"pk": {
"type": [
"number",
"string"
]
},
"username": {
"type": "string"
},
"full_name": {
"type": "string"
},
"is_private": {
"type": "boolean"
},
"is_verified": {
"type": "boolean"
},
"profile_pic_url": {
"type": [
"string",
"null"
],
"description": "Withheld (stripped to `null`)."
}
},
"additionalProperties": true
}
},
"description": "This slide's own caption/attribution -- observed to differ slide-to-slide on a curated multi-source carousel, not a duplicate of the post's own caption.",
"additionalProperties": true
},
"taken_at": {
"type": "number"
},
"usertags": {
"type": "object",
"properties": {
"in": {
"type": "array",
"items": {
"type": "object",
"properties": {
"user": {
"type": "object",
"properties": {
"pk": {
"type": [
"number",
"string"
]
},
"username": {
"type": "string"
},
"full_name": {
"type": "string"
},
"is_private": {
"type": "boolean"
},
"is_verified": {
"type": "boolean"
},
"profile_pic_url": {
"type": [
"string",
"null"
],
"description": "Withheld (stripped to `null`)."
}
},
"description": "An account tagged in this carousel slide's image.",
"additionalProperties": true
}
},
"additionalProperties": true
}
}
},
"additionalProperties": true
},
"media_type": {
"type": "number"
},
"original_width": {
"type": "number"
},
"video_versions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Withheld (stripped to `null`)."
},
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"additionalProperties": true
},
"description": "Present only when this slide's media_type is a video."
},
"image_versions2": {
"type": "object",
"properties": {
"candidates": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Withheld (stripped to `null`)."
},
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"additionalProperties": true
}
}
},
"additionalProperties": true
},
"original_height": {
"type": "number"
}
},
"additionalProperties": true
},
"description": "One entry per slide, present only on a carousel/album post."
},
"image_versions2": {
"type": "object",
"properties": {
"candidates": {
"type": "array",
"items": {
"type": "object",
"properties": {
"url": {
"type": [
"string",
"null"
],
"description": "Withheld (stripped to `null`) -- only the existence/dimensions of an image candidate are observable, not the image itself."
},
"width": {
"type": "number"
},
"height": {
"type": "number"
}
},
"additionalProperties": true
}
}
},
"description": "Present on a photo post's own top-level image (not a carousel item).",
"additionalProperties": true
},
"coauthor_producers": {
"type": "array",
"items": {
"type": "object",
"properties": {
"pk": {
"type": [
"number",
"string"
]
},
"username": {
"type": "string"
},
"full_name": {
"type": "string"
},
"is_private": {
"type": "boolean"
},
"is_verified": {
"type": "boolean"
},
"profile_pic_url": {
"type": [
"string",
"null"
],
"description": "Withheld (stripped to `null`) -- only whether the field is populated is observable."
}
},
"additionalProperties": true
},
"description": "Other accounts the publisher tagged as co-authors of this post. Empty on most posts in both fixtures; populated with the same account shape as `user` on a few."
},
"carousel_media_count": {
"type": "number",
"description": "Present only on carousel/album posts (media_type 8)."
}
},
"additionalProperties": true
}
},
"max_id": {
"type": [
"string",
"null"
],
"description": "Pagination cursor for the next page. `null` observed on both fixtures."
},
"status": {
"type": "string",
"description": "The endpoint's own status string, e.g. 'ok'."
},
"subsections": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"section_id": {
"type": "number"
}
},
"additionalProperties": true
},
"description": "Related subsections of this same section."
},
"section_name": {
"type": "string"
},
"more_available": {
"type": "boolean"
}
},
"description": "The section page, as returned at routing.responseResultPath ($.output).",
"additionalProperties": true
}Pricing
Every real charge, itemised. A model that quietly omits one is a slow financial leak, so nothing here is rolled up, and a charge that only applies to some inputs says so rather than being added in.
Prices in this catalog are the provider's own list price, not your bill: Omnial MCP charges provider cost plus a platform markup on top, so what you are charged is higher than the figure shown. For the exact amount a specific call will cost, run omnial_execute with dry_run: true; that number includes the markup and is what we hold while the call runs. It is a quote, not a cap on the charge.
| Charge | Rate |
|---|---|
Per call Flat, regardless of what comes back | $0.0020475 |
- Cost basis
- Not recorded
This tool's catalog entry does not record how its final bill is determined, so we will not tell you whether its cost is fixed before the call or reported by the provider afterwards. Either way what is held is a quote rather than a cap: you are charged what the call actually costs, bounded at 2x the quote.
- Updated
- Sep 23, 2026