Wyodrębnij dane strukturalne z dowolnej strony
Wybierz potrzebne pola. Dostań je jako czysty JSON.


# Wireless Mouse — Model X**$49.00** · In stock · 4.6 (1,284 reviews)Low-latency 2.4 GHz receiver, 70-day battery lifei ciche przełączniki.| Spec | Value || --------- | ------------ || Connection| 2.4 GHz, BT5 || Battery | 70 days |Menu, stopki i reklamy usunięte: od 3% do 24% tokenów surowego HTML. Przykładowa strona.
Pełna odpowiedź: status, adres URL, silnik i dane. Przykładowa strona.
Informacje o stronie, reguły CSS lub JSON Schema z selektorami. Przykładowa strona.
Kroki do wykonania na stronie, w renderowaniu w pełnej przeglądarce.
Jak to działa
- Nazwij swoje pola i podaj dla każdego selektor CSS.
- Wyślij je w
extractz adresem URL strony. - Czytaj JSON. Twoje pola są w
data.
curl https://api.spicrawl.com/v1/scrape \
-H "Authorization: Bearer $SPICRAWL_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://example.com/products/42",
"extract": { "title": "h1", "price": ".price", "next_page": "a.next@href" }
}'import os, requests
r = requests.post(
"https://api.spicrawl.com/v1/scrape",
headers={"Authorization": f"Bearer {os.environ['SPICRAWL_API_KEY']}"},
json={
"url": "https://example.com/products/42",
"extract": {"title": "h1", "price": ".price", "next_page": "a.next@href"},
},
timeout=120,
)
env = r.json()
print(env["data"], env.get("empty_fields"))spicrawl scrape https://example.com/products/42 \
--extract '{"title":"h1","price":".price","next_page":"a.next@href"}'{
"status": 200,
"data": {
"title": "Walnut Desk",
"price": "$349.00"
},
"empty_fields": ["next_page"]
}empty_fields wymienia pola, które niczego nie znalazły. To często pierwszy znak, że witryna zmieniła układ.
Trzy sposoby na dane
| Sposób | Co wysyłasz | Co dostajesz |
|---|---|---|
autoparse | "autoparse": true | Własny JSON-LD, OpenGraph, microdata, metadane i stan aplikacji strony |
| Mapa selektorów | Nazwy pól i selektory CSS | Dokładnie te pola, jako tekst |
| JSON Schema | Schemat, którego pola mają selektory | Typowane, sprawdzone wartości, więc "$1,234.56" staje się 1234.56 |
Warto wiedzieć
- Bez dodatkowych kredytów do ekstrakcji. Płacisz tylko za żądanie: 1 kredyt zwykłe, 3 z JavaScriptem.
- Wkrótce: ekstrakcja z promptu w zwykłym języku. Dziś używaj selektorów, schematu lub autoparse.
- Nie w batchu. Ekstrakcja działa tylko w pojedynczych scrape'ach.
- Twoja odpowiedzialność: wyodrębniaj tylko dane, do których masz prawo. Zobacz nasze regulamin.
Najczęściej zadawane pytania
Jak wyodrębnić dane ze strony jako JSON?
Wyślij extract z mapą nazw pól na selektory CSS, na przykład "title": "h1" i "price": ".price". Wartości wracają w data w odpowiedzi JSON.
Co robi autoparse?
Zwraca to, co strona już mówi o sobie, bez selektorów: JSON-LD, OpenGraph, Twitter Card, microdata, RDFa, metadane head i osadzony stan aplikacji.
Czy może zwracać liczby zamiast tekstu?
Tak. Użyj JSON Schema, której właściwości mają selektor. Wartości są konwertowane do zadeklarowanego typu, więc "$1,234.56" staje się 1234.56, a wynik jest sprawdzany względem schematu.
Skąd mam wiedzieć, że strona zmieniła układ?
Sprawdź empty_fields w odpowiedzi. Wymienia pola, których selektor niczego nie znalazł, co często jest pierwszą oznaką zmiany w kodzie strony.
Czy mogę opisać pola zwykłymi słowami zamiast selektorami?
Jeszcze nie. Ekstrakcja na podstawie promptu modelu jest wkrótce. Dziś użyj selektorów, schematu JSON Schema lub autoparse.