API docs

You call a domain; the domain reads its sources. These are the domain endpoints, the same ones the labs use.

Quickstart

Get access. Argos is in private access: request access and you receive your API key. Every call goes to https://api.argoslab.fr with the key in the Authorization header.
Call a domain. Every endpoint answers JSON over HTTPS. Start with one the labs use:

curl 'https://api.argoslab.fr/apollon/world/theatres?lat=43.6045&lng=1.4442&radius=10' \
  -H "Authorization: Bearer $ARGOS_API_KEY"

Answers come as { "data": …, "timestamp", "cached" } or, for listing endpoints, the domain's own object (for example { "meetups": [...], "sources": {...} }). Each endpoint below lists its parameters.

Caching and freshness

Argos caches each source's answer for a time that matches how often the source changes: about an hour for mobility, showtimes and flight fares, longer for listings that move slowly. A call that hits the cache answers in milliseconds; a cold call waits for the slowest source it needs.

The answer says whether it came from the cache (cached) and when it was read (timestamp).

Errors

400 A parameter is missing or invalid; the message names it.
401 The key is missing, revoked, or does not cover this endpoint.
404 The item does not exist at the source.
429 Your key's rate limit is reached; the X-RateLimit-* headers say how many calls remain.
5xx A source failed. Listing endpoints still answer with the other sources and say which ones failed.

Domain names

Whether a domain name is free to register.

GET /apollon/availability

Availability of a booking slot on a partner planning.

Parameter	In	Type	Required
`idAnnonce`	query	string	No
`numPlanning`	query	string	No

Companies

Company records from official registries: identity, address, status.

GET /apollon/companies/details

Full record of one company from one registry.

Parameter	In	Type	Required
`source`	query	string	Yes
`id`	query	string	Yes

GET /apollon/companies/search

Find companies by name in the official registries you choose.

Parameter	In	Type	Required
`name`	query	string	Yes
`sources`	query	string	No

GET /apollon/companies/sources

Registries you can search.

E-commerce

Product pages and prices from online shops.

POST /apollon/ecommerce/products

Products and prices read from shop pages.

Parameter	In	Type	Required
`body`	body	string	Yes

Events

Concerts, shows, festivals and club nights from venues, promoters, ticketing sites and city agendas, in one schema.

GET /apollon/music/artist

An artist, from a name or one of their tracks.

Parameter	In	Type	Required
`name`	query	string	Yes
`track`	query	string	No

GET /apollon/music/artist/search

Search artists by name.

Parameter	In	Type	Required
`name`	query	string	Yes

GET /apollon/music/artist/summary

Short profile of an artist.

Parameter	In	Type	Required
`name`	query	string	Yes

GET /apollon/music/events

Upcoming events from the sources you pick, or around a point.

Parameter	In	Type	Required
`sources`	query	string	No
`lat`	query	integer	No
`lng`	query	integer	No
`radius`	query	integer	No

POST /apollon/music/events

Same as GET, with sources and filters in the body.

Parameter	In	Type	Required
`body`	body	string	Yes

GET /apollon/music/events-sources

Event sources you can ask for.

GET /apollon/music/events/details

One event in full.

Parameter	In	Type	Required
`id`	query	string	No

GET /apollon/music/events/ticket-details

Prices and availability read from a ticketing page.

Parameter	In	Type	Required
`url`	query	string	No

GET /apollon/music/place

One venue.

Parameter	In	Type	Required
`id`	query	string	Yes

GET /apollon/music/place/search

Search venues.

Parameter	In	Type	Required
`query`	query	string	Yes

GET /apollon/music/track

A track and its links on every streaming platform.

Parameter	In	Type	Required
`name`	query	string	No
`artist`	query	string	No

News

Articles from local and national media, normalised and readable in full.

GET /apollon/news

Latest articles from the sources you pick.

Parameter	In	Type	Required
`sources`	query	string	No
`maxCacheAge`	query	integer	No
`since`	query	string	No

