Instagram API: 場所 — Recent Media Details By Location Id

Q: この Instagram API メソッドはどのようなデータを返しますか？

このメソッドは 場所 に対して「Recent Media Details By Location Id」を実行します。以下のコンパクトなレスポンス例で、フィールドの正確な構造を確認できます。

このエンドポイントの機能

この API メソッドで構築できるもの

まず結果と一般的なワークフローを確認し、次にパラメーターと動作するリクエスト例に進んでください。

このエンドポイントが役立つこと

レスポンスは、利用可能な場所のフィールドを、正規化された V2 形式またはプラットフォーム固有の V1 形式で提供します。

使用に適した場面

オブジェクトが既にわかっていて、製品でその現在の公開コンテキストが必要な場合に「Recent Media Details By Location Id」を使用します。

主なユースケース

レコードのエンリッチメント

製品の既知のオブジェクトを Instagram の公開フィールドで補完します。

データの検証

後続の処理の前に、識別子と現在の公開コンテキストを確認します。

分析の準備

オブジェクトの詳細をレポート、評価、関連リクエストの入力として使用します。

利用できるバージョン

レスポンスのバージョン

どちらのバージョンも同じタスクを解決し、同じパラメーターを受け付けます。切り替えを使ってレスポンス構造を比較し、クライアントが想定するバージョンを選んでください。

レスポンスのバージョン V2

このページでバージョンを切り替えると、同じドキュメント URL でレスポンス構造を比較できます。

共通する点

認証、必須パラメーター、リクエストの形は V1 と V2 で同じです。実際には、エンドポイントのパスを組み立てるときとレスポンスを読み取るときにバージョンを選びます。

バージョン間で異なる点

主な違いはレスポンスのエンベロープです。新しい連携では V2 を使用し、既存のクライアント契約との互換性が必要な場合にのみ V1 を残してください。

使い方

メソッドの呼び出し方

どちらのバージョンでも、同じ API キーのヘッダーと同じクエリパラメーターを使用します。このドキュメントでは、まず共通のパラメーターを示し、次に各バージョンのパスとコードスニペットを示します。

入力パラメーター

共通パラメーター

パラメーター	必須	型	例	説明
`location_id`	はい	`str`	`236743013`	選択したプラットフォームにおける場所の ID。
`cursor`	いいえ	`str \| None`	`next-page-cursor`	前のレスポンスで返された次のページのカーソル。最初のページでは省略します。

バージョン別のリクエストパス

V2

エンドポイントの正確なパス、URL の例、コードスニペットをコピーするときにバージョンを選んでください。上のパラメーター一覧は変わりません。

GET /api/v2/instagram.com/location/recent-media-details-by-location-id

正規化された形式

リクエストのプレビュー

ベース URL https://www.scrapestorm.net

エンドポイント /api/v2/instagram.com/location/recent-media-details-by-location-id

必須パラメーター

location_id

任意のパラメーター

cursor

URL の例

https://www.scrapestorm.net/api/v2/instagram.com/location/recent-media-details-by-location-id?location_id=236743013

コード例

curl --request GET \
  --url "https://www.scrapestorm.net/api/v2/instagram.com/location/recent-media-details-by-location-id" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'location_id=236743013' \
  # Optional parameters:
  # --data-urlencode 'cursor=next-page-cursor'

from urllib.parse import urljoin

import requests

BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v2/instagram.com/location/recent-media-details-by-location-id"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}

params = {
    "location_id": "236743013",
}

# Optional parameters
# params["cursor"] = "next-page-cursor"

with requests.Session() as session:
    response = session.request(
        method="GET",
        url=urljoin(BASE_URL, ENDPOINT),
        headers=HEADERS,
        params=params,
        timeout=30,
    )
    response.raise_for_status()
    payload = response.json()

print(payload)

const BASE_URL = "https://www.scrapestorm.net";
const endpoint = "/api/v2/instagram.com/location/recent-media-details-by-location-id";

const params = new URLSearchParams({
  location_id: "236743013",
});

// Optional parameters
// params.set("cursor", "next-page-cursor");

