> ## Documentation Index > Fetch the complete documentation index at: https://docs.socq.ai/llms.txt > Use this file to discover all available pages before exploring further. # Instagram 地点帖子 > 采集在 Instagram 地点标记的公开帖子。 # Instagram 地点帖子 采集在某个 Instagram 地点标记的公开帖子，可选热门或最新，返回说明文字、作者、点赞数、评论数和媒体。接口返回异步任务，完成后读取标准结果。 ```json theme={null} { "location_id": "384695225271379", "sort_by": "top", "results_limit": 20 } ``` 用 location\_id 或地点页面 url 指定地点，任选其一即可。sort\_by 设为 top（默认）获取地点的热门帖子，设为 recent 获取最新帖子；results\_limit 设置返回的帖子数量（默认 20，最多 100）。 ## 标准结果字段 任务结果使用下方稳定的 SocQ 字段。系统会统一来源特有的字段名和格式，但不会推断或补充来源未提供的数据。如需缩小返回字段集合，MCP 查询使用 `fields`，Typed 工具使用 `_result_fields`，CLI 使用 `--result-fields`。声明字段的值为 `null` 时仍会保留。 | 字段 | 类型 | 可空 | 说明 | | - | - | - | - | | `id` | `string` | 是 | 当前结果项的唯一标识。 | | `platform` | `string` | 否 | 结果所属的平台，例如 `instagram` 或 `linkedin`。 | | `resource` | `string` | 否 | 该结果对应的 SocQ 资源，例如 `videos` 或 `comments`。 | | `type` | `string` | 否 | 结果项的类别，例如 `video`、`post` 或 `comment`。 | | `url` | `string` | 是 | 结果项的公开访问地址（如可获得）。 | | `published_at` | `string` | 是 | 源内容的发布时间（如可获得），使用 ISO 8601 格式。 | | `collected_at` | `string` | 否 | SocQ 采集或处理该结果的时间，使用 ISO 8601 格式。 | | `text` | `string` | 是 | 帖子的正文、说明文字或消息内容。 | | `author` | `object` | 是 | 内容的作者或发布者。 | | `author.id` | `string` | 是 | 作者的唯一标识。 | | `author.username` | `string` | 是 | 账号的公开用户名或账号标识。 | | `author.name` | `string` | 是 | 作者的显示名称。 | | `author.url` | `string` | 是 | 作者的公开访问地址（如可获得）。 | | `author.avatar_url` | `string` | 是 | 账号头像图片的地址。 | | `author.is_verified` | `boolean` | 是 | 账号是否已通过平台认证。 | | `author.is_private` | `boolean` | 是 | 账号是否为私密账号。 | | `metrics` | `object` | 是 | 结果项可获得的计数和度量数据。 | | `metrics.likes_count` | `integer` | 是 | 点赞数量。 | | `metrics.comments_count` | `integer` | 是 | 评论数量。 | | `metrics.shares_count` | `integer` | 是 | 分享或转发数量。 | | `metrics.views_count` | `integer` | 是 | 平台报告的观看数量。 | | `media` | `array` | 是 | 结果附带的图片、视频或其他媒体。 | | `media.type` | `string` | 是 | 媒体类型，例如 `image` 或 `video`。 | | `media.url` | `string` | 是 | 媒体文件的地址。 | | `media.thumbnail_url` | `string` | 是 | 媒体预览图的地址。 | | `media.width` | `integer` | 是 | 媒体宽度，单位为像素。 | | `media.height` | `integer` | 是 | 媒体高度，单位为像素。 | | `media.duration_seconds` | `number` | 是 | 媒体时长，单位为秒。 | | `hashtags` | `array` | 是 | 内容关联的话题标签，保留源数据中的拼写。 | | `mentions` | `array` | 是 | 内容中提及的账号。 | 以下示例展示任务完成后的响应格式，具体数据以实际查询结果为准。 ## 任务完成响应 ```json theme={null} { "code": 200, "data": { "task_id": "example-instagram-location-posts", "status": "succeeded", "public_id": "instagram/location-posts", "result_count": 1, "credits_amount": 0.5, "results": { "limit": 50, "next_cursor": null, "has_more": false, "schema_id": "post", "schema_version": "1.0", "items": [ { "id": "4026000000000000001", "platform": "instagram", "resource": "location-posts", "type": "post", "url": "https://www.instagram.com/p/EXAMPLE0001/", "published_at": "2026-11-08T22:36:13Z", "collected_at": "2026-11-09T06:37:43Z", "text": "Evening lights in Times Square.", "author": { "id": "75500000001", "username": "example_user", "name": "Example User", "url": "https://www.instagram.com/example_user/", "avatar_url": "https://example.com/avatar.jpg", "is_verified": false, "is_private": false }, "metrics": { "likes_count": 219, "comments_count": 7, "shares_count": null, "views_count": null }, "media": [ { "type": "video", "url": "https://example.com/post.mp4", "thumbnail_url": "https://example.com/post.jpg", "width": 1080, "height": 1920, "duration_seconds": null } ], "hashtags": null, "mentions": null } ] } } } ``` ## OpenAPI ````yaml zh/api-manual/agent-api/agent-api.json POST /v1/instagram/location-posts openapi: 3.1.0 info: title: SocQ Agent API 中文版 version: v1-49b371f0f690 description: 根据 SocQ 能力目录生成的异步社交数据 API。 servers: - url: https://api.socq.ai security: [] paths: /v1/instagram/location-posts: post: tags: - instagram summary: Instagram 地点帖子 description: 采集在 Instagram 地点标记的公开帖子。 operationId: socq_instagram_location_posts requestBody: required: true content: application/json: schema: $schema: https://json-schema.org/draft/2020-12/schema type: object additionalProperties: false properties: callback_url: type: string format: uri description: 可选的任务完成回调 URL。 location_id: type: string pattern: ^[0-9]{1,32}$ description: Instagram 地点的数字 ID，可通过 Instagram 地点搜索获取。 results_limit: type: integer minimum: 1 maximum: 100 default: 20 description: 最多保存的结果数，实际结果可能少于该值。 sort_by: type: string minLength: 1 enum: - recent - top default: top description: 排序方式：top 为热门帖子（默认，只返回一页），recent 为按时间从新到旧。 url: type: string minLength: 1 description: >- Instagram 地点页面 URL，例如 https://www.instagram.com/explore/locations/212988663/。 required: [] description: >- 用 location_id 或地点页面 url 指定地点，任选其一即可。sort_by 设为 top（默认）获取地点的热门帖子，设为 recent 获取最新帖子；results_limit 设置返回的帖子数量（默认 20，最多 100）。 anyOf: - required: - location_id - required: - url allOf: - not: required: - location_id - url responses: '200': description: 任务已受理 content: application/json: schema: $ref: '#/components/schemas/AgentSubmitResponse' '422': description: Input validation failed content: application/json: schema: $ref: '#/components/schemas/AgentValidationErrorResponse' security: - bearerAuth: [] - apiKeyAuth: [] components: schemas: AgentSubmitResponse: type: object properties: code: type: integer const: 200 description: HTTP 业务状态码。 data: type: object properties: task_id: type: string description: 任务 ID，用于查询任务状态和结果。 status: type: string description: 任务当前状态。 created_time: type: - string - 'null' description: 任务创建时间。 required: - task_id - status AgentValidationErrorResponse: type: object properties: code: type: integer const: 422 error: type: object properties: message: type: string type: type: string details: type: object required: - message - type required: - code - error securitySchemes: bearerAuth: type: http scheme: bearer description: '使用 `Authorization: Bearer ` 请求头进行身份验证。' apiKeyAuth: type: apiKey in: header name: x-api-key description: 也可以通过 `x-api-key` 请求头提供 API Key。 ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.