सीधे सामग्री पर जाएँ
HI
API कुंजी प्राप्त करें
दस्तावेज़ देखें

API संदर्भ

स्थानीय व्यवसायों और स्थानों के लिए खोजें। उपलब्ध होने पर नाम, पते, निर्देशांक, रेटिंग और संपर्क विवरण पुनर्प्राप्त करें।

अनुरोध बनाएँ

उन्नत पैरामीटर

1 पर शुरू होता है। प्रत्येक पृष्ठ एक अलग अनुरोध है।

Google tbs अभिव्यक्ति समर्थित फ़िल्टर खोज प्रकार द्वारा भिन्न होते हैं।

POSThttps://data.flashdata.dev/v1/queries/realtime
Python 3 · requests
python3 -m pip install requests
import json

import requests

api_key = "YOUR_API_KEY"
payload = {
    "source": "google_places",
    "query": "coffee in san francisco",
    "params": {
        "gl": "us",
        "hl": "en",
        "num": 10,
        "page": 1,
    },
}

response = requests.post(
    "https://data.flashdata.dev/v1/queries/realtime",
    headers={"X-API-Key": api_key, "Accept": "application/json"},
    json=payload,
    timeout=120,
)
response.raise_for_status()
print(json.dumps(response.json(), ensure_ascii=False, indent=2))
परिणाम HTTP उत्तरदायित्वX-API-Key प्रमाणीकरण

पैरामीटर

भेजें source और query शीर्ष स्तर पर। स्रोत विकल्प params. वैकल्पिक क्षेत्रों को छोड़ा जा सकता है।

अनुरोध का मुख्य भाग

sourcestring / ज़रूरी
google_places को सेट करें।
querystring / ज़रूरी
क्वेरी खोजें। इस तरह के साइट के रूप में Google खोज ऑपरेटरों का समर्थन करता है: और intitle:
1 to 2,000 वर्णडिफ़ॉल्ट: सेट नहीं
paramsobject / वैकल्पिक
इस अनुरोध के लिए Settings
डिफ़ॉल्ट: {}
callback_urlstring · nullable / वैकल्पिक
केवल Async और बैच। सार्वजनिक HTTPS पूरा होने URL बंदरगाह 443 पर, 2,048 वर्ण तक। कोई उपयोगकर्ता क्रेडेंशियल या URL खंड नहीं। Omit, उपयोग null या कोई अधिसूचना के लिए एक खाली स्ट्रिंग। एक बैच में, इसे प्रत्येक क्वेरी पर सेट करें, बाहर के पैराम।
डिफ़ॉल्ट: सेट नहीं

देश, भाषा और स्थान

params.glstring / वैकल्पिक
दो-अक्षर देश कोड, जैसे कि हम, जीबी, डी या एसजी। एक देश का चयन करने के लिए स्पष्ट रूप से सेट करें।
Exactly 2 वर्णडिफ़ॉल्ट: सेट नहीं
स्वीकृत प्रारूप^[A-Za-z]{2}$
params.hlstring / वैकल्पिक
Google इंटरफ़ेस भाषा। एक भाषा का चयन करने के लिए स्पष्ट रूप से सेट करें।
1 to 35 वर्णडिफ़ॉल्ट: सेट नहीं
स्वीकृत प्रारूप^[A-Za-z0-9-]+$
params.locationstring / वैकल्पिक
अनुरोधित खोज स्थान, अधिमानतः एक शहर, जैसे "London, England, United Kingdom"। उपलब्धता खोज प्रकार पर निर्भर करती है।
1 to 200 वर्णडिफ़ॉल्ट: सेट नहीं

पगिनेशन

params.numinteger / वैकल्पिक
अनुरोधित परिणाम गिनती। FlashData एक निश्चित डिफ़ॉल्ट नहीं है जब omitted है। वापसी की गिनती क्वेरी और खोज प्रकार से भिन्न हो सकती है।
1 to 100, पूरी संख्याडिफ़ॉल्ट: सेट नहीं
params.pageinteger / वैकल्पिक
अनुरोधित परिणाम पृष्ठ। स्पष्ट रूप से सेट करें। प्रत्येक पृष्ठ एक अलग API अनुरोध है।
1 to 100, पूरी संख्याडिफ़ॉल्ट: सेट नहीं