GET /apollon/news/read

One article, read in full from its page.

Parameter	In	Type	Required
`url`	query	string	Yes
`maxCacheAge`	query	integer	No

GET /apollon/news/sources

News sources you can ask for.

Ski resorts

French ski resorts with slopes by colour, one-day pass prices and discounts.

GET /apollon/ski/resorts

Ski resorts with slopes, pass prices and discounts.

GET /apollon/ski/resorts/:slug

Parameter	In	Type	Required
`slug`	path	string	Yes

Vehicles

Car listings, parts and specifications from classifieds and catalogues.

GET /apollon/vehicule/offer/details

One car listing in full.

Parameter	In	Type	Required
`id`	query	string	No

GET /apollon/vehicule/offers

Car listings from classifieds.

GET /apollon/vehicule/recommendations

Oils, tyres and parts for a licence plate.

Parameter	In	Type	Required
`licencePlate`	query	string	No

Website scan

What a website runs on and the structured data it publishes.

GET /apollon/website/article

The main article of a page, as clean text.

Parameter	In	Type	Required
`url`	query	string	No

GET /apollon/website/feeds

RSS and Atom feeds a website offers.

Parameter	In	Type	Required
`url`	query	string	No

GET /apollon/website/meta

What a website publishes about itself: title, images, structured data.

Parameter	In	Type	Required
`url`	query	string	No

Places & travel

Shared mobility around a point, cinema showtimes, and flight fares paired to find where people can meet.

GET /apollon/world/flights/airports

Airports served by the airlines Argos reads.

GET /apollon/world/flights/group

Where 2 to 6 travellers from different airports can meet; a city one of them lives in counts.

Parameter	In	Type	Required
`airports`	query	string	Yes
`after`	query	string	No
`before`	query	string	No
`maxNights`	query	integer	No
`weekend`	query	boolean	No
`sameDates`	query	boolean	No

GET /apollon/world/flights/meetup

Where two travellers from different airports can meet, from easyJet, Ryanair, Volotea and Vueling fares; `skyscanner` fills the gaps (slower).

Parameter	In	Type	Required
`a`	query	string	Yes
`b`	query	string	Yes
`after`	query	string	No
`before`	query	string	No
`maxNights`	query	integer	No
`weekend`	query	boolean	No
`sameDates`	query	boolean	No
`skyscanner`	query	boolean	No

POST /apollon/world/swimming-pools

Public swimming pools and their opening times.

Parameter	In	Type	Required
`body`	body	string	Yes

GET /apollon/world/theatres

Cinemas around a point with their showtimes.

Parameter	In	Type	Required
`lat`	query	integer	No
`lng`	query	integer	No
`radius`	query	integer	No

GET /apollon/world/transportation

Bikes, cars, scooters, parkings and chargers around a point.

Parameter	In	Type	Required
`lat`	query	integer	No
`lng`	query	integer	No
`radius`	query	integer	No

GET /apollon/world/transportation/bikes

Bike-share stations around a point.

Parameter	In	Type	Required
`lat`	query	integer	No
`lng`	query	integer	No
`radius`	query	integer	No

GET /apollon/world/transportation/buses

Bus lines.

GET /apollon/world/transportation/cars

Shared cars around a point.

Parameter	In	Type	Required
`lat`	query	integer	No
`lng`	query	integer	No
`radius`	query	integer	No

GET /apollon/world/transportation/charging-stations

EV chargers around a point.

Parameter	In	Type	Required
`lat`	query	integer	No
`lng`	query	integer	No
`radius`	query	integer	No

GET /apollon/world/transportation/metros-trams

Metro and tram lines.

GET /apollon/world/transportation/parkings

Car and bike parkings around a point, with free spaces.

Parameter	In	Type	Required
`lat`	query	integer	No
`lng`	query	integer	No
`radius`	query	integer	No

GET /apollon/world/transportation/scooters

Shared scooters.

GET /apollon/world/transportation/trains

Train lines.