# Craigslist

## Overview

| Property | Value |
|----------|-------|
| **Status** | private |
| **Method** | `GET` |
| **Endpoint** | `/v2/craigslist` |
| **Base URL** | `https://api.piloterr.com` |
| **Credit Cost** | 1 credit per call |
| **Documentation** | https://www.piloterr.com/library/craigslist |

## Description

Automate data extraction from Craigslist Toulouse. Get real-time updates on rentals, jobs, market trends, and more.

## Authentication

- **Key Name:** `x-api-key`
- **Location:** HTTP Header
- **Get an API key:** https://app.piloterr.com/register

## Example Request

```bash
curl --location --request GET 'https://api.piloterr.com/v2/craigslist' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY'
```

## Example Response

### Example

```json
{
  "title": "toulouse craigslist",
  "sections": [
    {
      "link": "/d/community/search/ccc",
      "name": "community",
      "categories": [
        {
          "link": "/d/activities/search/act",
          "name": "activities"
        },
        {
          "link": "/d/artists/search/ats",
          "name": "artists"
        },
        {
          "link": "/d/childcare/search/kid",
          "name": "childcare"
        },
        {
          "link": "/d/classes/search/cls",
          "name": "classes"
        },
        {
          "link": "/d/events/search/eve",
          "name": "events"
        },
        {
          "link": "/d/general/search/com",
          "name": "general"
        },
        {
          "link": "/d/groups/search/grp",
          "name": "groups"
        },
        {
          "link": "/d/local-news-and-views/search/vnn",
          "name": "local news"
        },
        {
          "link": "/d/lost-found/search/laf",
          "name": "lost+found"
        },
        {
          "link": "/d/missed-connections/search/mis",
          "name": "missed connections"
        },
        {
          "link": "/d/musicians/search/muc",
          "name": "musicians"
        },
        {
          "link": "/d/pets/search/pet",
          "name": "pets"
        },
        {
          "link": "/d/politics/search/pol",
          "name": "politics"
        },
        {
          "link": "/d/rants-raves/search/rnr",
          "name": "rants & raves"
        },
        {
          "link": "/d/rideshare/search/rid",
          "name": "rideshare"
        },
        {
          "link": "/d/volunteers/search/vol",
          "name": "volunteers"
        }
      ]
    },
    {
      "link": "/d/services/search/bbb",
      "name": "services",
      "categories": [
        {
          "link": "/d/automotive-services/search/aos",
          "name": "automotive"
        },
        {
          "link": "/d/beauty-services/search/bts",
          "name": "beauty"
        },
        {
          "link": "/d/cell-phone-mobile-services/search/cms",
          "name": "cell/mobile"
        },
        {
          "link": "/d/computer-services/search/cps",
          "name": "computer"
        },
        {
          "link": "/d/creative-services/search/crs",
          "name": "creative"
        },
        {
          "link": "/d/cycle-services/search/cys",
          "name": "cycle"
        },
        {
          "link": "/d/event-services/search/evs",
          "name": "event"
        },
        {
          "link": "/d/farm-garden-services/search/fgs",
          "name": "farm & garden"
        },
        {
          "link": "/d/financial-services/search/fns",
          "name": "financial"
        },
        {
          "link": "/d/health-wellness-services/search/hws",
          "name": "health/well"
        },
        {
          "link": "/d/household-services/search/hss",
          "name": "household"
        },
        {
          "link": "/d/labor-hauling-moving/search/lbs",
          "name": "labor/move"
        },
        {
          "link": "/d/legal-services/search/lgs",
          "name": "legal"
        },
        {
          "link": "/d/lessons-tutoring/search/lss",
          "name": "lessons"
        },
        {
          "link": "/d/marine-services/search/mas",
          "name": "marine"
        },
        {
          "link": "/d/pet-services/search/pas",
          "name": "pet"
        },
        {
          "link": "/d/real-estate-services/search/rts",
          "name": "real estate"
        },
        {
          "link": "/d/skilled-trade-services/search/sks",
          "name": "skilled trade"
        },
        {
          "link": "/d/small-biz-ads/search/biz",
          "name": "small biz ads"
        },
        {
          "link": "/d/therapeutic-services/search/thp",
          "name": "therapeutic"
        },
        {
          "link": "/d/travel-vacation-services/search/trv",
          "name": "travel/vac"
        },
        {
          "link": "/d/writing-editing-translation/search/wet",
          "name": "write/ed/tr8"
        }
      ]
    },
    {
      "link": "/d/housing/search/hhh",
      "name": "housing",
      "categories": [
        {
          "link": "/d/apts-housing-for-rent/search/apa",
          "name": "apts / housing"
        },
        {
          "link": "/d/housing-swap/search/swp",
          "name": "housing swap"
        },
        {
          "link": "/d/housing-wanted/search/hsw",
          "name": "housing wanted"
        },
        {
          "link": "/d/office-commercial/search/off",
          "name": "office / commercial"
        },
        {
          "link": "/d/parking-storage/search/prk",
          "name": "parking / storage"
        },
        {
          "link": "/d/real-estate-for-sale/search/rea",
          "name": "real estate for sale"
        },
        {
          "link": "/d/rooms-shares/search/roo",
          "name": "rooms / shared"
        },
        {
          "link": "/d/rooms-wanted/search/sha",
          "name": "rooms wanted"
        },
        {
          "link": "/d/sublets-temporary/search/sub",
          "name": "sublets / temporary"
        },
        {
          "link": "/d/vacation-rentals/search/vac",
          "name": "vacation rentals"
        }
      ]
    },
    {
      "link": "/d/for-sale/search/sss",
      "name": "for sale",
      "categories": [
        {
          "link": "/d/antiques/search/ata",
          "name": "antiques"
        },
        {
          "link": "/d/appliances/search/ppa",
          "name": "appliances"
        },
        {
          "link": "/d/arts-crafts/search/ara",
          "name": "arts+crafts"
        },
        {
          "link": "/d/atvs-utility-vehicles/search/sna",
          "name": "atv/utv/sno"
        },
        {
          "link": "/d/auto-parts/search/pta",
          "name": "auto parts"
        },
        {
          "link": "/d/baby-kid-stuff/search/baa",
          "name": "baby+kids"
        },
        {
          "link": "/d/barter/search/bar",
          "name": "barter"
        },
        {
          "link": "/d/health-and-beauty/search/haa",
          "name": "beauty+hlth"
        },
        {
          "link": "/d/bicycle-parts/search/bip",
          "name": "bike parts"
        },
        {
          "link": "/d/bicycles/search/bia",
          "name": "bikes"
        },
        {
          "link": "/d/boat-parts-accessories/search/bpa",
          "name": "boat parts"
        },
        {
          "link": "/d/boats/search/boo",
          "name": "boats"
        },
        {
          "link": "/d/books-magazines/search/bka",
          "name": "books"
        },
        {
          "link": "/d/business/search/bfa",
          "name": "business"
        },
        {
          "link": "/d/cars-trucks/search/cta",
          "name": "cars+trucks"
        },
        {
          "link": "/d/cds-dvds-vhs/search/ema",
          "name": "cds/dvd/vhs"
        },
        {
          "link": "/d/cell-phones/search/moa",
          "name": "cell phones"
        },
        {
          "link": "/d/clothing-accessories/search/cla",
          "name": "clothes+acc"
        },
        {
          "link": "/d/collectibles/search/cba",
          "name": "collectibles"
        },
        {
          "link": "/d/computer-parts/search/syp",
          "name": "computer parts"
        },
        {
          "link": "/d/computers/search/sya",
          "name": "computers"
        },
        {
          "link": "/d/electronics/search/ela",
          "name": "electronics"
        },
        {
          "link": "/d/farm-garden/search/gra",
          "name": "farm+garden"
        },
        {
          "link": "/d/free-stuff/search/zip",
          "name": "free stuff"
        },
        {
          "link": "/d/furniture/search/fua",
          "name": "furniture"
        },
        {
          "link": "/d/garage-moving-sales/search/gms",
          "name": "garage sale"
        },
        {
          "link": "/d/general-for-sale/search/foa",
          "name": "general"
        },
        {
          "link": "/d/heavy-equipment/search/hva",
          "name": "heavy equipment"
        },
        {
          "link": "/d/household-items/search/hsa",
          "name": "household"
        },
        {
          "link": "/d/jewelry/search/jwa",
          "name": "jewelry"
        },
        {
          "link": "/d/materials/search/maa",
          "name": "materials"
        },
        {
          "link": "/d/motorcycle-parts-accessories/search/mpa",
          "name": "motorcycle parts"
        },
        {
          "link": "/d/motorcycles-scooters/search/mca",
          "name": "motorcycles"
        },
        {
          "link": "/d/musical-instruments/search/msa",
          "name": "music instr"
        },
        {
          "link": "/d/photo-video/search/pha",
          "name": "photo+video"
        },
        {
          "link": "/d/recreational-vehicles/search/rva",
          "name": "rvs+camp"
        },
        {
          "link": "/d/sporting-goods/search/sga",
          "name": "sporting"
        },
        {
          "link": "/d/tickets/search/tia",
          "name": "tickets"
        },
        {
          "link": "/d/tools/search/tla",
          "name": "tools"
        },
        {
          "link": "/d/toys-games/search/taa",
          "name": "toys+games"
        },
        {
          "link": "/d/trailers/search/tra",
          "name": "trailers"
        },
        {
          "link": "/d/video-gaming/search/vga",
          "name": "video gaming"
        },
        {
          "link": "/d/wanted/search/wan",
          "name": "wanted"
        },
        {
          "link": "/d/wheels-tires/search/wta",
          "name": "wheels+tires"
        }
      ]
    },
    {
      "link": "/d/jobs/search/jjj",
      "name": "jobs",
      "categories": [
        {
          "link": "/d/accounting-finance/search/acc",
          "name": "accounting+finance"
        },
        {
          "link": "/d/admin-office/search/ofc",
          "name": "admin / office"
        },
        {
          "link": "/d/architecture-engineering/search/egr",
          "name": "arch / engineering"
        },
        {
          "link": "/d/art-media-design/search/mar",
          "name": "art / media / design"
        },
        {
          "link": "/d/biotech-science/search/sci",
          "name": "biotech / science"
        },
        {
          "link": "/d/business-mgmt/search/bus",
          "name": "business / mgmt"
        },
        {
          "link": "/d/customer-service/search/csr",
          "name": "customer service"
        },
        {
          "link": "/d/education-teaching/search/edu",
          "name": "education"
        },
        {
          "link": "/d/food-beverage-hospitality/search/fbh",
          "name": "food / bev / hosp"
        },
        {
          "link": "/d/general-labor/search/lab",
          "name": "general labor"
        },
        {
          "link": "/d/government/search/gov",
          "name": "government"
        },
        {
          "link": "/d/human-resources/search/hum",
          "name": "human resources"
        },
        {
          "link": "/d/web-html-info-design/search/web",
          "name": "internet engineers"
        },
        {
          "link": "/d/legal-paralegal/search/lgl",
          "name": "legal / paralegal"
        },
        {
          "link": "/d/manufacturing/search/mnu",
          "name": "manufacturing"
        },
        {
          "link": "/d/marketing-advertising-pr/search/mar",
          "name": "marketing / pr / ad"
        },
        {
          "link": "/d/healthcare/search/hea",
          "name": "medical / health"
        },
        {
          "link": "/d/nonprofit/search/npo",
          "name": "nonprofit sector"
        },
        {
          "link": "/d/real-estate/search/rej",
          "name": "real estate"
        },
        {
          "link": "/d/retail-wholesale/search/ret",
          "name": "retail / wholesale"
        },
        {
          "link": "/d/sales/search/sls",
          "name": "sales"
        },
        {
          "link": "/d/salon-spa-fitness/search/spa",
          "name": "salon / spa / fitness"
        },
        {
          "link": "/d/security/search/sec",
          "name": "security"
        },
        {
          "link": "/d/trades-skilled/search/trd",
          "name": "skilled trade / craft"
        },
        {
          "link": "/d/software-qa-dba-etc/search/sof",
          "name": "software / qa / dba"
        },
        {
          "link": "/d/systems-networking/search/sad",
          "name": "systems / network"
        },
        {
          "link": "/d/technical-support/search/tch",
          "name": "technical support"
        },
        {
          "link": "/d/transportation/search/trp",
          "name": "transport"
        },
        {
          "link": "/d/tv-film-video-radio/search/tfr",
          "name": "tv / film / video"
        },
        {
          "link": "/d/web-html-info-design/search/web",
          "name": "web / info design"
        },
        {
          "link": "/d/writing-editing/search/wri",
          "name": "writing / editing"
        }
      ]
    },
    {
      "link": "/d/gigs/search/ggg",
      "name": "gigs",
      "categories": [
        {
          "link": "/d/computer-gigs/search/cpg",
          "name": "computer"
        },
        {
          "link": "/d/creative-gigs/search/crg",
          "name": "creative"
        },
        {
          "link": "/d/crew-gigs/search/cwg",
          "name": "crew"
        },
        {
          "link": "/d/domestic-gigs/search/dmg",
          "name": "domestic"
        },
        {
          "link": "/d/event-gigs/search/evg",
          "name": "event"
        },
        {
          "link": "/d/labor-gigs/search/lbg",
          "name": "labor"
        },
        {
          "link": "/d/talent-gigs/search/tlg",
          "name": "talent"
        },
        {
          "link": "/d/writing-gigs/search/wrg",
          "name": "writing"
        }
      ]
    },
    {
      "link": "/d/resumes/search/rez",
      "name": "resumes"
    }
  ]
}
```

## Documentation

## Overview
Automate data extraction from Craigslist Toulouse. Get real-time updates on rentals, jobs, market trends, and more.

## Quickstart
```
GET https://api.piloterr.com/v2/craigslist?query=example
```

## Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| `query` | string | yes | Search query or target identifier |

## Main use cases
- Integrate Craigslist data into enrichment, analytics, and monitoring pipelines
- Automate large-scale extraction from Craigslist without maintaining scrapers
- Power internal dashboards and workflow automations with live Craigslist data