फ़िल्टर खोजें

params.tbsstring / वैकल्पिक
अनुरोधित Google खोज फ़िल्टर, जैसे कि Qdr:d पिछले दिन या qdr: w के लिए पिछले सप्ताह के लिए। उपलब्धता खोज प्रकार पर निर्भर करती है।
1 to 200 वर्णडिफ़ॉल्ट: सेट नहीं
params.autocorrectboolean / वैकल्पिक
true के साथ वर्तनी सुधार का अनुरोध करें या इसे false के साथ अक्षम करने का अनुरोध करें। एप्लाइड व्यवहार खोज के प्रकार पर निर्भर करता है; Google के व्यवहार का उपयोग करने के लिए मत।
true या falseडिफ़ॉल्ट: सेट नहीं

जवाब

Realtime रिटर्न status: done में खोज उत्पादन के साथ results[0]. मैच में हैं results[0].places. usage.credits चार्ज रिकॉर्ड करता है।

परिणाम उपलब्ध होने पर पते और निर्देशांक सहित स्थानों का वर्णन करते हैं। रेटिंग और संपर्क विवरण वैकल्पिक हैं; भूगोल के मामले में स्पष्ट देश और स्थान सेटिंग का उपयोग करें।

परिणाम पढ़ें

सफल JSON प्रतिक्रिया को response.json के रूप में सहेजें। इसे read-response.py के रूप में सहेजें और python read-response.py चलाएं। यह केवल Python के मानक पुस्तकालय का उपयोग करता है और कोई नया अनुरोध नहीं करता है।

read-response.py
import json
from pathlib import Path

response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
    raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
    print("[]")
    raise SystemExit(0)
result = response["results"][0]

output = [
    {name: item.get(name) for name in ("title", "address", "latitude", "longitude", "website")}
    for item in result.get("places", [])
]
print(json.dumps(output, ensure_ascii=False, indent=2))

उपलब्ध फ़ील्ड क्वेरी और खोज प्रकार पर निर्भर करती हैं। वैकल्पिक फ़ील्ड अनुपस्थित हो सकते हैं और अतिरिक्त फ़ील्ड वापस आ सकते हैं।

लौटाने वाले आइटम और searchParameters.num की संख्या params.num से भिन्न हो सकती है। वास्तविक परिणाम गिनती निर्धारित करने के लिए रिटर्न की सरणी का उपयोग करें।

सभी प्रतिक्रिया क्षेत्र
फील्डविवरण
sourcestringअनुरोधित API स्रोत।
statusstringजब रियलटाइम अनुरोध सफल होता है तो किया जाता है।
created_atstringISO 8601 प्रारूप में प्रतिक्रिया निर्माण समय।
usage.creditsnumberआपकी योजना के आधार पर अनुरोध के लिए शुल्क लिया गया क्रेडिट।
results[0].searchParametersobjectखोज सेटिंग्स की रिपोर्ट Google द्वारा की गई है, जिसमें क्वेरी Q के रूप में दर्ज की गई है। रिटर्न सेटिंग्स अनुरोधित मूल्यों से भिन्न हो सकती है।
results[0].placesarrayस्थानीय खोज परिणाम।
results[0].places[].titlestringस्थान या व्यापारिक नाम।
results[0].places[].addressstring · optionalसड़क का पता
results[0].places[].latitudenumber · optionalअक्षांश।
results[0].places[].longitudenumber · optionalअक्षांश।
results[0].places[].ratingnumber · optionalऔसत रेटिंग।
results[0].places[].ratingCountinteger · optionalरेटिंग की संख्या।
results[0].places[].categorystring · optionalव्यवसाय श्रेणी
results[0].places[].phoneNumberstring · optionalसूचीबद्ध फ़ोन नंबर।
results[0].places[].websitestring · optionalव्यापार वेबसाइट।
results[0].places[].cidstring · optionalGoogle स्थान पहचानकर्ता।
results[0].places[].positionintegerपरिणाम स्थिति।
results[0].places[].priceLevelstring · optionalउपलब्ध होने पर प्रदर्शित मूल्य स्तर।

