foorilla API for LLMs
Canonical URL: https://foorilla.com/api/llms.txt

Purpose
- foorilla is a paid-subscription platform for tech job discovery, media aggregation, events, and salary insights.
- This document provides a concise machine-readable guide to using the foorilla public API.

Core Links
- API root: https://foorilla.com/api/v1/
- Interactive docs: https://foorilla.com/api/v1/docs
- OpenAPI schema (JSON): https://foorilla.com/api/v1/schema.json
- API management UI: https://foorilla.com/api/
- Attribution guidelines: https://foorilla.com/api/list/attribution/

Authentication
- Every endpoint except the API root requires an API key.
- Preferred header: Api-Key: YOUR_API_KEY
- Alternative query parameter: ?api_key=YOUR_API_KEY
- Access requires an active PRO+ subscription.

Rate Limits
- 5 requests per second per account.
- 600 requests per minute per account.
- Use pagination and caching for ingestion workflows.

Pagination
- Standard query params: page (default 1), page_size (1-1000).
- Standard response envelope:
  {"results": [...], "count": n, "pages": n, "page": n, "page_size": n}

Data Domains
- Core taxonomy: tags, topics, geography, currency/language metadata.
- Hiring: companies and jobs.
- Media: sources and items.
- Event: organizers and events.
- Insight: salary records.

Endpoint Catalog
- Most resources also expose detail endpoints at /api/v1/<domain>/<resource>/{pk}

Core meta
- /api/v1/core/currencies/
- /api/v1/core/languages/
- /api/v1/core/tagtypes/

Core entities
- /api/v1/core/tag/
- /api/v1/core/tag/st/
- /api/v1/core/topic/
- /api/v1/core/topic/st/
- /api/v1/core/topic/em/
- /api/v1/core/georegion/
- /api/v1/core/georegion/st/
- /api/v1/core/geocountry/
- /api/v1/core/geocountry/st/
- /api/v1/core/geostate/
- /api/v1/core/geostate/st/
- /api/v1/core/geocity/
- /api/v1/core/geocity/st/
- /api/v1/core/currencyrate/

Hiring
- /api/v1/hiring/company/
- /api/v1/hiring/company/st/
- /api/v1/hiring/job/
- /api/v1/hiring/job/st/
- /api/v1/hiring/job/em/

Media
- /api/v1/media/source/
- /api/v1/media/source/st/
- /api/v1/media/item/
- /api/v1/media/item/st/
- /api/v1/media/item/em/

Event
- /api/v1/event/organizer/
- /api/v1/event/organizer/st/
- /api/v1/event/event/
- /api/v1/event/event/st/
- /api/v1/event/event/em/

Insight
- /api/v1/insight/salary/

Filtering
- Most list endpoints support partial string matching filters.
- Typical filters include:
  - Jobs: title, location, company
  - Companies: name, hq
  - Sources: name, domain
  - Items: title, author, source
  - Organizers: name, domain, source
  - Events: title, organizer, location, presence_level
- Check the OpenAPI docs for authoritative parameter definitions per endpoint.

Embeddings
- Endpoints ending with /em/ include embedding_3sh vectors.
- Use /em/ endpoints only when semantic workflows are needed (similarity, clustering, retrieval augmentation).

Example Requests
- List topics:
  curl -H "Api-Key: YOUR_API_KEY" "https://foorilla.com/api/v1/core/topic/?page=1&page_size=100"
- Search jobs:
  curl -H "Api-Key: YOUR_API_KEY" "https://foorilla.com/api/v1/hiring/job/?title=ml%20engineer&company=OpenAI"
- Pull salary data:
  curl -H "Api-Key: YOUR_API_KEY" "https://foorilla.com/api/v1/insight/salary/?page=1&page_size=100"

License and Attribution
- API data is licensed under CC BY-SA 4.0.
- You must provide proper attribution, include a license link, and indicate changes.
- License: https://creativecommons.org/licenses/by-sa/4.0/

Operational Guidance for LLM Agents
- Prefer stable list endpoints over scraping HTML pages.
- Fetch docs/schema first to discover current parameter names.
- Respect pagination and rate limits; back off on throttling.
- Cache slow-changing taxonomy datasets (tags/topics/geo).
- Avoid embeddings endpoints unless required by the user task.

Support
- Contact: hey@foorilla.com