API di Craigslist
Cerca gli annunci di Craigslist per edizione cittadina e categoria e ottieni prezzi, località e link ai post originali.
Controlla la valuta e il periodo di fatturazione. Non è garantito che l'annuncio sia attivo.
Invia POST https://api.everyinfra.com/api/v1/social con platform impostato su craigslist e action impostato sul nome di una funzionalità dell'elenco qui sotto, ad esempio search.
- 1 funzionalità
- $1.39 per 1.000 richieste
- Nessun addebito per chiamate non riuscite o risultati vuoti
Disponibilità della piattaforma
- Operatività nelle ultime 24 ore
- Normale
Ultimi 30 giorni
Funzionalità disponibili
Ogni azione di Craigslist: cosa fa, quanto costa e come ha funzionato nelle ultime 24 ore. Apri un'azione per vederne parametri, campi della risposta ed esempi di codice.
| Funzionalità | Cosa fa | Per 1.000 | Stato nelle ultime 24 ore · Tutto regolare |
|---|---|---|---|
Ricercasearch | Cerca annunci Craigslist in una città e una sezione a scelta, con titolo, prezzo, località, data, coordinate, immagini e contatti indicati per ogni annuncio. | $1.39 per 1.000 richieste | Normale |
Cosa accetta ogni azione di API di Craigslist?
Ogni risposta qui sotto associa un'azione richiamabile ai suoi input reali. Il significato dei parametri e i valori ammessi dipendono dall'azione: un nome familiare non ha lo stesso significato su tutte le piattaforme.
Le fonti ufficiali sono linkate solo per chiarire il termine della piattaforma accanto a cui compaiono. Non implicano autorizzazione o approvazione da parte della piattaforma e le funzionalità del sito ufficiale non fanno parte dell'API di EveryInfra, a meno che questa pagina non le elenchi.
Consegna Sync per ogni azione.
| Azione | Obbligatori | Facoltativi | Limite | Per 1.000 | Campi della risposta |
|---|---|---|---|---|---|
searchRicerca Cerca annunci Craigslist in una città e una sezione a scelta, con titolo, prezzo, località, data, coordinate, immagini e contatti indicati per ogni annuncio. Nonostante il nome, | keyword | category, country, location, max_price, min_price, region, sort | Valori del catalogo: defaultLimit=20, maxLimit=200. Per alcune azioni limit può controllare le pagine o l'espansione per elemento padre, quindi non è sempre un numero finale di righe. | $1.39 per 1.000 richieste | id · url · title · text · price · currency · category · location · posted_at · lat · lng · emails · phones · images · platform |
Cosa significano i parametri search di API di Craigslist?
Cerca annunci Craigslist in una città e una sezione a scelta, con titolo, prezzo, località, data, coordinate, immagini e contatti indicati per ogni annuncio. Nonostante il nome, country seleziona il sito di una città come newyork o sfbay, e i valori di region non riconosciuti ricadono su New York.
keywordObbligatorio- Specifica il termine di ricerca per gli annunci di Craigslist, ad esempio bicycle. Gli annunci restituiti dipendono dalla categoria selezionata, quindi lo stesso termine può cercare vendite, immobili o offerte di lavoro.
categoryFacoltativo- Specifica lo slug della categoria degli annunci: for_sale (predefinito), cars_trucks, electronics, furniture, housing_apartments_houses, housing_rooms_shares, housing_sublets_temporary, jobs, gigs, resumes, services, community o events.Valori ammessi:
cars_truckscommunityelectronicseventsfor_salefurnituregigshousing_apartments_houseshousing_rooms_shareshousing_sublets_temporaryjobsresumesservicesCraigslist: come funzionano le categorie insieme alle ricerche testuali — La guida ufficiale di Craigslist indica di selezionare una categoria dell'area locale prima di affinare i risultati con query testuali. Il parametro category di questa azione usa i valori neutri definiti sopra e non accetta direttamente i codici di categoria ufficiali della piattaforma o altri filtri del sito. · Verificato countryFacoltativo- Seleziona il sottodominio della città di destinazione, non un codice paese. Accetta i valori elencati nello schema, ad esempio newyork, sfbay o toronto. Se fornito, ha la precedenza sui sottodomini selezionati tramite region o location.Valori ammessi:
anchorageatlantaaustinbaltimorebostoncalgarycharlottechicagocincinnaticlevelandcolumbusdallasdenverdetroitedmontonhartfordhonoluluhoustonindianapoliskansascitylasvegaslosangelesmiamimilwaukeeminneapolismontrealnashvillenewhavennewyorkorlandoottawaphiladelphiaphoenixpittsburghportlandprovidenceraleighrichmondsacramentosalemsaltlakecitysanantoniosandiegoseattlesfbaystlouistampatorontovancouverwashingtondcCraigslist: selezione geografica e ricerche nei sottositi delle città a confronto — Craigslist separa la selezione della posizione geografica dall'elaborazione della query di ricerca, e offre strumenti ufficiali per restringere i risultati tramite mappa e codice ZIP. In questa azione i parametri country / region accettano solo il formato di sottosito cittadino definito sopra e non aggiungono il supporto per filtri per codice postale o per raggio. · Verificato locationFacoltativo- Funge da input di riserva per region e viene valutato solo quando region è omesso. Corrisponde a un sottodominio cittadino di Craigslist, non a indirizzi, CAP o coordinate geografiche.
max_priceFacoltativo- Imposta il prezzo massimo degli annunci per il sottodominio cittadino e la categoria selezionati. Si usa insieme a min_price; valuta e cicli di fatturazione dipendono dai singoli annunci. Il filtro usa numeri interi: i decimali vengono arrotondati per eccesso (145.98 diventa 146).
min_priceFacoltativo- Imposta il prezzo minimo degli annunci per il sottodominio cittadino e la categoria selezionati. Non rappresenta il costo delle richieste API e il significato del prezzo varia tra le categorie, ad esempio tra articoli in vendita e canoni di locazione degli alloggi. Il filtro usa numeri interi: i decimali vengono arrotondati per difetto (39.81 diventa 39).
regionFacoltativo- Specifica lo slug del sottodominio della città, ad esempio newyork, sfbay o toronto. Accetta i valori esatti dell'elenco o alias comuni come nyc, la, dc e sanfrancisco. Gli input non riconosciuti ricadono su newyork; controlla la località restituita invece di dare per scontato che sia stato usato il tuo input.
sortFacoltativo- Ordina i risultati per data di pubblicazione (newest), prezzo crescente (price_asc) o rilevanza (relevance); se omesso, ordina per data di pubblicazione. Non ordina per reputazione del venditore né per volume di transazioni.Valori ammessi:
newestprice_ascrelevance
Come usare l'API di Craigslist
- 01Scegli un'azione della piattaforma dal catalogo pubblico.
- 02Invia piattaforma, azione e parametri obbligatori a POST /api/v1/social.
- 03Leggi il risultato dalla risposta. Per un'azione asincrona, interroga periodicamente il job ID restituito.
- 04Salva i campi della risposta che servono alla tua applicazione.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"craigslist","action":"search","params":{"keyword":"<keyword>"}}'
Domande sull'API di Craigslist
Cosa posso ottenere con l'API di Craigslist?
Imposta platform su craigslist. Il catalogo attuale elenca ricerca. Questi nomi di azione identificano oggetti o viste diversi di Craigslist; non sono modalità di ricerca intercambiabili.
Quale input avvia la richiesta search di Craigslist?
Specifica il termine di ricerca per gli annunci di Craigslist, ad esempio bicycle. Gli annunci restituiti dipendono dalla categoria selezionata, quindi lo stesso termine può cercare vendite, immobili o offerte di lavoro. Invialo come keyword all'interno di params.
Quali campi può restituire search di Craigslist?
Il suo schema dichiarato include title, text, price e currency. Un campo dichiarato può comunque mancare in un singolo record, e ogni altra azione ha il proprio elenco di campi.
Tutte le azioni di Craigslist rispondono subito?
Le azioni indicate come asincrone restituiscono un job ID da interrogare periodicamente. Tutte le altre azioni possono essere eseguite anche in modo asincrono: aggiungi "mode": "async" al corpo della richiesta per ricevere subito un job ID, utile per task lenti o limiti elevati. Il catalogo attuale contiene consegna sync.