EveryInfra

API de plataforma de EveryData

API de Craigslist

Busca anuncios clasificados de Craigslist dentro de una ciudad y una categoría concretas. En este contrato, `country` selecciona un sitio local como `newyork`, `sfbay` o `toronto`; no representa un código de país.

El significado de `price` depende de la categoría: puede ser el precio de un artículo, el alquiler de una vivienda u otra cifra del anuncio. Los correos y teléfonos solo aparecen cuando el anuncio los expone y no implican permiso para contacto masivo.

Empieza gratis Ver el catálogo público
Endpoint
POST /api/v1/social
Funciones
1
Por 1.000
1,389 US$

Funciones disponibles

Compara las acciones de Craigslist por sus entradas obligatorias, datos devueltos y precio. Usa el identificador de la acción exactamente como aparece.

AcciónObligatoriosOpcionalesEntregaLímitePor 1.000Campos de respuesta
search

Buscar clasificados por ciudad y categoría

Elige el sitio local con country o region, la sección con category y el texto con keyword. min_price y max_price filtran el importe anunciado, no el coste de la API. La respuesta puede incluir category, location, price, currency, coordenadas, imágenes y datos de contacto; cada valor debe verificarse en el anuncio original.

keywordcategory, country, location, max_price, min_price, region, sortEntrega síncronaEl catálogo declara `defaultLimit = 20` y `maxLimit = 200` para el límite de esta acción. Según el contrato concreto, la unidad puede aplicarse a una página, a cada elemento padre o a otra unidad propia de la acción; no es necesariamente el total final de filas de toda la solicitud.$1.39 por 1.000 solicitudesid · url · title · text · price · currency · category · location · posted_at · lat · lng · emails · phones · images · platform

¿Qué acepta cada acción de Craigslist?

Cada respuesta enlaza una acción ejecutable con sus entradas reales. El significado y los valores permitidos pertenecen a esa acción; un nombre parecido no conserva automáticamente el mismo sentido en otra plataforma.

Las fuentes oficiales se enlazan solo para precisar el término de la plataforma indicado a su lado. No implican autorización ni respaldo y no añaden a EveryInfra funciones del sitio oficial.

¿Qué significan los parámetros de Craigslist search?

Elige el sitio local con country o region, la sección con category y el texto con keyword. min_price y max_price filtran el importe anunciado, no el coste de la API. La respuesta puede incluir category, location, price, currency, coordenadas, imágenes y datos de contacto; cada valor debe verificarse en el anuncio original.

keywordObligatorio
Término de búsqueda de anuncios en Craigslist, como «bicycle». El tipo de resultado depende de category; la misma palabra se puede buscar en las categorías de venta, alquiler o empleo.
categoryOpcional
Categoría del anuncio: for_sale (venta), cars_trucks (coches y camiones), electronics (electrónica), furniture (muebles), housing_apartments_houses (alquiler completo), housing_rooms_shares (piso compartido), housing_sublets_temporary (alquiler temporal), jobs (empleo), gigs (trabajos esporádicos), resumes (currículums), services (servicios), community (comunidad) y events (eventos). El valor por defecto es for_sale.
Valores permitidos:cars_truckscommunityelectronicseventsfor_salefurnituregigshousing_apartments_houseshousing_rooms_shareshousing_sublets_temporaryjobsresumesservices
Craigslist: cómo combinar la búsqueda por texto con el directorio de categoríasLa ayuda oficial explica que primero se debe elegir una categoría en la región correspondiente y luego usar una consulta de texto para refinar los resultados. El parámetro `category` de esta API utiliza los valores neutros indicados y no acepta directamente los códigos de categoría del sitio oficial ni otros filtros como parámetros válidos.Consultada
countryOpcional
En esta plataforma, country se refiere en realidad a la selección del sitio local de la ciudad, no a un código de país como US o CA. Elige uno de los valores de ciudad listados en esta API, como newyork, sfbay o toronto. Si se proporciona a la vez, tiene prioridad sobre la selección de sitio local de region o location.
Valores permitidos:anchorageatlantaaustinbaltimorebostoncalgarycharlottechicagocincinnaticlevelandcolumbusdallasdenverdetroitedmontonhartfordhonoluluhoustonindianapoliskansascitylasvegaslosangelesmiamimilwaukeeminneapolismontrealnashvillenewhavennewyorkorlandoottawaphiladelphiaphoenixpittsburghportlandprovidenceraleighrichmondsacramentosalemsaltlakecitysanantoniosandiegoseattlesfbaystlouistampatorontovancouverwashingtondc
Craigslist: buscar primero por sitio local y categoríaCraigslist separa la selección geográfica de la consulta y permite afinar después dentro de una categoría. En esta API `country` y `region` aceptan sitios locales como `sfbay`; la ayuda oficial no autoriza a inventar filtros de código postal o radio.Consultada
locationOpcional
Parámetro compatible con region, se usa solo si region no se ha proporcionado. También se interpreta como el sitio local de Craigslist, no como una dirección, código postal o coordenadas.
max_priceOpcional
Importe máximo del anuncio en el sitio local y la categoría seleccionados. Es un valor numérico y se usa con min_price. La moneda y el periodo de facturación dependen de cada anuncio.
min_priceOpcional
Importe mínimo del anuncio en el sitio local y la categoría seleccionados. Es un valor numérico y no es el coste de la llamada a la API. El significado del precio puede variar según la categoría; por ejemplo, el precio de venta de un artículo de segunda mano y el alquiler de una vivienda no son directamente comparables.
regionOpcional
Slug del sitio local, como newyork, sfbay o toronto. La lista completa de sitios locales coincide con la lista de ciudades del parámetro country de esta API. Es compatible con variantes como nyc, la, dc o sanfrancisco. Los valores no reconocidos se resuelven actualmente como newyork; comprueba la ubicación devuelta, no des por hecho que la búsqueda se ha realizado en la región que indicaste.
sortOpcional
Orden de la lista: newest por fecha de publicación, price_asc por precio de menor a mayor y relevance por relevancia. Si no se especifica, se usa la fecha de publicación. No ordena por reputación del vendedor ni por volumen de transacciones.
Valores permitidos:newestprice_ascrelevance

Cómo usar la API de Craigslist

  1. 01Consulta el catálogo público y elige una acción de la plataforma.
  2. 02Envía los parámetros platform y action, junto con los campos obligatorios, a POST /api/v1/social.
  3. 03Procesa el resultado síncrono o consulta el identificador de trabajo devuelto si la acción es asíncrona.
  4. 04Guarda los campos de la respuesta estructurada que necesita tu aplicación.
craigslist_search.sh
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>"}}'

Preguntas sobre la API de Craigslist

¿Cómo llamo a la API de Craigslist?

Envía POST /api/v1/social con platform igual a craigslist, elige uno de los identificadores de acción indicados e incluye sus parámetros obligatorios.

¿Qué devuelve la API de Craigslist?

Devuelve JSON estructurado. Por ejemplo, el esquema de search incluye title, text, price y currency. Cada acción tiene su propia lista de campos; que un campo esté declarado no garantiza que todos los registros de origen contengan un valor.

¿Qué matiz de la documentación oficial conviene conservar al usar datos de Craigslist?

Craigslist separa la selección geográfica de la consulta y permite afinar después dentro de una categoría. En esta API country y region aceptan sitios locales como sfbay; la ayuda oficial no autoriza a inventar filtros de código postal o radio.

¿Qué parámetros son obligatorios?

Depende de la acción. search requiere keyword.

1688 APIAliExpress APIAmazon APIeBay APIEtsy APIShopee APITaobao APITemu APIVer el catálogo público →