const response = await fetch(`${BASE_URL}${endpoint}?${params.toString()}`, {
  method: "GET",
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

if (!response.ok) {
  throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}

const payload = await response.json();
console.log(payload);

import axios from "axios";

const client = axios.create({
  baseURL: "https://www.scrapestorm.net",
  timeout: 30000,
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

const params = {
  location_id: "236743013",
};

// Optional parameters
// params.cursor = "next-page-cursor";

const { data: payload } = await client.request({
  method: "GET",
  url: endpoint,
  params,
});

console.log(payload);

<?php

declare(strict_types=1);

use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;

$client = new Client([
    'base_uri' => "https://www.scrapestorm.net",
    'timeout' => 30.0,
    'headers' => [
        'Accept' => 'application/json',
        'X-API-Key' => "00000000-0000-4000-8000-000000000000",
    ],
]);

$query = [
    "location_id" => "236743013",
];

// Optional parameters
// $query["cursor"] = "next-page-cursor";

try {
    $response = $client->request("GET", "/api/v2/instagram.com/location/recent-media-details-by-location-id", [
        'query' => $query,
    ]);

    $payload = json_decode(
        (string) $response->getBody(),
        true,
        512,
        JSON_THROW_ON_ERROR
    );

    var_dump($payload);
} catch (GuzzleException $e) {
    throw $e;
}

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "net/url"
    "time"
)

func main() {
    baseURL := "https://www.scrapestorm.net"
    endpoint := "/api/v2/instagram.com/location/recent-media-details-by-location-id"

    params := url.Values{}
    params.Set("location_id", "236743013")

    // Optional parameters
    // params.Set("cursor", "next-page-cursor")

    req, err := http.NewRequest(
        "GET",
        fmt.Sprintf("%s%s?%s", baseURL, endpoint, params.Encode()),
        nil,
    )
    if err != nil {
        panic(err)
    }

    req.Header.Set("Accept", "application/json")
    req.Header.Set("X-API-Key", "00000000-0000-4000-8000-000000000000")

    client := &http.Client{Timeout: 30 * time.Second}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var payload any
    if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
        panic(err)
    }

    fmt.Printf("%+v\n", payload)
}

バージョン別のリクエストパス

V1

エンドポイントの正確なパス、URL の例、コードスニペットをコピーするときにバージョンを選んでください。上のパラメーター一覧は変わりません。

GET /api/v1/instagram.com/location/recent-media-details-by-location-id

プラットフォーム固有の形式

リクエストのプレビュー

ベース URL https://www.scrapestorm.net

エンドポイント /api/v1/instagram.com/location/recent-media-details-by-location-id

必須パラメーター

location_id

任意のパラメーター

cursor

URL の例

https://www.scrapestorm.net/api/v1/instagram.com/location/recent-media-details-by-location-id?location_id=236743013

コード例

curl --request GET \
  --url "https://www.scrapestorm.net/api/v1/instagram.com/location/recent-media-details-by-location-id" \
  --header "X-API-Key: 00000000-0000-4000-8000-000000000000" \
  --get --data-urlencode 'location_id=236743013' \
  # Optional parameters:
  # --data-urlencode 'cursor=next-page-cursor'

from urllib.parse import urljoin

import requests

BASE_URL = "https://www.scrapestorm.net"
ENDPOINT = "/api/v1/instagram.com/location/recent-media-details-by-location-id"
HEADERS = {"Accept": "application/json", "X-API-Key": "00000000-0000-4000-8000-000000000000"}

params = {
    "location_id": "236743013",
}

# Optional parameters
# params["cursor"] = "next-page-cursor"

with requests.Session() as session:
    response = session.request(
        method="GET",
        url=urljoin(BASE_URL, ENDPOINT),
        headers=HEADERS,
        params=params,
        timeout=30,
    )
    response.raise_for_status()
    payload = response.json()

print(payload)

const BASE_URL = "https://www.scrapestorm.net";
const endpoint = "/api/v1/instagram.com/location/recent-media-details-by-location-id";

const params = new URLSearchParams({
  location_id: "236743013",
});

// Optional parameters
// params.set("cursor", "next-page-cursor");

const response = await fetch(`${BASE_URL}${endpoint}?${params.toString()}`, {
  method: "GET",
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

if (!response.ok) {
  throw new Error(`Request failed: ${response.status} ${response.statusText}`);
}

const payload = await response.json();
console.log(payload);

import axios from "axios";

const client = axios.create({
  baseURL: "https://www.scrapestorm.net",
  timeout: 30000,
  headers: {
    Accept: "application/json",
    "X-API-Key": "00000000-0000-4000-8000-000000000000",
  },
});

const params = {
  location_id: "236743013",
};

// Optional parameters
// params.cursor = "next-page-cursor";

const { data: payload } = await client.request({
  method: "GET",
  url: endpoint,
  params,
});

console.log(payload);

<?php

declare(strict_types=1);

use GuzzleHttp\Client;
use GuzzleHttp\Exception\GuzzleException;

$client = new Client([
    'base_uri' => "https://www.scrapestorm.net",
    'timeout' => 30.0,
    'headers' => [
        'Accept' => 'application/json',
        'X-API-Key' => "00000000-0000-4000-8000-000000000000",
    ],
]);

$query = [
    "location_id" => "236743013",
];

// Optional parameters
// $query["cursor"] = "next-page-cursor";

try {
    $response = $client->request("GET", "/api/v1/instagram.com/location/recent-media-details-by-location-id", [
        'query' => $query,
    ]);

    $payload = json_decode(
        (string) $response->getBody(),
        true,
        512,
        JSON_THROW_ON_ERROR
    );

    var_dump($payload);
} catch (GuzzleException $e) {
    throw $e;
}

package main

import (
    "encoding/json"
    "fmt"
    "net/http"
    "net/url"
    "time"
)

func main() {
    baseURL := "https://www.scrapestorm.net"
    endpoint := "/api/v1/instagram.com/location/recent-media-details-by-location-id"

    params := url.Values{}
    params.Set("location_id", "236743013")

    // Optional parameters
    // params.Set("cursor", "next-page-cursor")

    req, err := http.NewRequest(
        "GET",
        fmt.Sprintf("%s%s?%s", baseURL, endpoint, params.Encode()),
        nil,
    )
    if err != nil {
        panic(err)
    }

    req.Header.Set("Accept", "application/json")
    req.Header.Set("X-API-Key", "00000000-0000-4000-8000-000000000000")

    client := &http.Client{Timeout: 30 * time.Second}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()

    var payload any
    if err := json.NewDecoder(resp.Body).Decode(&payload); err != nil {
        panic(err)
    }

    fmt.Printf("%+v\n", payload)
}

レスポンス例

バージョン別のライブレスポンス

プレビューには主要なフィールドとコレクションの最初の要素が含まれているため、レスポンスの形をすばやく確認できます。バージョンを切り替えると JSON の形式が変わります。

レスポンス例

V2 レスポンスの JSON

プレースホルダー

V2 の検証済みのライブ例はまだありません。検証済みの例が公開されるまで、このプレースホルダーで標準のレスポンスエンベロープを表示しています。

{
  "success": true,
  "status": "ok",
  "data": {}
}

レスポンス例

V1 レスポンスの JSON

プレースホルダー

V1 の検証済みのライブ例はまだありません。検証済みの例が公開されるまで、このプレースホルダーで標準のレスポンスエンベロープを表示しています。

{
  "success": true,
  "status": "ok",
  "data": {}
}

場所で作業を続ける

関連するメソッドでは、同じオブジェクトを別の識別子で解決したり、詳細を開いたり、集計ビューに切り替えたりできます。

次のステップ

評価を続ける

このドキュメントを最初の判断材料とし、継続的な利用のためにエンドポイントを接続する前に、料金、プラットフォームのカバー範囲、連携ルールを確認してください。

Instagram のプラットフォームページを開く

実装の前に、関連するエンティティ、API メソッドのグループ、関連ドキュメントを比較してください。

プラットフォームページを開く

API メソッドの料金を比較する

利用を拡大する前に、公開料金表でこのメソッドの位置付けを確認してください。

料金を見る

連携ルールを確認する

入門ドキュメントで、認証、バージョン、再試行、テストと本番の違いを確認してください。

ドキュメントを開く

よくある質問

チームが実装前に尋ねる質問

これらの回答を参考に、この API メソッドがワークフロー、バージョンの選択、導入計画に合うかどうかを判断してください。

この Instagram API メソッドはどのようなデータを返しますか？

このメソッドは場所に対して「Recent Media Details By Location Id」を実行します。以下のコンパクトなレスポンス例で、フィールドの正確な構造を確認できます。

V1 と V2 のどちらを選ぶべきですか？

新しい連携では、正規化された構造を提供する V2 を選んでください。V1 は、既にプラットフォーム固有の形式を処理しているクライアントとの互換性のためにのみ使用してください。

最初のリクエストには何が必要ですか？

API キーを作成し、リクエストヘッダーで送信し、表の必須パラメーターを指定してください。コード例には、正しいパスとリクエスト構造が既に含まれています。

Instagram API: 場所 — Recent Media Details By Location Id

この API メソッドで構築できるもの

このエンドポイントが役立つこと

使用に適した場面

主なユースケース

レコードのエンリッチメント

データの検証

分析の準備

レスポンスのバージョン

共通する点

バージョン間で異なる点

メソッドの呼び出し方

入力パラメーター

バージョン別のリクエストパス

コード例

バージョン別のリクエストパス

コード例

バージョン別のライブレスポンス

V2 レスポンスの JSON

V1 レスポンスの JSON

場所 で作業を続ける

場所: Recent Media Info By Location Id

場所: Top Media Details By Location Id

場所: 場所 ID による最新の投稿

場所: Top Media Info By Location Id

評価を続ける

Instagram のプラットフォームページを開く

API メソッドの料金を比較する

連携ルールを確認する

チームが実装前に尋ねる質問

場所で作業を続ける