Instagram 标记的帖子
curl --request POST \
--url https://api.socq.ai/v1/instagram/tagged-posts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"usernames": [
"<string>"
],
"results_limit": 1000
}
'import requests
url = "https://api.socq.ai/v1/instagram/tagged-posts"
payload = {
"usernames": ["<string>"],
"results_limit": 1000
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({usernames: ['<string>'], results_limit: 1000})
};
fetch('https://api.socq.ai/v1/instagram/tagged-posts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.socq.ai/v1/instagram/tagged-posts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'usernames' => [
'<string>'
],
'results_limit' => 1000
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.socq.ai/v1/instagram/tagged-posts"
payload := strings.NewReader("{\n \"usernames\": [\n \"<string>\"\n ],\n \"results_limit\": 1000\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.socq.ai/v1/instagram/tagged-posts")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"usernames\": [\n \"<string>\"\n ],\n \"results_limit\": 1000\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/instagram/tagged-posts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"usernames\": [\n \"<string>\"\n ],\n \"results_limit\": 1000\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"status": "<string>",
"created_time": "<string>"
}
}{
"code": 422,
"error": {
"message": "<string>",
"type": "<string>",
"details": {}
}
}Instagram 标记的帖子
采集标记 Instagram 个人资料的公共帖子。
POST
/
v1
/
instagram
/
tagged-posts
Instagram 标记的帖子
curl --request POST \
--url https://api.socq.ai/v1/instagram/tagged-posts \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"usernames": [
"<string>"
],
"results_limit": 1000
}
'import requests
url = "https://api.socq.ai/v1/instagram/tagged-posts"
payload = {
"usernames": ["<string>"],
"results_limit": 1000
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({usernames: ['<string>'], results_limit: 1000})
};
fetch('https://api.socq.ai/v1/instagram/tagged-posts', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.socq.ai/v1/instagram/tagged-posts",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'usernames' => [
'<string>'
],
'results_limit' => 1000
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.socq.ai/v1/instagram/tagged-posts"
payload := strings.NewReader("{\n \"usernames\": [\n \"<string>\"\n ],\n \"results_limit\": 1000\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.socq.ai/v1/instagram/tagged-posts")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"usernames\": [\n \"<string>\"\n ],\n \"results_limit\": 1000\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.socq.ai/v1/instagram/tagged-posts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"usernames\": [\n \"<string>\"\n ],\n \"results_limit\": 1000\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"data": {
"task_id": "<string>",
"status": "<string>",
"created_time": "<string>"
}
}{
"code": 422,
"error": {
"message": "<string>",
"type": "<string>",
"details": {}
}
}Instagram 标记的帖子
{"usernames": ["instagram"], "results_limit": 20}
与 MCP 一起使用
| 接口 | 值 |
|---|---|
| REST | POST /v1/instagram/tagged-posts |
| Compact MCP | socq_execute 与 endpoint: "instagram/tagged-posts" |
| Typed MCP | socq_instagram_tagged_posts |
| CLI | socq instagram tagged-posts |
结果字段
任务结果使用下列稳定的 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<object> | 是 | 结果附带的图片、视频或其他媒体。 |
media.type | string | 是 | 媒体类型，例如 image 或 video。 |
media.url | string | 是 | 媒体文件的地址。 |
media.thumbnail_url | string | 是 | 媒体预览图的地址。 |
media.width | integer | 是 | 媒体宽度，单位为像素。 |
media.height | integer | 是 | 媒体高度，单位为像素。 |
media.duration_seconds | number | 是 | 媒体时长，单位为秒。 |
hashtags | array<string> | 是 | 内容关联的话题标签，保留源数据中的拼写。 |
mentions | array<string> | 是 | 内容中提及的账号。 |
任务完成响应
{
"code": 200,
"data": {
"task_id": "G5L9ZSVUSLKGMIL2",
"status": "succeeded",
"public_id": "instagram/tagged-posts",
"result_count": 5,
"credits_amount": 2.5,
"results": {
"limit": 1,
"next_cursor": "NjUzNQ",
"has_more": true,
"schema_id": "post",
"schema_version": "1.0",
"items": [
{
"id": "2251138696266127152",
"platform": "instagram",
"resource": "tagged-posts",
"type": "post",
"url": "https://www.instagram.com/p/B89prebFBcw/",
"published_at": "2020-02-24T20:37:46Z",
"collected_at": "2026-07-31T02:23:32.685890Z",
"text": "Uma homenagem a rede social que contribui muito para divulgação do meu trabalho.\n.\nO Instagram tem sido para mim muito mais que uma simples rede social; essa plataforma que além de criar uma conexão com pessoas que queremos por perto, tem ajudado assim como eu milhões de pessoas a divulgar o seu negócio.\nEssa poderosa Midia social, gerou milhares de empregos, e continua dando a oportunidade para todos os que desejam divulgar o que fazem de melhor.\n.\n.\n\nA tribute to the social network that contributes a lot to spread my work. . For me, Instagram has been much more than just a social network; this platform that in addition to creating a connection with people we want close by, has helped millions of people to publicize their business just like me. This powerful social media has created thousands of jobs, and continues to provide an opportunity for everyone who wants to spread the word about what they do best. .\nTHANK YOU @instagram!",
"author": {
"id": "3021079942",
"username": "lucasramosmendes",
"name": "LUCAS RAMOS MENDES ®",
"url": "https://www.instagram.com/lucasramosmendes/",
"avatar_url": null,
"is_verified": null,
"is_private": null
},
"metrics": {
"likes_count": 149853,
"comments_count": 10253,
"shares_count": null,
"views_count": null
},
"media": [
{
"type": "image",
"url": "https://scontent-iev1-1.cdninstagram.com/v/t51.82787-15/621585839_18092087866989349_3372003390585135619_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=103&ig_cache_key=MjI1MTEzODY5NjI2NjEyNzE1Mg%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuMTQ0MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=CH-XViRL-3MQ7kNvwE_hxY3&_nc_oc=AdqllXfBCRo7CL60skDMRd--PFUL-0CQy3TmWTAQGbyKM7m4GE9px64T8ZvXZjpBjbM&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&se=8&_nc_ht=scontent-iev1-1.cdninstagram.com&_nc_gid=vDc_3BFhiq8MKoXQEqV17w&_nc_ss=7a3ba&oh=00_AQHh8WwSqzL7n7pHJRLFROY5WkQVamXQZ6sUUklRL6lnzA&oe=6A71E37C",
"thumbnail_url": "https://scontent-iev1-1.cdninstagram.com/v/t51.82787-15/621585839_18092087866989349_3372003390585135619_n.jpg?stp=dst-jpg_e35_tt6&_nc_cat=103&ig_cache_key=MjI1MTEzODY5NjI2NjEyNzE1Mg%3D%3D.3-ccb7-5&ccb=7-5&_nc_sid=58cdad&efg=eyJ2ZW5jb2RlX3RhZyI6IkZFRUQueHBpZHMuMTQ0MC5zZHIucmVndWxhcl9waG90by5DMyJ9&_nc_ohc=CH-XViRL-3MQ7kNvwE_hxY3&_nc_oc=AdqllXfBCRo7CL60skDMRd--PFUL-0CQy3TmWTAQGbyKM7m4GE9px64T8ZvXZjpBjbM&_nc_ad=z-m&_nc_cid=0&_nc_zt=23&se=8&_nc_ht=scontent-iev1-1.cdninstagram.com&_nc_gid=vDc_3BFhiq8MKoXQEqV17w&_nc_ss=7a3ba&oh=00_AQHh8WwSqzL7n7pHJRLFROY5WkQVamXQZ6sUUklRL6lnzA&oe=6A71E37C",
"width": 1440,
"height": 1800,
"duration_seconds": null
}
],
"hashtags": [],
"mentions": [
"instagram"
]
}
]
}
}
}
授权
bearerAuthapiKeyAuth
使用 Authorization: Bearer <token> 请求头进行身份验证。
请求体
application/json