واجهة بحث Google في Java: شرح كامل (2026)

استعلم عن Google من Java باستخدام المكتبة القياسية فقط، عبر serp.cheap — أو أضِف حزمة Java SDK الرسمية (تكامل Spring Boot مشمول). في كلتا الحالتين هي نقطة نهاية HTTP+JSON بسيطة.

لنبدأ بفحص سريع عبر curl:

curl -X POST https://api.serp.cheap/v1/search \
  -H "X-API-Key: $SERP_CHEAP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"q":"best electric cars 2026","gl":"us"}'

المثال الكامل

ملف واحد قابل للتشغيل على Java 17 فما فوق، يستخدم java.net.http للطلب و Jackson لمعالجة JSON (com.fasterxml.jackson.core:jackson-databind). اضبط SERP_CHEAP_API_KEY أولًا.

import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.util.List;

public class SerpSearch {
    static final ObjectMapper M = new ObjectMapper();

    @JsonIgnoreProperties(ignoreUnknown = true)
    record Organic(int position, String title, String link, String snippet) {}

    @JsonIgnoreProperties(ignoreUnknown = true)
    record SearchResponse(List<Organic> organic) {}

    public static void main(String[] args) throws Exception {
        String key = System.getenv("SERP_CHEAP_API_KEY");
        String body = M.writeValueAsString(new java.util.HashMap<>() {{
            put("q", "best electric cars 2026");
            put("gl", "us");
        }});

        HttpRequest req = HttpRequest.newBuilder()
            .uri(URI.create("https://api.serp.cheap/v1/search"))
            .header("X-API-Key", key)
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(body))
            .build();

        HttpResponse<String> res = HttpClient.newHttpClient()
            .send(req, HttpResponse.BodyHandlers.ofString());

        SearchResponse data = M.readValue(res.body(), SearchResponse.class);
        for (Organic r : data.organic()) {
            System.out.printf("%2d. %s%n    %s%n", r.position(), r.title(), r.link());
        }
    }
}

تعيّن الـ records بيانات JSON بأناقة، ويعني @JsonIgnoreProperties(ignoreUnknown = true) أن الحقول الجديدة في الاستجابة لن تكسر بناءك أبدًا.

Spring Boot

في تطبيق Spring، غلّف الاستدعاء نفسه داخل @Service باستخدام RestClient (‏Spring 6.1 فما فوق):

@Service
public class SerpClient {
    private final RestClient http = RestClient.builder()
        .baseUrl("https://api.serp.cheap")
        .defaultHeader("X-API-Key", System.getenv("SERP_CHEAP_API_KEY"))
        .build();

    public SearchResponse search(String q, String gl) {
        return http.post().uri("/v1/search")
            .body(java.util.Map.of("q", q, "gl", gl))
            .retrieve()
            .body(SearchResponse.class);
    }
}

توفّر حزمة Java SDK الرسمية هذا الربط جاهزًا — إضافةً إلى إعادة المحاولة والتصفّح والمعاملات المُنمّطة — بصيغة Spring Boot starter، فتحقن SerpClient وتبدأ العمل.

معاملات جديرة بالمعرفة

• gl — بلد النتائج (us، de، br، …). راجع السيو المحلي حسب البلد.
• hl — لغة الواجهة.
• page — يبدأ من 1؛ كل صفحة هي طلب منفصل. راجع التصفّح.
• tbs — مرشّح زمني (qdr:d = آخر يوم). راجع المرجع الكامل للمعاملات.

التالي

• واجهة بحث Google في Go
• واجهة بحث Google في Node.js
• كيفية استخدام واجهة بحث Google

جرّب serp.cheap

انسخ الملف أعلاه، أضِف مفتاحك، وستحصل على نتائج Google مباشرة في Java. ‏100 عملية بحث مجانية عند التسجيل — دون بطاقة؛ ثم الدفع حسب الاستخدام من 0.75 دولار لكل 1000 بعد ذلك، وتبقى الأرصدة صالحة لمدة 12 شهرًا.

• احصل على مفتاح API المجاني ←
• تفضّل الدفع بالبطاقة؟ تتوفر serp.cheap أيضًا على RapidAPI (‏0.90 دولار لكل 1000) وApify (‏1.50 دولار لكل 1000).