Obserwujących na Instagramie możesz pobrać w Pythonie, przesyłając jedną lub więcej nazw użytkowników, adresów URL albo numerycznych identyfikatorów publicznych profili do Instagram Followers Scraper API Datablist za pomocą biblioteki Requests. API zwraca dane obserwujących w formacie JSON i wskazuje profil źródłowy każdej relacji.
W tym poradniku zaczynam od obserwujących pobranych dla Jupiter Hikes, długodystansowego wędrowca i filmowca. Następnie wykorzystuję tę samą funkcję Pythona, aby porównać ich z obserwującymi Darwin on the Trail, innego długodystansowego wędrowca i twórcy filmów outdoorowych. Kod grupuje wyniki według numerycznego ID użytkownika Instagrama i znajduje osoby obecne na obu pobranych listach.
🔑 Podsumowanie dla zabieganych
Użyj Instagram Followers Scraper API Datablist, aby za pomocą Pythona pobierać obserwujących publiczne profile na Instagramie. Prześlij profile, które chcesz przetworzyć, ustaw limit dla każdego z nich i pobierz dostępne dane obserwujących jako JSON do własnych analiz lub działań marketingowych. Zanim zaczniesz, sprawdź, czy Instagram pozwala przeglądać obserwujących danego profilu.
- Dane wejściowe: nazwy użytkowników, adresy URL profili lub numeryczne ID użytkowników Instagrama.
- Dane wyjściowe: rekordy obserwujących z ID użytkownika, dostępnymi informacjami o profilu oraz profilem źródłowym, z którego pochodzi dany obserwujący.
💡 Wolisz rozwiązanie no-code? Użyj źródła Instagram Followers source Datablist, aby generować wiersze z obserwującymi bez pisania kodu.
Poradnik pobierania obserwujących na Instagramie do kolekcji opisuje to samo źródło w interfejsie Datablist. Dalsza część tego artykułu skupia się na API.
Sprawdź, czy Instagram ogranicza listę obserwujących
Przed uruchomieniem zadania otwórz docelowy profil na Instagramie i kliknij Obserwujący. Sprawdź, czy możesz przeglądać ich listę. Publiczny profil nie gwarantuje, że Instagram udostępnia wszystkich jego obserwujących.
Jeśli zobaczysz komunikat „Tylko [nazwa użytkownika] może zobaczyć wszystkich obserwujących”, scraper zwróci niepełną listę, nawet jeżeli profil jest publiczny. API może pobrać wyłącznie osoby udostępnione przez Instagram — zwiększenie żądanego limitu nie odsłoni ukrytych obserwujących.
Sprawdź w ten sposób każdy profil, który zamierzasz przetworzyć. Jeszcze przed wysłaniem żądania do API będziesz wiedzieć, czy dostępna lista obserwujących wystarczy do realizacji Twojego celu.
Skonfiguruj Pythona i klucz API Datablist
Dostęp do REST API Datablist jest dostępny w planie Growth. Zadania wykonywane przez Sources również zużywają kredyty. Koszt pobierania obserwujących omawiam po instrukcji krok po kroku.
Utwórz Personal API Key na stronie API swojego konta Datablist. W tym przykładzie korzystam z pakietu requests. Utwórz folder projektu, otwórz go w terminalu i uruchom:
python -m venv .venv
source .venv/bin/activate
python -m pip install requestsUtwórz plik scrape_instagram_followers.py, a następnie zapisz swój klucz w zmiennej środowiskowej DATABLIST_API_KEY:
export DATABLIST_API_KEY="your-api-key"Skrypt odczytuje tę zmienną i przesyła jej wartość w nagłówku X-API-Key.
Pobierz obserwujących jedną funkcją Pythona
Pierwsze żądanie wykorzystuje jupiterhikes — nazwę użytkownika długodystansowego wędrowca i twórcy Jupiter Hikes. Źródło przyjmuje również pełny adres URL profilu lub numeryczne ID użytkownika Instagrama zapisane jako ciąg znaków. Numeryczne ID Jupiter Hikes to na przykład "1507518892".
Wklej poniższy kompletny skrypt do pliku scrape_instagram_followers.py:
import json
import os
import time
import uuid
import requests
def scrape_instagram_users(
profiles,
api_key,
scraping_type="followers",
limit_per_profile=100,
):
"""Submit profiles, wait for the source task, and return all generated users."""
tasks_url = "https://api.datablist.com/v1/sources/tasks"
headers = {"X-API-Key": api_key}
unique_id = str(uuid.uuid4())
print(f"Task uniqueId: {unique_id}", flush=True)
payload = {
"sourceId": "instagram-source",
"uniqueId": unique_id,
"settings": {
"profiles": profiles,
"scrapingType": scraping_type,
"limitPerProfile": limit_per_profile,
},
}
response = requests.post(tasks_url, headers=headers, json=payload)
response.raise_for_status()
task = response.json()
task_id = task["@id"]
task_url = f"{tasks_url}/{task_id}"
print(f"Task ID: {task_id}")
while task["status"] not in ("completed", "failed", "stopped"):
time.sleep(3)
response = requests.get(task_url, headers=headers)
response.raise_for_status()
task = response.json()
print(f"Task status: {task['status']}; credits used: {task['credits']['used']}")
if task["status"] != "completed":
raise RuntimeError(
f"Task {task_id} {task['status']}: {task.get('error')}"
)
results = []
params = {"limit": 10}
while True:
response = requests.get(
f"{task_url}/results",
headers=headers,
params=params,
)
response.raise_for_status()
page = response.json()
results.extend(page["results"])
next_cursor = page["nextCursor"]
if next_cursor is None:
break
params["cursor"] = next_cursor
return results
if __name__ == "__main__":
api_key = os.environ.get("DATABLIST_API_KEY")
if not api_key:
raise RuntimeError("Set DATABLIST_API_KEY before running this script.")
profiles = ["jupiterhikes"]
follower_results = scrape_instagram_users(profiles, api_key)
print(json.dumps(follower_results, indent=2, ensure_ascii=False))Uruchom go poleceniem:
python scrape_instagram_followers.pyFunkcja wykonuje kolejno trzy rodzaje wywołań API.
POST /v1/sources/tasksprzesyła ID źródła i ustawienia. API przyjmuje zadanie działające w tle i zwraca jego ID.GET /v1/sources/tasks/{taskId}sprawdza stan zadania co trzy sekundy. Klient Requests czeka, ale samo zadanie jest wykonywane asynchronicznie w Datablist.GET /v1/sources/tasks/{taskId}/resultspobiera stronę płaskich obiektów obserwujących. Pętla przekazuje każdynextCursorróżny odnullbez żadnych zmian, aż API zwrócinull.
W przykładzie parametr scrapingType ma wartość followers, a limitPerProfile wskazuje żądane 100 osób. Traktuj 100 jako limit żądania, a nie gwarantowaną liczbę wyników. Granice stron dostawcy oraz użytkownicy dostępni w chwili wykonywania zadania mogą wpłynąć na ostateczną liczbę rekordów.
Przed wysłaniem żądania skrypt wyświetla uniqueId. Jeśli podczas wywołania POST połączenie zostanie zerwane, ta wartość pomoże Ci znaleźć przyjęte zadanie zamiast od razu uruchamiać kolejne płatne przetwarzanie.
Jak API tworzy rekordy relacji z obserwującymi
Datablist najpierw dopasowuje każdą nazwę użytkownika, pełny adres URL profilu lub numeryczne ID do źródłowego profilu na Instagramie. Następnie zadanie w tle pobiera strony obserwujących i obsługuje kursor dostawcy. Zarządzasz wyłącznie zadaniem Datablist oraz kursorami stron wyników pokazanymi w skrypcie.
Powtarzające się ID użytkowników są deduplikowane w obrębie listy zwróconej dla jednego profilu źródłowego. Jeśli ten sam użytkownik występuje u dwóch przesłanych twórców, API zachowuje dwa rekordy relacji. Każdy z nich ma inne pola followerSourceProfile.... Właśnie dzięki temu można porównywać grupy odbiorców.
W kolejnych sekcjach wykorzystamy następujące pola:
instagramUserIdto stabilny klucz służący do porównywania zwróconych użytkowników.instagramUsername,instagramFullNamei pozostałe polainstagram...opisują obserwującego, jeśli dana informacja jest publicznie dostępna.followerSourceProfileId,followerSourceProfileUsernameorazfollowerSourceProfileUrlidentyfikują profil twórcy, od którego rozpoczęto pobieranie.
To źródło pobiera listy relacji. Nie wyszukuje potencjalnych kontaktów ani nie oblicza wskaźników pewności.
Przeanalizuj wyniki Jupiter Hikes
Ukończone zadanie dla Jupiter Hikes zwróciło 124 unikalne rekordy obserwujących i zużyło 2,24 kredytu. Chociaż żądanie zawierało limitPerProfile: 100, przed zwróceniem przez dostawcę kolejnej strony z 25 osobami licznik wynosił 99. Datablist zachował całą stronę, dlatego ostatecznie uzyskano 124 wyniki.
Poniżej znajduje się odpowiedź z ostatniej strony wyników. Koperta i wszystkie cztery obiekty obserwujących zostały zachowane w oryginalnej postaci:
{
"taskId": "695846750eb440c3870e763d38ef4f4b",
"results": [
{
"instagramUserId": "52256365838",
"instagramUsername": "adventuresoforest",
"instagramFullName": "Forest",
"instagramProfileUrl": "https://www.instagram.com/adventuresoforest/",
"instagramPicture": "https://scontent-fra3-2.cdninstagram.com/v/t51.82787-19/809812326_18068055263741839_8426418313724501534_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-fra3-2.cdninstagram.com&_nc_cat=107&_nc_oc=Q6cZ2gGE1JNYkQoszNL29wj7UyG4OGKOarcf_iw1luHzGMllAjP-kLWQ5LQPxtYI3LUcC5g&_nc_ohc=1hyyyEDHulgQ7kNvwFJIKKP&_nc_gid=ATIykjgJSgaEOBqdAnjQcg&edm=AIfao94BAAAA&ccb=7-5&ig_cache_key=GGbBRDCPB8fvzDBAAB4eZa7PpvB0bmNDAQAB1501500j-ccb7-5&oh=00_AQQZ3R0wDeV-bTnR2lYSje_IQ-ly9n6pyxGHXpJGAmzUHA&oe=6AF37F89&_nc_sid=9f8d40",
"followerSourceProfile": "https://www.instagram.com/jupiterhikes/",
"followerSourceProfileId": "1507518892",
"followerSourceProfileUsername": "jupiterhikes",
"followerSourceProfileUrl": "https://www.instagram.com/jupiterhikes/",
"instagramVerified": false,
"instagramPrivate": false
},
{
"instagramUserId": "199102398",
"instagramUsername": "richie_nu_field",
"instagramFullName": "新野 豊",
"instagramProfileUrl": "https://www.instagram.com/richie_nu_field/",
"instagramPicture": "https://scontent-fra3-1.cdninstagram.com/v/t51.2885-19/348434195_2264827180367957_813086592749200065_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby42NDAuYzIifQ&_nc_ht=scontent-fra3-1.cdninstagram.com&_nc_cat=105&_nc_oc=Q6cZ2gGE1JNYkQoszNL29wj7UyG4OGKOarcf_iw1luHzGMllAjP-kLWQ5LQPxtYI3LUcC5g&_nc_ohc=xux3gQ4SQEAQ7kNvwGj5tEv&_nc_gid=ATIykjgJSgaEOBqdAnjQcg&edm=AIfao94BAAAA&ccb=7-5&ig_cache_key=GBOvxBRVQJAr2QsIAMHicrzyqUgLbkULAAAB1501500j-ccb7-5&oh=00_AQRa3Zl_viAM914UM1_kQYrqGwPLfpmVqPwlMltzkNd44Q&oe=6AF3871F&_nc_sid=9f8d40",
"followerSourceProfile": "https://www.instagram.com/jupiterhikes/",
"followerSourceProfileId": "1507518892",
"followerSourceProfileUsername": "jupiterhikes",
"followerSourceProfileUrl": "https://www.instagram.com/jupiterhikes/",
"instagramVerified": false,
"instagramPrivate": false
},
{
"instagramUserId": "43861505420",
"instagramUsername": "shivroam",
"instagramFullName": "Shivam Rana I Mountaineer",
"instagramProfileUrl": "https://www.instagram.com/shivroam/",
"instagramPicture": "https://scontent-fra3-1.cdninstagram.com/v/t51.82787-19/858921985_18104766389457421_6701325443259882004_n.jpg?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xMDgwLmMyIn0&_nc_ht=scontent-fra3-1.cdninstagram.com&_nc_cat=101&_nc_oc=Q6cZ2gGE1JNYkQoszNL29wj7UyG4OGKOarcf_iw1luHzGMllAjP-kLWQ5LQPxtYI3LUcC5g&_nc_ohc=NMw7vs1oyqQQ7kNvwEYvnsx&_nc_gid=ATIykjgJSgaEOBqdAnjQcg&edm=AIfao94BAAAA&ccb=7-5&ig_cache_key=GAEcMjMNkmJpMFJAABTaykn84-9cbmNDAQAB1501500j-ccb7-5&oh=00_AQR5iJXKSUhS5uS8xmmkgeYw-QZ8AbYxVHqIj3guogZgyA&oe=6AF38C8B&_nc_sid=9f8d40",
"followerSourceProfile": "https://www.instagram.com/jupiterhikes/",
"followerSourceProfileId": "1507518892",
"followerSourceProfileUsername": "jupiterhikes",
"followerSourceProfileUrl": "https://www.instagram.com/jupiterhikes/",
"instagramVerified": false,
"instagramPrivate": false
},
{
"instagramUserId": "23413245087",
"instagramUsername": "double24762",
"instagramFullName": "double 佳",
"instagramProfileUrl": "https://www.instagram.com/double24762/",
"instagramPicture": "https://scontent-iad6-1.cdninstagram.com/v/t51.2885-19/573323465_1219825463302212_7278921664109726296_n.png?stp=dst-jpg_e0_s150x150_tt6&efg=eyJ2ZW5jb2RlX3RhZyI6InByb2ZpbGVfcGljLmRqYW5nby4xNTAuYzIifQ&_nc_ht=scontent-iad6-1.cdninstagram.com&_nc_cat=1&_nc_oc=Q6cZ2gH2sHBsdmQY1aWiWoZZWA6eZ603UbEQOH0raGAaH9APRHqzVjuOTqB7gW86Vp6E9Xx44csiK9pjfjrqCVl5R1HC&_nc_ohc=kwiilGbw6cUQ7kNvwHe7b38&edm=AAAAAAABAAAA&ccb=7-5&ig_cache_key=YW5vbnltb3VzX3Byb2ZpbGVfcGlj.3-ccb7-5&oh=00_AQT5TH4G4DvUg9YUXYlVAW4_1Z03ebdjvl84MLuV0umlaQ&oe=6AF37C2A&_nc_sid=328259",
"followerSourceProfile": "https://www.instagram.com/jupiterhikes/",
"followerSourceProfileId": "1507518892",
"followerSourceProfileUsername": "jupiterhikes",
"followerSourceProfileUrl": "https://www.instagram.com/jupiterhikes/",
"instagramVerified": false,
"instagramPrivate": false
}
],
"nextCursor": null
}Pierwszy rekord ma numeryczne ID użytkownika 52256365838, nazwę adventuresoforest oraz dostępne publicznie pola profilu. Wartość followerSourceProfileUsername to jupiterhikes, dzięki czemu wiadomo, który z przesłanych profili utworzył tę relację. Zadanie może zakończyć się powodzeniem również wtedy, gdy brakuje opcjonalnej wartości profilu. Odczytuj dostępne pola zamiast odtwarzać każdy rekord według sztywnego schematu.
Porównaj dwie grupy odbiorców według ID Instagrama
Gdy żądanie dla jednego profilu działa już prawidłowo, ponownie użyj funkcji scrape_instagram_users(), tym razem dla obu twórców w jednym zadaniu. Pogrupuj zwrócone relacje według numerycznego ID użytkownika i zachowaj wszystkie nazwy profili źródłowych przypisane do tego ID:
comparison_profiles = [
"jupiterhikes",
"https://www.instagram.com/darwin_onthetrail/",
]
comparison_results = scrape_instagram_users(comparison_profiles, api_key)
audience_by_id = {}
collected_count = {}
for result in comparison_results:
source_username = result["followerSourceProfileUsername"]
collected_count[source_username] = collected_count.get(source_username, 0) + 1
user_id = result["instagramUserId"]
grouped_user = audience_by_id.setdefault(
user_id,
{"user": result, "source_profiles": set()},
)
grouped_user["source_profiles"].add(source_username)
overlap = [
{
**grouped_user["user"],
"source_profiles": sorted(grouped_user["source_profiles"]),
}
for grouped_user in audience_by_id.values()
if len(grouped_user["source_profiles"]) == len(comparison_profiles)
]
overlap_report = {
"collected_count": collected_count,
"overlap_count": len(overlap),
"overlap": overlap,
}
print(json.dumps(overlap_report, indent=2, ensure_ascii=False))Zadanie obejmujące dwa profile zwróciło 124 relacje dla Jupiter Hikes oraz 46 dla Darwin on the Trail. Na obu pobranych listach pojawiły się trzy takie same numeryczne ID. Zadanie zużyło 2,7 kredytu.
Kod grupujący korzysta z instagramUserId, a nie z nazwy użytkownika, ponieważ ID jest stabilnym kluczem łączenia zwracanym przez API. Zachowuje jeden kompletny obiekt użytkownika z API i dodaje posortowaną listę source_profiles. Dla każdego z trzech wspólnych ID lista zawiera darwin_onthetrail oraz jupiterhikes.
Przykładowo numeryczne ID 42048393083 występuje raz w wynikach Jupiter Hikes i raz w wynikach Darwin on the Trail. Oba rekordy opisują użytkownika hikingful, lecz każdy zawiera inną wartość followerSourceProfileUsername. Kod grupujący łączy te dwa rekordy relacji w jeden obiekt użytkownika z polem source_profiles: ["darwin_onthetrail", "jupiterhikes"].
📘 Interpretuj wspólną część precyzyjnie: Wspólne ID pojawiło się w obu zwróconych wycinkach danych. Nie określa to pełnego pokrycia grup odbiorców twórców, nie potwierdza aktualnego obserwowania w chwili publikacji ani nie kwalifikuje konta do Outboundu.
Wartości collected_count jasno wskazują mianownik. Jeśli obliczasz udział procentowy, dokładnie go opisz. Przykładowo 3 / 124 oznacza udział wspólnych ID wśród rekordów Jupiter Hikes pobranych w tym zadaniu.
Jeśli wolisz lokalny skrypt uruchamiany w przeglądarce, przeczytaj poradnik o bezpłatnym pobieraniu obserwujących, list obserwowanych kont i autorów postów na Instagramie.
Wzbogać wspólne profile do analizy odbiorców
Wspólna część list dostarcza numerycznych ID Instagrama oraz informacji o pochodzeniu danych. Praktycznym kolejnym krokiem jest przesłanie wspólnych ID do enrichmentu Instagram Profile Scraper, a następnie segmentacja udanych wyników według dostępnej strony internetowej, publicznego adresu e-mail, bio, kategorii lub statystyk profilu.
Dodaj poniższą drugą funkcję pod funkcją źródła. Wykorzystuje ona ten sam klucz API oraz tę samą sekwencję przesyłania, odpytywania o status i paginacji:
def enrich_instagram_profiles(overlap_users, api_key):
"""Retrieve public profile details for the numeric IDs in the overlap."""
if not overlap_users:
return []
tasks_url = "https://api.datablist.com/v1/enrichments/tasks"
headers = {"X-API-Key": api_key}
inputs = [
{
"inputId": user["instagramUserId"],
"data": {"instagramIdentifier": user["instagramUserId"]},
}
for user in overlap_users
]
payload = {
"enrichmentId": "instagram-profile-scraper",
"uniqueId": str(uuid.uuid4()),
"settings": {"scrapeType": "profile"},
"inputs": inputs,
}
response = requests.post(tasks_url, headers=headers, json=payload)
response.raise_for_status()
task = response.json()
task_id = task["@id"]
task_url = f"{tasks_url}/{task_id}"
while task["status"] not in ("completed", "failed", "stopped"):
time.sleep(3)
response = requests.get(task_url, headers=headers)
response.raise_for_status()
task = response.json()
if task["status"] != "completed":
raise RuntimeError(
f"Task {task_id} {task['status']}: {task.get('error')}"
)
profile_results = []
params = {"limit": 100}
while True:
response = requests.get(
f"{task_url}/results",
headers=headers,
params=params,
)
response.raise_for_status()
page = response.json()
profile_results.extend(page["results"])
if page["nextCursor"] is None:
break
params["cursor"] = page["nextCursor"]
return profile_results
profile_results = enrich_instagram_profiles(overlap, api_key)
profiles_with_websites = [
result
for result in profile_results
if result["status"] == "success"
and result["outputs"].get("instagramWebsite")
]
profiles_with_public_email = [
result
for result in profile_results
if result["status"] == "success"
and result["outputs"].get("instagramEmail")
]Jeśli pobrane listy nie mają wspólnych ID, overlap będzie puste, a funkcja zwróci [] przed wysłaniem żądania POST. Możesz kontynuować pracę z pustym segmentem badawczym bez tworzenia płatnego zadania enrichmentu.
Użycie każdego numerycznego ID jednocześnie jako inputId i instagramIdentifier pozwala jednoznacznie połączyć wyniki ze wspólną częścią list. Zachowaj każdy zwrócony obiekt wyniku — również nieudane statusy, puste dane wyjściowe, zużycie kredytów i błędy. Filtruj je dopiero podczas tworzenia lokalnego segmentu.
Tryb profile kosztuje od 2 kredytów za numeryczne ID i może zwrócić publiczne bio, stronę internetową, adres e-mail lub numer telefonu, jeżeli profil je udostępnia, a także statystyki profilu i informacje o kategorii. Odnaleziony profil nadal może mieć puste pola kontaktowe. Kod przygotowuje segmenty badawcze lokalnie. Nie wysyła wiadomości ani nie traktuje wspólnego obserwującego jako osoby, która wyraziła zgodę na kontakt.
Aby wykonać ten etap bez kodowania, użyj Instagram Profile Scraper Datablist.
Przełącz pobieranie na obserwowane konta
To samo źródło może pobierać konta obserwowane przez przesłany profil. Zmień wyłącznie argument scraping_type:
following_results = scrape_instagram_users(
["1507518892"],
api_key,
scraping_type="following",
limit_per_profile=100,
)Te rekordy opisują konta obserwowane przez Jupiter Hikes. Informacje o ich pochodzeniu znajdują się w polach followingSourceProfileId, followingSourceProfileUsername oraz followingSourceProfileUrl. Korzystaj z rzeczywistej liczby zwróconych rekordów, tak samo jak w trybie followers.
Oszacuj koszt API obserwujących Instagram
Źródło obserwujących na Instagramie zużywa 0,01 kredytu za każdego zwróconego obserwującego lub użytkownika obserwowanego przez profil. Rozpoznanie przesłanego profilu źródłowego może kosztować dodatkowo do 1 kredytu. Dane z cache mogą obniżyć faktyczną opłatę.
Dla dwóch profili i żądanego limitu 100 użytkowników na profil szacunkowy koszt wynosi:
2 × (1 + 100 × 0,01) = 4 kredyty
To wartość szacunkowa, a nie maksymalny limit. Zadanie dla dwóch profili zwróciło 170 rekordów relacji i zużyło 2,7 kredytu. Po zakończeniu zadania odczytaj task.credits.used, aby poznać rzeczywisty koszt.
Dostęp do API, kredyty zawarte w planie, opcjonalne doładowania i zużycie przez zadania to oddzielne pozycje. Miesięczny plan Growth kosztuje 50 USD lub 50 EUR i obejmuje dostęp do REST API oraz 20 000 kredytów miesięcznie. Najmniejsze dostępne obecnie doładowanie zapewnia 20 000 kredytów za 20 USD lub 17,50 EUR.
Przy tych stawkach doładowań 1000 zwróconych użytkowników zużywa 10 kredytów. Odpowiada to kosztowi 0,01 USD lub 0,00875 EUR przed rozpoznaniem profilu źródłowego. Jest to znormalizowana wartość zużycia, a nie pakiet dostępny do zakupu: doładowanie nadal kosztuje 20 USD lub 17,50 EUR, a dostęp do API wymaga subskrypcji Growth. Aktualną ofertę znajdziesz w cenniku Datablist.
Opcjonalny Instagram Profile Scraper ma oddzielny koszt. W przypadku numerycznego ID i ustawienia scrapeType: "profile" cena zaczyna się od 2 kredytów za każdy przesłany profil ze wspólnej części list.
Rozwiąż typowe problemy z API i wynikami
Brakuje klucza API
Przed wysłaniem żądania HTTP skrypt zgłasza błąd Set DATABLIST_API_KEY before running this script.. Wyeksportuj zmienną w tej samej powłoce i ponownie uruchom plik.
API odrzuca klucz
response.raise_for_status() zgłasza błąd HTTP. Sprawdź, czy Personal API Key został skopiowany prawidłowo i czy Twoje konto ma dostęp do API w planie Growth. Zachowaj pojedynczy nagłówek X-API-Key użyty w przykładzie.
Nie można rozpoznać profilu źródłowego
Sprawdź, czy każda wartość jest nazwą użytkownika, pełnym adresem URL profilu na Instagramie lub numerycznym ID użytkownika zapisanym jako ciąg znaków. Przed utworzeniem kolejnego płatnego zadania sprawdź istniejące zadanie i jego błąd.
Brakuje kredytów
Sprawdź saldo i zmniejsz liczbę profili lub żądany limit przed przesłaniem kolejnego zadania. Zadanie, które już się rozpoczęło, mogło zużyć część kredytów.
Zadanie nie powiodło się lub zostało zatrzymane
Skrypt wyświetla ID zadania i zgłasza RuntimeError. Użyj tego ID, aby sprawdzić istniejące zadanie, jego pole error, wartość credits.used oraz dostępne wyniki częściowe. Nieudane lub zatrzymane zadanie może zachować wygenerowane wiersze, dlatego sprawdź je przed ponownym przesłaniem.
Liczba wyników różni się od żądanego limitu
Podawaj rzeczywistą liczbę wyników. limitPerProfile jest limitem żądanym i nie gwarantuje dokładnej liczby rekordów. Pojedynczy wynik nie wyjaśnia też, dlaczego dostawca zwrócił mniej lub więcej dostępnych użytkowników.
Odpowiedź po wysłaniu zadania została utracona
Wyświetl ostatnie zadania Sources i dopasuj uniqueId pokazane przed żądaniem POST:
unique_id = "paste-the-printed-unique-id"
response = requests.get(
"https://api.datablist.com/v1/sources/tasks",
headers={"X-API-Key": api_key},
params={"sourceId": "instagram-source", "limit": 100},
)
response.raise_for_status()
for task in response.json()["tasks"]:
if task["uniqueId"] == unique_id:
print(task["@id"], task["status"])Kontynuuj odpytywanie o status tego ID zadania lub pobierz jego istniejące wyniki. Dokumentacja zadań Sources szczegółowo opisuje endpointy listy, statusu, wyników i czasu przechowywania danych.
Co dalej
Masz teraz jedną funkcję Pythona opartą na Requests, której możesz używać wielokrotnie do pobierania relacji z obserwującymi na Instagramie, oraz lokalny raport porównujący listy Jupiter Hikes i Darwin on the Trail według numerycznego ID użytkownika. Każdy wspólny rekord zachowuje oba profile źródłowe.
Zastąp przykłady niewielkim, sprawdzonym zestawem publicznych profili twórców. Świadomie dobierz limit dla każdego profilu, a następnie interpretuj wspólną część list w odniesieniu do rzeczywistej liczby wyników zwróconych dla każdego źródła. Możesz pobrać aktualizowany synchroniczny przykład wykorzystujący Requests albo skorzystać z aktualizowanego asynchronicznego przykładu HTTPX, jeśli potrzebujesz nieblokującej współbieżności. Jeżeli najpierw musisz znaleźć profile źródłowe, zacznij od poradnika o wyszukiwaniu profili na Instagramie według słów kluczowych.