ऊपर दिए गए फ़ील्ड डिफ़ॉल्ट JSON प्रतिक्रिया का वर्णन करते हैं। JSON, सादे पाठ और Markdown प्रारूप.

Async & बैच जीवनचक्र

सबमिशन एक रसीद लौटाता है, परिणाम नहीं देता है। Async एक नौकरी बनाता है; बैच में एक अलग काम देता है queries[] प्रत्येक स्वीकृत क्वेरी के लिए। प्रत्येक नौकरी को स्वतंत्र रूप से ट्रैक और पुनर्प्राप्त करें।

प्रस्तुत करना data.flashdata.dev; नौकरी की स्थिति और परिणाम पढ़ने से api.flashdata.dev उसी X-API-Key के साथ। लिंक्ड API मूलभूत उदाहरण Python और cURL का उपयोग करते हैं।

  1. 1. नौकरी बचाओ IDs

    इस स्रोत के अनुरोध फ़ील्ड को Async पर स्विच करते समय रखें। Batch के लिए, प्रत्येक अनुरोध को एक JSON ऑब्जेक्ट की क्वेरी सरणी के अंदर रखें। प्रत्येक वापसी कार्य ID बचाओ।

    Async अनुरोध और रसीद · Batch अनुरोध शरीर

  2. 2. स्थिति की जाँच करें

    GET https://api.flashdata.dev/v2/jobs/{jobId}

    pending / processing: देरी और सम्मान के साथ मतदान Retry-After जब उपस्थित हो। completed: परिणाम प्राप्त करें। failed: निरीक्षण job.error.

    job.status पढ़ें, प्रस्तुतीकरण रसीद की स्थिति नहीं।

    चेक स्थिति · Python और cURL

    नौकरी की स्थिति API संदर्भ
  3. 3. Fetch परिणाम

    GET https://api.flashdata.dev/v2/jobs/{jobId}/results

    पूरा होने के बाद, परिणाम को प्रमाणित करें, फिर अपने API कुंजी के बिना 302 संग्रहण URL प्राप्त करें। JSON को 24 घंटे पूरा होने के भीतर सहेजें।

    Fetch परिणाम · Python और cURL · जवाब के फ़ॉर्मैट

    परिणाम डाउनलोड API

मतदान और मौजूदा परिणाम प्राप्त करने के लिए क्वेरी क्रेडिट का उपभोग नहीं करते हैं। एक मतदान टाइमआउट नौकरी को रद्द नहीं करता है: डुप्लिकेट बिलेबल वर्क जमा करने के बजाय अपने ID को रखें। त्रुटि कोड और पुनर्प्राप्ति व्यवहार.

पूरा होने पर वेबहुक

क्वेरी के अनुसार सदस्यता लें

सेट callback_url एक async अनुरोध के शीर्ष स्तर पर, या प्रत्येक क्वेरी के अंदर एक बैच में, बाहर params. कोई अलग वेबहुक पंजीकरण अनुरोध की आवश्यकता नहीं है। Realtime अनुरोध कॉलबैक नहीं भेजता है।

पोर्ट 443 पर एक सार्वजनिक HTTPS URL का उपयोग करें। FlashData POSTs प्रत्येक नौकरी के लिए एक अधिसूचना तक पहुँचने के लिए completed या failed; इस घटना में लिंक शामिल हैं, न कि परिणाम स्वयं।

स्वीकार करना और सत्यापित करना

वापसी 2xx इस घटना को स्वीकार करने के बाद। Deduplicate by Deduplicate delivery_id, भी भेजा गया X-Delivery-Id. पुनर्निर्देशन का पालन नहीं किया जाता।

