# Find Songs by Lyrics on Genius

**Use case:** 

Search Genius using lyric snippets or phrases to discover matching songs and lyrics. Extract song titles, artists, lyric snippets, release dates, pageviews, images, and URLs to identify songs and support lyric research.

## Input

```json
{
  "keywords": [
    "I remember when we first met",
    "dancing in the moonlight",
    "lost without you",
    "take me home tonight",
    "we were young and free"
  ],
  "search_type": [
    "song",
    "lyric"
  ],
  "max_items": 20,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

## Output

```json
{
  "search_keyword": {
    "label": "Keyword",
    "format": "text"
  },
  "result_type": {
    "label": "Result Type",
    "format": "text"
  },
  "id": {
    "label": "ID",
    "format": "text"
  },
  "title": {
    "label": "Title",
    "format": "text"
  },
  "name": {
    "label": "Name",
    "format": "text"
  },
  "full_title": {
    "label": "Full Title",
    "format": "text"
  },
  "title_with_featured": {
    "label": "Title (Featured)",
    "format": "text"
  },
  "artist_names": {
    "label": "Artist(s)",
    "format": "text"
  },
  "primary_artist_name": {
    "label": "Primary Artist",
    "format": "text"
  },
  "featured_artists": {
    "label": "Featured Artists",
    "format": "json"
  },
  "name_with_artist": {
    "label": "Album (Artist)",
    "format": "text"
  },
  "all_artists": {
    "label": "All Artists",
    "format": "json"
  },
  "artist_name": {
    "label": "Artist",
    "format": "text"
  },
  "url": {
    "label": "URL",
    "format": "link"
  },
  "path": {
    "label": "Path",
    "format": "text"
  },
  "slug": {
    "label": "Slug",
    "format": "text"
  },
  "header_image_url": {
    "label": "Header Image",
    "format": "image"
  },
  "song_art_image_url": {
    "label": "Song Art",
    "format": "image"
  },
  "image_url": {
    "label": "Image",
    "format": "image"
  },
  "cover_art_url": {
    "label": "Cover Art",
    "format": "image"
  },
  "poster_url": {
    "label": "Poster",
    "format": "image"
  },
  "avatar_url": {
    "label": "Avatar",
    "format": "image"
  },
  "release_date": {
    "label": "Release Date",
    "format": "text"
  },
  "release_year": {
    "label": "Release Year",
    "format": "text"
  },
  "published_at": {
    "label": "Published At (unix)",
    "format": "number"
  },
  "lyrics_state": {
    "label": "Lyrics State",
    "format": "text"
  },
  "lyric_excerpt": {
    "label": "Lyric Excerpt",
    "format": "text"
  },
  "matched_words": {
    "label": "Matched Words",
    "format": "number"
  },
  "annotation_count": {
    "label": "Annotations",
    "format": "number"
  },
  "pyongs_count": {
    "label": "Pyongs",
    "format": "number"
  },
  "pageviews": {
    "label": "Pageviews",
    "format": "number"
  },
  "hot": {
    "label": "Hot",
    "format": "boolean"
  },
  "instrumental": {
    "label": "Instrumental",
    "format": "boolean"
  },
  "index_character": {
    "label": "Index Character",
    "format": "text"
  },
  "is_verified": {
    "label": "Verified",
    "format": "boolean"
  },
  "is_meme_verified": {
    "label": "Meme Verified",
    "format": "boolean"
  },
  "iq": {
    "label": "IQ",
    "format": "number"
  },
  "short_title": {
    "label": "Short Title",
    "format": "text"
  },
  "article_url": {
    "label": "Article URL",
    "format": "link"
  },
  "duration_ms": {
    "label": "Duration (ms)",
    "format": "number"
  },
  "view_count": {
    "label": "View Count",
    "format": "number"
  },
  "dek": {
    "label": "Dek",
    "format": "text"
  },
  "description": {
    "label": "Description",
    "format": "text"
  },
  "preview_image": {
    "label": "Preview Image",
    "format": "image"
  },
  "votes_total": {
    "label": "Votes",
    "format": "number"
  },
  "article_type": {
    "label": "Article Type",
    "format": "text"
  },
  "author_name": {
    "label": "Author",
    "format": "text"
  },
  "author_login": {
    "label": "Author Login",
    "format": "text"
  },
  "author_url": {
    "label": "Author URL",
    "format": "link"
  },
  "login": {
    "label": "Login",
    "format": "text"
  },
  "about_me_summary": {
    "label": "About Me",
    "format": "text"
  },
  "role": {
    "label": "Role",
    "format": "text"
  },
  "scraped_at": {
    "label": "Scraped At",
    "format": "date"
  }
}
```

## About this Actor

This example demonstrates how to use [Genius Scraper All-in-One - Low-cost💲🔥🎤🎵](https://apify.com/delectable_incubator/genius-scraper-all-in-one-low-cost.md) with a specific input configuration. Visit the [Actor detail page](https://apify.com/delectable_incubator/genius-scraper-all-in-one-low-cost.md) to learn more, explore other use cases, and run it yourself.


## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.
This Task's input is already configured above — use it as-is rather than inventing a new one.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For full API examples (JavaScript, Python, CLI, MCP, OpenAPI), see this Task's Actor page: https://apify.com/delectable_incubator/genius-scraper-all-in-one-low-cost.md

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).