विफल प्रसव एक्सोनेंशियल बैकऑफ़ के साथ वापसी, अप करने के लिए 8 कुल प्रयास करता है और अधिक पूरा होने के बाद 24 घंटे. मतदान को गिरने के रूप में रखें।

कॉलबैक को इस्तीफा नहीं दिया जाता है। नौकरी की पुष्टि करें ID, स्रोत और टर्मिनल स्थिति के माध्यम से प्रमाणित स्थिति समापन बिंदु अधिसूचना को संसाधित करने से पहले। वितरण ID, deduplication के लिए है, प्रामाणिकता का प्रमाण नहीं है।

उदाहरण वेबहुक घटना और फ़ील्ड
इलस्ट्रेटिव पूर्णता अधिसूचना
{
  "delivery_id": "completion:job_example0001",
  "id": "job_example0001",
  "source": "google_places",
  "status": "completed",
  "links": [
    {
      "rel": "self",
      "href": "https://api.flashdata.dev/v2/jobs/job_example0001",
      "method": "GET"
    },
    {
      "rel": "results",
      "href": "https://api.flashdata.dev/v2/jobs/job_example0001/results",
      "method": "GET"
    }
  ]
}
फील्डविवरण
delivery_idstringस्थिर वितरण पहचानकर्ता। इस मूल्य का उपयोग करके Deduplicate नोटिफिकेशन; इसे X-Delivery-Id हेडर में भी भेजा जाता है।
idstringनौकरी ID
sourcestringअनुरोधित डेटा स्रोत।
statusstringपूरा या विफल हो गया।
linksarrayस्थिति और परिणाम लिंक। अधिसूचनाओं में परिणाम सामग्री या एक API कुंजी शामिल नहीं है।
links[].relstringस्वयं या परिणाम।
links[].hrefstringपूर्ण प्रबंधन API URL; अपने API कुंजी के साथ प्रमाणित।
links[].methodstringGET.

पूर्ण वेबहुक अनुबंध और URL प्रतिबंध

त्रुटि

एक पूर्ण खोज में अनुरोध से कम मैच हो सकते हैं। चेक gl, hl, स्थान और फ़िल्टर; वैकल्पिक अमीर-विराम क्षेत्र अनुपस्थित हो सकता है।

प्रमाणीकरण, संतुलन, अनुरोध प्रारूप और दर सीमा विफलताओं के लिए, साझा त्रुटि संदर्भ का उपयोग करें। अभी भी एक नौकरी का निर्माण हो सकता है; पुनः प्रयास करने से पहले मौजूदा काम की जांच करें।

त्रुटियाँ और स्टेटस कोड · कब्ज़ा · दर सीमा

चरण-दर-चरण गाइड: एक Google खोज को चुनें और परिष्कृत करें

कीमतें

योजनाउपयोग की दरेंप्रति 1,000 अनुरोधसदस्यताप्रति बिलिंग अवधि में क्रेडिट शामिल
इस्तेमाल के अनुसार भुगतान$1.00कोई मासिक शुल्क नहींज़रूरत पर रिचार्ज करें
Micro$0.80$49.00 / महीना1,000 क्रेडिट्स ($50.00 of API उपयोग) में शामिल
Starter$0.65$199.00 / महीना4,000 क्रेडिट्स ($200.00 of API उपयोग) में शामिल
Pro$0.60$499.00 / महीना10,000 क्रेडिट्स ($500.00 of API उपयोग) में शामिल
Scale$0.50$999.00 / महीना20,000 क्रेडिट्स ($1,000.00 of API उपयोग) में शामिल
Business$0.40$1,999.00 / महीना40,000 क्रेडिट्स ($2,000.00 of API उपयोग) में शामिल

एक खाता प्लान। तीनों उत्पादों में साझा क्रेडिट। शामिल क्रेडिट से चुकाए गए उपयोग पर दोबारा शुल्क नहीं लगता।

वर्तमान मूल्य और योजना सीमा